Skip to content

Commit

Permalink
Dapr tutorial Application ID updates (#913)
Browse files Browse the repository at this point in the history
* use CLI-injected app IDs in dapr tutorial

Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>

* correct step numbering

Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>

* fix directory name

Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>

---------

Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
  • Loading branch information
willtsai authored Oct 26, 2023
1 parent c4d3992 commit c70cb13
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 18 deletions.
35 changes: 26 additions & 9 deletions docs/content/tutorials/tutorial-dapr/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,16 +20,33 @@ For more details on the app and access to the source code, visit the `tutorials/

- [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}})
- [Radius Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}})
- [Radius environment]({{< ref "installation#step-3-initialize-radius" >}})
- [Setup a supported Kubernetes cluster](https://docs.radapp.io/guides/operations/kubernetes/overview/#supported-clusters)
- [Dapr installed on your Kubernetes cluster](https://docs.dapr.io/operations/hosting/kubernetes/kubernetes-deploy/)

## Step 1: Define the application, `backend` container, and Dapr state store
## Step 1: Initialize a Radius Environment

1. Begin in a new directory for your application:

```bash
mkdir dapr
cd dapr
```

2. Initialize a new dev environment:

*Select 'Yes' when prompted to create an application.*

```bash
rad init
```

## Step 2: Define the application, `backend` container, and Dapr state store

Begin by creating a new file named `dapr.bicep` with a Radius Application that consists of a `backend` container and Dapr state store with Redis:

{{< rad file="snippets/dapr.bicep" embed=true marker="//BACKEND" >}}

## Step 2: Deploy the `backend` application
## Step 3: Deploy the `backend` application

1. Deploy the application's `backend` container and Dapr state store:

Expand Down Expand Up @@ -68,13 +85,13 @@ Begin by creating a new file named `dapr.bicep` with a Radius Application that c
default-dapr statestore state.redis v1 2023-07-21 16:04.27 21m
```

## Step 3: Define the `frontend` container
## Step 4: Define the `frontend` container

Add a `frontend` [container]({{< ref "guides/author-apps/containers" >}}) which will serve as the application's user interface.

{{< rad file="snippets/dapr.bicep" embed=true marker="//FRONTEND" >}}

## Step 4. Deploy and run the `frontend` application
## Step 5. Deploy and run the `frontend` application

1. Use Radius to deploy and run the application with a single command:

Expand All @@ -94,20 +111,20 @@ Add a `frontend` [container]({{< ref "guides/author-apps/containers" >}}) which
statestore Applications.Dapr/stateStores
```

## Step 5. Test your application
## Step 6. Test your application

In your browser, navigate to the endpoint (e.g. [http://localhost:8080](http://localhost:8080)) to view and interact with your application:

<img src="frontend.png" alt="Screenshot of frontend application" width=500 >

## Cleanup

1. Press CTRL+C to terminate the `rad run` log console
1. Press `CTRL`+`C` to terminate the log console

1. Run `rad app delete` to cleanup your Radius Application, containers, and Dapr statestore. The Recipe resources (_Redis container and Dapr component_) are also automatically cleaned up.
1. Run the following command to cleanup your Radius Application, containers, and Dapr statestore. The Recipe resources (_Redis container and Dapr component_) are also automatically cleaned up.

```bash
rad app delete -a dapr
rad app delete
```

## Next steps
Expand Down
14 changes: 5 additions & 9 deletions docs/content/tutorials/tutorial-dapr/snippets/dapr.bicep
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,14 @@ import radius as radius
@description('Specifies the environment for resources.')
param environment string

resource app 'Applications.Core/applications@2023-10-01-preview' = {
name: 'dapr'
properties: {
environment: environment
}
}
@description('The ID of your Radius Application. Automatically injected by the rad CLI.')
param application string

// The backend container that is connected to the Dapr state store
resource backend 'Applications.Core/containers@2023-10-01-preview' = {
name: 'backend'
properties: {
application: app.id
application: application
container: {
// This image is where the app's backend code lives
image: 'radius.azurecr.io/samples/dapr-backend:latest'
Expand Down Expand Up @@ -46,7 +42,7 @@ resource stateStore 'Applications.Dapr/stateStores@2023-10-01-preview' = {
properties: {
// Provision Redis Dapr state store automatically via the default Radius Recipe
environment: environment
application: app.id
application: application
}
}
//BACKEND
Expand All @@ -56,7 +52,7 @@ resource stateStore 'Applications.Dapr/stateStores@2023-10-01-preview' = {
resource frontend 'Applications.Core/containers@2023-10-01-preview' = {
name: 'frontend'
properties: {
application: app.id
application: application
container: {
// This image is where the app's frontend code lives
image: 'radius.azurecr.io/samples/dapr-frontend:latest'
Expand Down

0 comments on commit c70cb13

Please sign in to comment.