Skip to content

Commit f652cae

Browse files
committed
initial draft
Signed-off-by: Hannah Hunter <[email protected]>
1 parent 16d6021 commit f652cae

File tree

1 file changed

+75
-0
lines changed

1 file changed

+75
-0
lines changed

articles/aks/dapr-workflow.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
title: Manage workflows with the Dapr extension for Azure Kubernetes Service (AKS)
3+
description: Learn how to run and manage Dapr Workflow on your Azure Kubernetes Service (AKS) clusters via the Dapr extension.
4+
author: hhunter-ms
5+
ms.author: hannahhunter
6+
ms.reviewer: nuversky
7+
ms.service: azure-kubernetes-service
8+
ms.topic: article
9+
ms.date: 03/02/2023
10+
ms.custom: devx-track-azurecli
11+
---
12+
13+
# Manage workflows with the Dapr extension for Azure Kubernetes Service (AKS)
14+
15+
With the Dapr Workflow API, you can easily orchestrate messaging, state management, and failure-handling logic across various microservices. Dapr Workflow can help you create long-running, fault-tolerant, and stateful applications.
16+
17+
In this guide, you'll use the [provided order processing workflow example][dapr-workflow-sample] to:
18+
19+
> [!div class="checklist"]
20+
> - Install the Dapr extension on your AKS cluster.
21+
> - Deploy the sample application to AKS.
22+
> - Start and query workflow instances using API calls.
23+
24+
The workflow example is an ASP.NET Core project with:
25+
- A [`Program.cs` file][dapr-program] that contains the setup of the app, including the registration of the workflow and workflow activities.
26+
- Workflow definitions found in the [`Workflows` directory][dapr-workflow-dir].
27+
- Workflow activity definitions found in the [`Activities` directory][dapr-activities-dir].
28+
29+
> [!NOTE]
30+
> Dapr Workflow is currently an [alpha][dapr-workflow-alpha] feature and is on a self-service, opt-in basis. Alpha Dapr APIs and components are provided "as is" and "as available," and are continually evolving as they move toward stable status. Alpha APIs and components are not covered by customer support.
31+
32+
## Pre-requisites
33+
34+
- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
35+
- Install the latest version of the [Azure CLI][install-cli].
36+
- If you don't have one already, create an [AKS cluster][deploy-cluster].
37+
- Make sure you have [an Azure Kubernetes Service RBAC Admin role](../role-based-access-control/built-in-roles.md#azure-kubernetes-service-rbac-admin)
38+
- Install .NET 6+
39+
- Install Docker
40+
41+
## Set up the environment
42+
43+
Clone the example workflow application.
44+
45+
```sh
46+
git clone https://github.com/shubham1172/dapr-workflows-aks-sample.git
47+
```
48+
49+
Navigate to the root directory.
50+
51+
```sh
52+
cd dapr-workflows-aks-sample
53+
```
54+
55+
## Prepare the Docker image
56+
57+
When getting ready to build and push the Docker image, make sure you're logged into ghcr.io
58+
59+
## Deploy to AKS
60+
61+
## Run the workflow
62+
63+
## Clean up resources
64+
65+
## Next steps
66+
67+
<!-- Links Internal -->
68+
69+
70+
<!-- Links External -->
71+
[dapr-workflow-sample]: https://github.com/shubham1172/dapr-workflows-aks-sample
72+
[dapr-program]: https://github.com/shubham1172/dapr-workflows-aks-sample/blob/main/Program.cs
73+
[dapr-workflow-dir]: https://github.com/shubham1172/dapr-workflows-aks-sample/tree/main/Workflows
74+
[dapr-activities-dir]: https://github.com/shubham1172/dapr-workflows-aks-sample/tree/main/Activities
75+
[dapr-workflow-alpha]: https://docs.dapr.io/operations/support/support-preview-features/#current-preview-features

0 commit comments

Comments
 (0)