Merge pull request #267265 from hhunter-ms/hh-209560

[Dapr/ACA] Clarify support for APIs and components

Author: v-dirichards

articles/container-apps/dapr-components.md

@@ -6,7 +6,7 @@ author: hhunter-ms
 ms.service: container-apps
 ms.custom: build-2023
 ms.topic: conceptual
-ms.date: 12/18/2023
+ms.date: 04/29/2024
 ---
 
 # Dapr components in Azure Container Apps

articles/container-apps/dapr-overview.md

@@ -6,7 +6,7 @@ author: hhunter-ms
 ms.service: container-apps
 ms.custom: build-2023
 ms.topic: conceptual
-ms.date: 12/20/2023
+ms.date: 04/22/2024
 ---
 
 # Dapr integration with Azure Container Apps
@@ -25,28 +25,38 @@ Configure Dapr for your container apps environment with a [Dapr-enabled containe
 | 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.                                                         |
 | 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. |
 
-## Supported Dapr APIs
+## Supported Dapr APIs, components, and tooling
 
-Azure Container Apps offers fully managed versions of the following _stable_ Dapr APIs (building blocks). To learn more about using alpha APIs and features, [see the Dapr FAQ][dapr-faq].
+### Managed APIs
 
-:::image type="content" source="media/dapr-overview/azure-container-apps-dapr-building-blocks.png" alt-text="Diagram that shows Dapr APIs.":::
+Azure Container Apps offers managed generally available Dapr APIs (building blocks). These APIs are fully managed and supported for use in production environments.
 
-| Dapr API                                              | Description                                                                                                                                                     |
+To learn more about using _alpha_ Dapr APIs and features, [see the Dapr FAQ][dapr-faq].
+
+:::image type="content" source="media/dapr-overview/azure-container-apps-dapr-building-blocks.png" lightbox="media/dapr-overview/azure-container-apps-dapr-building-blocks.png" alt-text="Diagram that shows Dapr APIs.":::
+
+| API                                              | Status | Description                                                                                                                                                     |
 | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [**Service-to-service invocation**][dapr-serviceinvo] | Discover services and perform reliable, direct service-to-service calls with automatic mTLS authentication and encryption. [See known limitations for Dapr service invocation in Azure Container Apps.](#limitations)                                     |
-| [**State management**][dapr-statemgmt]                | Provides state management capabilities for transactions and CRUD operations.                                                                                    |
-| [**Pub/sub**][dapr-pubsub]                            | Allows publisher and subscriber container apps to intercommunicate via an intermediary message broker. You can also create [declarative subscriptions][dapr-subscriptions] to a topic using an external component JSON file. [Learn more about the declarative pub/sub API.][declarative-pubsub]                                                         |
-| [**Bindings**][dapr-bindings]                         | Trigger your applications based on events                                                                                                                       |
-| [**Actors**][dapr-actors]                             | Dapr actors are message-driven, single-threaded, units of work designed to quickly scale. For example, in burst-heavy workload situations. |
-| [**Observability**](./observability.md)               | Send tracing information to an Application Insights backend.                                                                                                    |
-| [**Secrets**][dapr-secrets]                           | Access secrets from your application code or reference secure values in your Dapr components.                                                                   |
-| [**Configuration**][dapr-config]                           | Retrieve and subscribe to application configuration items for supported configuration stores.                                                                   |
+| [**Service-to-service invocation**][dapr-serviceinvo] | GA | Discover services and perform reliable, direct service-to-service calls with automatic mTLS authentication and encryption. [See known limitations for Dapr service invocation in Azure Container Apps.](#limitations)                                     |
+| [**State management**][dapr-statemgmt]                | GA | Provides state management capabilities for transactions and CRUD operations.                                                                                    |
+| [**Pub/sub**][dapr-pubsub]                            | GA | Allows publisher and subscriber container apps to intercommunicate via an intermediary message broker. You can also create declarative subscriptions to a topic using an external component JSON file. [Learn more about the declarative pub/sub API.][declarative-pubsub]                                                         |
+| [**Bindings**][dapr-bindings]                         | GA | Trigger your applications based on events                                                                                                                       |
+| [**Actors**][dapr-actors]                             | GA | Dapr actors are message-driven, single-threaded, units of work designed to quickly scale. For example, in burst-heavy workload situations. |
+| [**Observability**](./observability.md)               | GA | Send tracing information to an Application Insights backend.                                                                                                    |
+| [**Secrets**][dapr-secrets]                           | GA | Access secrets from your application code or reference secure values in your Dapr components.                                                                   |
+| [**Configuration**][dapr-config]                           | GA | Retrieve and subscribe to application configuration items for supported configuration stores.                                                                   |
+
+[!INCLUDE [component-support](../../includes/dapr-in-azure/dapr-support-policy.md)]
+
+### Tooling
+
+Azure Container Apps ensures compatibility with Dapr open source tooling, such as SDKs and the CLI. 
 
 ## Limitations
 
 - **Dapr Configuration spec**: Any capabilities that require use of the Dapr configuration spec.
 - **Any Dapr sidecar annotations not listed in [the Dapr enablement guide][dapr-enable]**
-- **Alpha APIs and components**: Azure Container Apps doesn't guarantee the availability of Dapr alpha APIs and features. For more information, see the [Dapr FAQ][dapr-faq].
+- **APIs and components support**: Only the Dapr APIs and components [listed as GA, Tier 1, or Tier 2 in this article](#supported-dapr-apis-components-and-tooling) are supported in Azure Container Apps.
 - **Actor reminders**: Require a minReplicas of 1+ to ensure reminders is always active and fires correctly.
 - **Jobs**: Dapr isn't supported for jobs.
 
@@ -57,7 +67,7 @@ Azure Container Apps offers fully managed versions of the following _stable_ Dap
 
 <!-- Links Internal -->
 
-[dapr-faq]: ./faq.yml#dapr
+[dapr-faq]: ./faq.yml#are-alpha-dapr-apis-and-tier-2-components-supported-or-available-in-azure-container-apps-
 [dapr-enable]: ./enable-dapr.md
 [dapr-components]: ./dapr-components.md
 

articles/container-apps/faq.yml

@@ -8,7 +8,7 @@ metadata:
   ms.service: container-apps
   ms.custom:
     - ignite-2023
-  ms.date: 02/27/2024
+  ms.date: 05/15/2024
   ms.author: cshoe
 title: Azure Container Apps frequently asked questions (FAQs)
 summary: This article lists commonly asked questions about Azure Container Apps together with related answers.
@@ -73,9 +73,11 @@ sections:
           Each Dapr capability undergoes thorough evaluation to ensure it positively impacts customers running microservices in the Azure Container Apps environment, while providing the best possible experience.
 
       - question: |
-          Are alpha Dapr APIs and components supported or available in Azure Container Apps?
+          Are alpha Dapr APIs and Tier 2 components supported or available in Azure Container Apps?
         answer: |
-          Azure Container Apps offers developers the flexibility to experiment with the latest Dapr alpha APIs and features on a self-service, opt-in basis. Although the availability of these alpha APIs and components isn't guaranteed, you can stay ahead of the curve and explore cutting-edge technologies as they become available. While these alpha APIs and components are provided "as is" and "as available," their continuous evolution towards stable status ensures that developers can always be at the forefront of innovation.
+          The availability of Dapr's alpha APIs is not guaranteed or Microsoft-supported.
+ 
+          While Tier 1 components are fully supported, Tier 2 components are supported with best effort. [Learn more.](./dapr-overview.md#supported-dapr-apis-components-and-tooling)
 
       - question: |
           What is the Dapr version release cadence in Azure Container Apps?