Skip to content

Commit 9fb7751

Browse files
committed
add versioning format and faq
Signed-off-by: Hannah Hunter <[email protected]>
1 parent 54e9a11 commit 9fb7751

File tree

2 files changed

+27
-1
lines changed

2 files changed

+27
-1
lines changed

articles/container-apps/dapr-overview.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,17 @@ Configure microservices APIs for your container apps environment with a [Dapr-en
2525
| 2 | Dapr | The fully managed Dapr APIs are exposed to each container app through a Dapr sidecar. The Dapr APIs can be invoked from your container app via HTTP or gRPC. The Dapr sidecar runs on HTTP port 3500 and gRPC port 50001. |
2626
| 3 | Dapr component configuration | Dapr uses a modular design where functionality is delivered as a component. Dapr components can be shared across multiple container apps. The Dapr app identifiers provided in the scopes array dictate which dapr-enabled container apps load a given component at runtime. |
2727

28+
## Versioning
29+
30+
Dapr versions in Azure Container Apps include:
31+
- A semantic versioning prefix, such as `1.13.6`, which denotes compatibility with the corresponding OSS Dapr version (SDKs, CLI, etc.).
32+
- A `-msft.<number>` suffix, which denotes incorporating Azure-specific customizations for enhanced security and production readiness.
33+
34+
The complete version format for Dapr in Azure Container Apps can look something like `1.13.6-msft.1`.
35+
36+
> [!NOTE]
37+
> The <number> in the suffix may not always increment sequentially. For example, version `1.13.6-msft.3` may skip `1.13.6-msft.2`.
38+
2839
## Supported Dapr APIs, components, and tooling
2940

3041
### Managed APIs

articles/container-apps/faq.yml

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,22 @@ sections:
109109
answer:
110110
111111
You can submit a feature request via the [Azure Container Apps GitHub repository](https://github.com/microsoft/azure-container-apps/issues/new/choose). Make sure to include "Dapr" in the feature request title.
112-
112+
113+
- question: |
114+
Why do I see `-msft.<number>`` version in my Container App Environment?
115+
answer: |
116+
As `1.13.6-msft.1` is rolled out across production regions, you may still see earlier versions (like `1.12.5`` or `1.12.5-msft.6``). The `-msft.<number>`` suffix indicates the specific customizations made for Azure Container Apps to enhance your experience.
117+
118+
- question: |
119+
How often are Dapr versions released for Azure Container Apps?
120+
answer: |
121+
Dapr versions are updated on a best-effort basis, prioritizing stability, rigorous testing, and customer impact to ensure seamless integration without breaking changes. Updates are applied automatically, ensuring you always have the latest secure version.
122+
123+
- question: |
124+
Can I use a specific Dapr version for my environment?
125+
answer:
126+
Custom version selection is **not supported**. Instead, your environment is automatically upgraded, maintaining the integrity of Dapr's fully managed and serverless offering in Azure Container Apps.
127+
113128
- name: Dockerless deployments
114129
questions:
115130
- question: |

0 commit comments

Comments
 (0)