Skip to content

Commit a7da5b2

Browse files
committed
added overview article for running workflows in ACA
1 parent 91ffa85 commit a7da5b2

File tree

2 files changed

+31
-16
lines changed

2 files changed

+31
-16
lines changed

articles/container-apps/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@
171171
items:
172172
- name: With a job
173173
href: tutorial-event-driven-jobs.md
174-
- name: Workflows
174+
- name: Workflows in Azure Container Apps
175175
href: workflows-overview.md
176176
- name: Troubleshooting
177177
items:

articles/container-apps/workflows-overview.md

Lines changed: 30 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,33 +5,48 @@ services: container-apps, azure-functions
55
author: hhunter-ms
66
ms.service: azure-container-apps
77
ms.topic: overview
8-
ms.date: 04/21/2025
8+
ms.date: 04/29/2025
99
ms.author: jiayma
1010
ms.reviewer: cshoe, hannahhunter
1111
---
1212

1313
# Workflows in Azure Container Apps
14+
Workflows are multi-step operations that may need to happen in a certain order and/or involve long-running tasks. Some real-world scenarios that require workflows include:
15+
- Order processing
16+
- AI agents
17+
- Infrastructure management
18+
- Data processing pipeline
1419

15-
Intro
20+
Because workflows involve multiple steps and could be long-running, execution may be interrupted by events such as temporary infrastructure failures or dependency downtime. As such, it's important to have *durable execution*, i.e. execution continues from the point of failure instead of restarting in the event of temporary failures.
1621

17-
## Durable execution overview + scenarios
18-
Why durable execution, discuss workflows and orchestrations
22+
Azure provides two code-oriented workflow frameworks you can use to build apps that run on Azure Container Apps: **Durable Task SDKs** (currently in public preview) and **Durable Functions**. These frameworks continuously checkpoint workflow state as the app runs and automatically handle retries to ensure durable execution.
1923

20-
## Available durable execution frameworks
21-
How to choose
24+
> [!NOTE]
25+
> You might see workflows referred to as *orchestrations*, especially in the context of Durable Functions. To avoid creating confusion with container orchestrations, this article refrains from using orchestrations to refer to workflows.
2226
23-
### Durable Task SDKs
27+
## Workflow frameworks for developers in Azure
28+
The workflow frameworks described in this section are designed for developers and are available in multiple programming languages.
2429

25-
### Durable Functions
30+
### Durable Task SDKs (public preview)
31+
The Durable Task SDKs are lightweight client SDKs that provide a relatively un-opinionated programming model for authoring workflows. They allow your app to connect to a workflow engine called the [Durable Task Scheduler](/articles/azure-functions/durable/durable-task-scheduler/durable-task-scheduler.md) hosted in Azure.
32+
33+
To ensure durable execution, the Durable Task SDKs require a storage backend to persist workflow state as the app runs. In this case, the Durable Task Scheduler also plays the role of the backend for apps leveraging the Durable Task SDKs.
2634

27-
## Options for running in ACA today
35+
#### Quickstarts
36+
- [.NET](/articles/azure-functions/durable/durable-task-scheduler/quickstart-portable-durable-task-sdks.md)
37+
- [Python](/articles/azure-functions/durable/durable-task-scheduler/quickstart-portable-durable-task-sdks.md)
38+
- [Java](/articles/azure-functions/durable/durable-task-scheduler/quickstart-portable-durable-task-sdks.md)
2839

29-
### Durable Task SDK + DTS
40+
### Durable Functions
41+
[Durable Functions](/articles/azure-functions/durable/durable-functions-overview.md) is the other code-oriented workflow framework in Azure. As part of Azure Functions, Durable Functions inherits many of its characteristics. Examples include:
42+
- Integrations with other Azure services through Azure Functions [triggers and bindings](/articles/azure-functions/functions-triggers-bindings.md)
43+
- Local development experience
44+
- Serverless pricing model
3045

31-
### Durable Functions + DTS
46+
If you want to host a Durable Functions app in Azure Container Apps, you must use the [Microsoft SQL backend](/articles/azure-functions/durable/durable-functions-storage-providers.md#microsoft-sql-server-mssql) today for state persistence.
3247

33-
## Quickstarts
34-
Link back to DTS docs from overview and TOC
35-
Maybe we could make this the "next step" button?
48+
## How to choose
49+
You can host apps built using either the Durable Task SDKs or Durable Functions in Azure Container Apps. See [guidance for choosing the framework](/articles/azure-functions/durable/durable-task-scheduler/choose-orchestration-framework.md) you need.
3650

37-
## Next steps
51+
## Next steps
52+
- Learn more about the [Durable Task Scheduler](/articles/azure-functions/durable/durable-task-scheduler/durable-task-scheduler.md)

0 commit comments

Comments
 (0)