Dapr Quickstarts on Dapr Docs

Quickstart: Service Invocation

Mon, 01 Jan 0001 00:00:00 +0000

With Dapr’s Service Invocation building block, your application can communicate reliably and securely with other applications.

Dapr offers several methods for service invocation, which you can choose depending on your scenario. For this Quickstart, you’ll enable the checkout service to invoke a method using HTTP proxy in the order-processor service and by either:

Learn more about Dapr’s methods for service invocation in the overview article.

Quickstart: Publish and Subscribe

Mon, 01 Jan 0001 00:00:00 +0000

Let’s take a look at Dapr’s Publish and Subscribe (Pub/sub) building block. In this Quickstart, you will run a publisher microservice and a subscriber microservice to demonstrate how Dapr enables a Pub/sub pattern.

Using a publisher service, developers can repeatedly publish messages to a topic.
A Pub/sub component queues or brokers those messages. Our example below uses Redis, you can use RabbitMQ, Kafka, etc.
The subscriber to that topic pulls messages from the queue and processes them.

You can try out this pub/sub quickstart by either:

Quickstart: Workflow

Mon, 01 Jan 0001 00:00:00 +0000

Note

Redis is currently used as the state store component for Workflows in the Quickstarts. However, Redis does not support transaction rollbacks and should not be used in production as an actor state store.

Let’s take a look at the Dapr Workflow building block. In this Quickstart, you’ll create a simple console application to demonstrate Dapr’s workflow programming model and the workflow management APIs.

In this guide, you’ll:

Run the order-processor application.
Start the workflow and watch the workflow activites/tasks execute.
Review the workflow logic and the workflow activities and how they’re represented in the code.

The workflow contains the following activities:

Quickstart: State Management

Mon, 01 Jan 0001 00:00:00 +0000

Let’s take a look at Dapr’s State Management building block. In this Quickstart, you will save, get, and delete state using a Redis state store by either:

While this sample uses Redis, you can swap it out for any one of the supported state stores.

Run using Multi-App Run

Select your preferred language-specific Dapr SDK before proceeding with the Quickstart.

Quickstart: Input & Output Bindings

Mon, 01 Jan 0001 00:00:00 +0000

Let’s take a look at Dapr’s Bindings building block. Using bindings, you can:

Trigger your app with events coming in from external systems.
Interface with external systems.

In this Quickstart, you schedule a batch script to run every 10 seconds using an input Cron binding. The script processes a JSON file and outputs data to a SQL database using the PostgreSQL Dapr binding.

Select your preferred language-specific Dapr SDK before proceeding with the Quickstart.

Quickstart: Actors

Mon, 01 Jan 0001 00:00:00 +0000

Let’s take a look at Dapr’s Actors building block. In this Quickstart, you will run a smart device microservice and a simple console client to demonstrate the stateful object patterns in Dapr Actors.

Currently, you can experience this actors quickstart using the .NET SDK.

As a quick overview of the .NET actors quickstart:

Using a SmartDevice.Service microservice, you host:
- Two SmokeDetectorActor smoke alarm objects
- A ControllerActor object that commands and controls the smart devices
Using a SmartDevice.Client console app, the client app interacts with each actor, or the controller, to perform actions in aggregate.
The SmartDevice.Interfaces contains the shared interfaces and data types used by both the service and client apps.

Pre-requisites

For this example, you will need:

Quickstart: Secrets Management

Mon, 01 Jan 0001 00:00:00 +0000

Dapr provides a dedicated secrets API that allows developers to retrieve secrets from a secrets store. In this quickstart, you:

Run a microservice with a secret store component.
Retrieve secrets using the Dapr secrets API in the application code.

Select your preferred language-specific Dapr SDK before proceeding with the Quickstart.

Pre-requisites

For this example, you will need:

Quickstart: Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Let’s take a look at Dapr’s Configuration building block. A configuration item is often dynamic in nature and tightly coupled to the needs of the application that consumes it. Configuration items are key/value pairs containing configuration data, such as:

App ids
Partition keys
Database names, etc

In this quickstart, you’ll run an order-processor microservice that utilizes the Configuration API. The service:

Gets configuration items from the configuration store.
Subscribes for configuration updates.

Select your preferred language-specific Dapr SDK before proceeding with the Quickstart.

Quickstart: Cryptography

Mon, 01 Jan 0001 00:00:00 +0000

Alpha

The cryptography building block is currently in alpha.

Let’s take a look at the Dapr cryptography building block. In this Quickstart, you’ll create an application that encrypts and decrypts data using the Dapr cryptography APIs. You’ll:

Encrypt and then decrypt a short string (using an RSA key), reading the result in-memory, in a Go byte slice.
Encrypt and then decrypt a large file (using an AES key), storing the encrypted and decrypted data to files using streams.

Note

This example uses the Dapr SDK, which leverages gRPC and is strongly recommended when using cryptographic APIs to encrypt and decrypt messages.

Currently, you can experience the cryptography API using the Go SDK.

Quickstart: Jobs

Mon, 01 Jan 0001 00:00:00 +0000

Alpha

The jobs building block is currently in alpha.

Let’s take a look at the Dapr jobs building block, which schedules and runs jobs at a specific time or interval. In this Quickstart, you’ll schedule, get, and delete a job using Dapr’s Job API.

You can try out this jobs quickstart by either:

Run using Multi-App Run

Select your preferred language-specific Dapr SDK before proceeding with the Quickstart. Currently, you can experiment with the jobs API with the Go SDK.

Quickstart: Conversation

Mon, 01 Jan 0001 00:00:00 +0000

Alpha

The conversation building block is currently in alpha.

Let’s take a look at how the Dapr conversation building block makes interacting with Large Language Models (LLMs) easier. In this quickstart, you use the echo component to communicate with the mock LLM and ask it to define Dapr.

You can try out this conversation quickstart by either:

Note

Currently, you can only use JavaScript for the quickstart sample using HTTP, not the JavaScript SDK.

Run the app with the template file

Select your preferred language-specific Dapr SDK before proceeding with the Quickstart.