Skip to content

Commit f32cedf

Browse files
committed
removed add env vars section from quickstart
1 parent 809eacc commit f32cedf

File tree

4 files changed

+32
-30
lines changed

4 files changed

+32
-30
lines changed

articles/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,25 @@ Learn more about durable task scheduler [features](./durable-task-scheduler.md#f
4949
5050
::: zone-end
5151
52+
## Run durable task emulator
53+
1. Pull the docker image containing the emulator.
54+
55+
```bash
56+
docker pull mcr.microsoft.com/dts/dts-emulator:v0.0.5
57+
```
58+
59+
1. Run the emulator.
60+
61+
```bash
62+
docker run -itP mcr.microsoft.com/dts/dts-emulator:v0.0.5
63+
```
64+
65+
The command above exposes a single task hub named `default`. If you need more than one task hub, you can set the environment variable `DTS_TASK_HUB_NAMES` on the container to a comma-delimited list of task hub names like below:
66+
67+
```bash
68+
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:v0.0.5
69+
```
70+
5271
## Create a scheduler and task hub
5372

5473
::: zone pivot="az-cli"
@@ -197,11 +216,11 @@ You can see the list of scheduler resources created in all subscriptions you hav
197216
198217
::: zone pivot="az-cli"
199218
200-
Retrieve a list of task hubs in a specific scheduler by running:
219+
Retrieve a list of task hubs in a specific scheduler by running:
201220
202-
```azurecli
203-
az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>
204-
```
221+
```azurecli
222+
az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>
223+
```
205224

206225
::: zone-end
207226

articles/azure-functions/durable/durable-task-scheduler/dts-dedicated-sku.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ The following table explains the minimum cost and features provided with each CU
3030

3131
## Pricing
3232

33-
Find the price of a capacity unit on the [Azure Functions pricing page](https://azure.microsoft.com/pricing/details/functions/).
33+
Find the price of a capacity unit in a given region on the [Azure Functions pricing page](https://azure.microsoft.com/pricing/details/functions/).
3434

3535
## Determining the number of Capacity Units needed
3636

articles/azure-functions/durable/durable-task-scheduler/quickstart-durable-task-scheduler.md

Lines changed: 7 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ In this quickstart, you configure a durable functions app to use the [durable ta
2828
## Prerequisites
2929

3030
This quickstart assumes you alredy have an Azure Functions project on your local computer with:
31-
- Durable functions added to your project using:
31+
- Durable functions added to your project include:
3232
- An [orchestrator function](../durable-functions-bindings.md#orchestration-trigger).
3333
- A [client function](../durable-functions-bindings.md#orchestration-client) that triggers the durable functions app.
3434
- The project configured for local debugging.
@@ -64,7 +64,7 @@ You'll also need:
6464
6565
Install the latest version of the [Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged) package by using the [dotnet add package](/dotnet/core/tools/dotnet-add-package) command:
6666

67-
```cmd
67+
```bash
6868
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged --prerelease
6969
```
7070

@@ -77,14 +77,14 @@ Until the durable task scheduler package is added to the extension bundles, you
7777
- [Microsoft.Azure.WebJobs.Extensions.DurableTask](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask)
7878

7979
For example:
80-
```cmd
80+
```bash
8181
func extensions install --package Microsoft.Azure.WebJobs.Extensions.DurableTask.AzureManaged --version 0.4.2-alpha
8282
```
83-
```cmd
83+
```bash
8484
func extensions install --package Microsoft.Azure.WebJobs.Extensions.DurableTask --version 3.0.4
8585
```
8686

87-
These commands should automatically generate a *extensions.csproj* file that looks like the following to your app. If the package references are not added to the file, check to ensure that `net8.0` is the target framework and run the commands again:
87+
These commands should automatically generate a *extensions.csproj* file. If the package references are not added to the file, check to ensure that `net8.0` is the target framework and run the commands again. The file should have content similar to the following:
8888

8989
```xml
9090
<Project Sdk="Microsoft.NET.Sdk">
@@ -155,12 +155,6 @@ Get the durable task scheduler emulator port number in [the next step](#set-up-d
155155
```bash
156156
docker run -itP mcr.microsoft.com/dts/dts-emulator:v0.0.5
157157
```
158-
159-
The command above registers the default task hub. If you need more than one task hub, you can set the environment variable `DTS_TASK_HUB_NAMES` on the container to a comma-delimited list of task hub names like below:
160-
161-
```bash
162-
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:v0.0.5
163-
```
164158

165159
The following indicates the emulator started successfully.
166160
:::image type="content" source="media/quickstart-durable-task-scheduler/emulator-started.png" alt-text="Screenshot showing emulator started successfully on terminal.":::
@@ -230,21 +224,10 @@ Get the durable task scheduler emulator port number in [the next step](#set-up-d
230224

231225
### Create required resources
232226

233-
Create a durable task scheduler instance and Azure Functions app on Azure following the *Function app integrated creation flow*.
227+
Create a durable task scheduler instance and Azure Functions app on Azure following the *Function app integrated creation flow*. This experience will automatically set up identity-based access and configure the required environment variables for the app to access the scheduler.
234228

235229
[!INCLUDE [function-app-integrated-creation](./includes/function-app-integrated-creation.md)]
236230

237-
### Add required environment variables to app
238-
239-
Add the following environment variables:
240-
- `TASKHUB_NAME`: name of task hub
241-
- `DURABLE_TASK_SCHEDULER_CONNECTION_STRING`: the format of the string is `"Endpoint={DTS endpoint};Authentication=ManagedIdentity;ClientID={client id}"`, where *endpoint* is the scheduler endpoint and *client id* is the managed identity client ID.
242-
243-
You can use this command:
244-
```azurecli
245-
az functionapp config appsettings set --resource-group RESOURCE_GROUP_NAME --name FUNCTION_APP_NAME --settings KEY_NAME=KEY_VALUE
246-
```
247-
248231
### Deploy your function app to Azure
249232

250233
[!INCLUDE [functions-publish-project-vscode](../../../../includes/functions-deploy-project-vs-code.md)]
@@ -267,7 +250,7 @@ az functionapp function list --resource-group <RESOURCE_GROUP_NAME> --name <FUNC
267250

268251
### Check orchestration status
269252

270-
Check the status of the orchestration instance and activity details on the durable task scheduler dashboard. Follow the instructions below to assign the required role to your developer identity (email) to get access to the dashboard.
253+
Check the status of the orchestration instance and activity details on the durable task scheduler dashboard. Accessing the dashboard requires you to login. Follow the instructions below to assign the required role to your identity.
271254

272255
[!INCLUDE [assign-dev-identity-rbac-portal](./includes/assign-dev-identity-rbac-portal.md)]
273256

articles/azure-functions/durable/durable-task-scheduler/troubleshoot-durable-task-scheduler.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,4 +78,4 @@ For Mx Mac (ARM64) users, you may run into gRPC runtime issues with durable func
7878

7979
## Error deploying app to Azure
8080

81-
If your deployment fails with an error such as `Encountered an error (ServiceUnavailable) from host runtime` from Visual Studio Code, first check your app to ensure the required [environment variables and their values](./develop-with-durable-task-scheduler.md#add-environment-variables-to-app) are set correctly. Then redeploy your app. If you see an error loading functions, click the "Refresh" button.
81+
If your deployment fails with an error such as `Encountered an error (ServiceUnavailable) from host runtime` from Visual Studio Code, first check your app to ensure the required [environment variables](./develop-with-durable-task-scheduler.md#add-environment-variables-to-app) are set correctly. Then redeploy your app. If you see an error loading functions, click the "Refresh" button.

0 commit comments

Comments
 (0)