|
| 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