zhutony / quickstarts

Dapr quickstart code samples and tutorials showcasing core Dapr capabilities

Dapr Quickstarts

This repository contains a collection of tutorials with code samples that are aimed to get you started quickly with Dapr, each highlighting a different Dapr capability.

How to use this repository

If you are new to Dapr and haven't done so already, it is recommended you go through the Dapr Getting Started instructions.

If you would like to jump in right away by using GitHub Codespaces, you can click on "Code" in this repo and "Open with Codespaces", which will let you get started right away with dapr init. The Codespace will be based off a personal fork of this repo (if you have not already forked this repo, one will be created for you), so feel free to explore!

This repository is designed to help you explore different Dapr capabilities and you can go through the quickstarts based on the areas you would like to explore. Each quickstart includes sample code and a tutorial that will guide you through it.

• A good place to start is the hello-world quickstart, it demonstrates how to run Dapr in standalone mode locally on your machine and demonstrates state management and service invocation in a simple application.
• Next, if you are familiar with Kubernetes and want to see how to run the same application in a Kubernetes environment, look for the hello-kubernetes quickstart. Other quickstarts such as pub-sub, bindings and the distributed-calculator quickstart explore different Dapr capabilities include instructions for running both locally and on Kubernetes and can be completed in any order. A full list of the quickstarts can be found below.
• At anytime, you can explore the Dapr documentation or SDK specific samples and come back to try additional quickstarts.
• When you're done, consider exploring the Dapr samples repository for additional code samples contributed by the community that show more advanced or specific usages of Dapr.

Supported Dapr Runtime version

Dapr is currently under community development with preview releases. The master branch includes breaking changes, therefore ensure that you're running the samples with the right version of Dapr runtime.

Dapr Quickstart Version	Dapr Runtime Version
v1.4.0	v1.4.0
v1.3.0	v1.3.0
v1.2.0	v1.2.0
v1.1.0	v1.1.0
v1.0.0	v1.0.0
v0.11.0	v0.11.3
v0.10.0	v0.10.0
v0.9.0	v0.9.0
v0.8.0	v0.8.0
v0.7.0	v0.7.0
v0.6.0	v0.6.0
v0.5.0	v0.5.0
v0.4.0	v0.4.0
v0.3.0	v0.3.0
v0.2.0	v0.2.0
v0.1.0	v0.1.0

Quickstarts

Quickstart	Description
Hello-world	Demonstrates how to run Dapr locally. Highlights service invocation and state management.
Hello-kubernetes	Demonstrates how to run Dapr in Kubernetes. Highlights service invocation and state management.
Distributed-calculator	Demonstrates a distributed calculator application that uses Dapr services to power a React web app. Highlights polyglot (multi-language) programming, service invocation and state management.
Pub-sub	Demonstrates how to use Dapr to enable pub-sub applications. Uses Redis as a pub-sub component.
Bindings	Demonstrates how to use Dapr to create input and output bindings to other components. Uses bindings to Kafka.
Middleware	Demonstrates use of Dapr middleware to enable OAuth 2.0 authorization.
Observability	Demonstrates Dapr tracing capabilities. Uses Zipkin as a tracing component.
Secret Store	Demonstrates the use of Dapr Secrets API to access secret stores.

SDKs

Find SDK-specific samples in the links below:

• .NET SDK
  • Getting Started with ASP.NET Core - Samples for developing ASP.NET applications using the Dapr .NET SDK
  • Getting Started with .NET Actors - Tutorial for developing actor applications using the Dapr .NET SDK including actor samples
• Java SDK
  • Examples - Examples for developing Java applications using Dapr
  • Example for Java Actors - Example for developing an actor application using the Java SDK.
• Go SDK
  • Examples using the client library to connect to Dapr API, and how to create a Dapr application in either HTTP or gRPC.
• Javascript SDK
  • Examples - Examples for developing Javascript applications using Dapr
• Python SDK
  • Examples - Examples for developing Python applications using Dapr
  • Example for Python Actors - Example for developing an actor application using the Python SDK.

To get started with the quickstarts, clone this repository and follow instructions in each sample:

git clone --depth=1 https://github.com/dapr/quickstarts.git

Code of Conduct

Please refer to our Dapr Community Code of Conduct