mirror of https://github.com/dapr/docs.git
start quickstart skeleton
Signed-off-by: Hannah Hunter <hannahhunter@microsoft.com>
This commit is contained in:
parent
d0d425f54f
commit
9d8cad1f99
|
@ -0,0 +1,151 @@
|
||||||
|
---
|
||||||
|
type: docs
|
||||||
|
title: "Quickstart: Conversation"
|
||||||
|
linkTitle: Conversation
|
||||||
|
weight: 90
|
||||||
|
description: Get started with the Dapr conversation building block
|
||||||
|
---
|
||||||
|
|
||||||
|
{{% alert title="Alpha" color="warning" %}}
|
||||||
|
The conversation building block is currently in **alpha**.
|
||||||
|
{{% /alert %}}
|
||||||
|
|
||||||
|
Let's take a look at the [Dapr conversation building block]({{< ref conversation-overview.md >}}), which
|
||||||
|
|
||||||
|
You can try out this conversation quickstart by either:
|
||||||
|
|
||||||
|
- [Running all applications in this sample simultaneously with the Multi-App Run template file]({{< ref "#run-using-multi-app-run" >}}), or
|
||||||
|
- [Running one application at a time]({{< ref "#run-one-job-application-at-a-time" >}})
|
||||||
|
|
||||||
|
## Run using Multi-App Run
|
||||||
|
|
||||||
|
Select your preferred language-specific Dapr SDK before proceeding with the Quickstart. Currently, you can experiment with the conversation API with the Go SDK.
|
||||||
|
|
||||||
|
{{< tabs ".NET" >}}
|
||||||
|
|
||||||
|
<!-- .NET -->
|
||||||
|
{{% codetab %}}
|
||||||
|
|
||||||
|
This quickstart includes two apps:
|
||||||
|
|
||||||
|
### Step 1: Pre-requisites
|
||||||
|
|
||||||
|
For this example, you will need:
|
||||||
|
|
||||||
|
- [Dapr CLI and initialized environment](https://docs.dapr.io/getting-started).
|
||||||
|
- [.NET SDK or .NET 6 SDK installed](https://dotnet.microsoft.com/download).
|
||||||
|
<!-- IGNORE_LINKS -->
|
||||||
|
- [Docker Desktop](https://www.docker.com/products/docker-desktop)
|
||||||
|
<!-- END_IGNORE -->
|
||||||
|
|
||||||
|
### Step 2: Set up the environment
|
||||||
|
|
||||||
|
Clone the [sample provided in the Quickstarts repo](https://github.com/dapr/quickstarts/tree/master/conversation).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/dapr/quickstarts.git
|
||||||
|
```
|
||||||
|
|
||||||
|
From the root of the Quickstarts directory, navigate into the conversation directory:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd conversation/csharp/sdk
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 3:
|
||||||
|
|
||||||
|
Run the application and schedule conversation with one command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
dapr run -f .
|
||||||
|
```
|
||||||
|
|
||||||
|
**Expected output**
|
||||||
|
|
||||||
|
Once the process has completed, you can stop and clean up application processes with a single command.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
dapr stop -f .
|
||||||
|
```
|
||||||
|
|
||||||
|
### What happened?
|
||||||
|
|
||||||
|
When you ran `dapr init` during Dapr install:
|
||||||
|
|
||||||
|
Running `dapr run -f .` in this Quickstart...
|
||||||
|
|
||||||
|
#### `dapr.yaml` Multi-App Run template file
|
||||||
|
|
||||||
|
Running the [Multi-App Run template file]({{< ref multi-app-dapr-run >}}) with `dapr run -f .` starts all applications in your project. In this Quickstart, the `dapr.yaml` file contains the following:
|
||||||
|
|
||||||
|
```yml
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `conversation` app
|
||||||
|
|
||||||
|
```csharp
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
{{% /codetab %}}
|
||||||
|
|
||||||
|
{{< /tabs >}}
|
||||||
|
|
||||||
|
## Run one job application at a time
|
||||||
|
|
||||||
|
{{< tabs ".NET" >}}
|
||||||
|
|
||||||
|
<!-- .NET -->
|
||||||
|
{{% codetab %}}
|
||||||
|
|
||||||
|
|
||||||
|
### Step 1: Pre-requisites
|
||||||
|
|
||||||
|
For this example, you will need:
|
||||||
|
|
||||||
|
- [Dapr CLI and initialized environment](https://docs.dapr.io/getting-started).
|
||||||
|
- [.NET SDK or .NET 6 SDK installed](https://dotnet.microsoft.com/download).
|
||||||
|
<!-- IGNORE_LINKS -->
|
||||||
|
- [Docker Desktop](https://www.docker.com/products/docker-desktop)
|
||||||
|
<!-- END_IGNORE -->
|
||||||
|
|
||||||
|
### Step 2: Set up the environment
|
||||||
|
|
||||||
|
Clone the [sample provided in the Quickstarts repo](https://github.com/dapr/quickstarts/tree/master/conversation).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/dapr/quickstarts.git
|
||||||
|
```
|
||||||
|
|
||||||
|
From the root of the Quickstarts directory, navigate into the conversation directory:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd conversation/csharp/sdk
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 3:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
{{% /codetab %}}
|
||||||
|
|
||||||
|
{{< /tabs >}}
|
||||||
|
|
||||||
|
|
||||||
|
## Watch the demo
|
||||||
|
|
||||||
|
See the conversation API in action using a .NET example.
|
||||||
|
|
||||||
|
## Tell us what you think!
|
||||||
|
|
||||||
|
We're continuously working to improve our Quickstart examples and value your feedback. Did you find this Quickstart helpful? Do you have suggestions for improvement?
|
||||||
|
|
||||||
|
Join the discussion in our [discord channel](https://discord.com/channels/778680217417809931/953427615916638238).
|
||||||
|
|
||||||
|
## Next steps
|
||||||
|
|
||||||
|
- SDK samples of this quickstart:
|
||||||
|
- [.NET](https://github.com/dapr/quickstarts/tree/master/conversation/go/http)
|
||||||
|
- Learn more about [the conversation building block]({{< ref conversation-overview.md >}})
|
||||||
|
|
||||||
|
{{< button text="Explore Dapr tutorials >>" page="getting-started/tutorials/_index.md" >}}
|
Loading…
Reference in New Issue