Merge pull request #236449 from dlepow/dapr

[APIM] Enable Dapr support - SHGW

Author: Jill Grant

articles/api-management/TOC.yml

@@ -206,6 +206,8 @@
                   href: how-to-configure-cloud-metrics-logs.md
                 - name: Configure local metrics and logs for self-hosted gateway
                   href: how-to-configure-local-metrics-logs.md
+                - name: Enable Dapr support on self-hosted gateway
+                  href: self-hosted-gateway-enable-dapr.md  
                 - name: Guidance for running on Kubernetes
                   href: how-to-self-hosted-gateway-on-kubernetes-in-production.md
                 - name: Migrate to self-hosted gateway v2

articles/api-management/invoke-dapr-binding-policy.md

@@ -14,7 +14,7 @@ ms.author: danlep
 
 The `invoke-dapr-binding` policy instructs API Management gateway to trigger an outbound Dapr [binding](https://github.com/dapr/docs/blob/master/README.md). The policy accomplishes that by making an HTTP POST request to `http://localhost:3500/v1.0/bindings/{{bind-name}},` replacing the template parameter and adding content specified in the policy statement.
 
-The policy assumes that Dapr runtime is running in a sidecar container in the same pod as the gateway. Dapr runtime is responsible for invoking the external resource represented by the binding. Learn more about [Dapr integration with API Management](api-management-dapr-policies.md).
+The policy assumes that Dapr runtime is running in a sidecar container in the same pod as the gateway. Dapr runtime is responsible for invoking the external resource represented by the binding. Learn more about [Dapr integration with API Management](self-hosted-gateway-enable-dapr.md).
 
 [!INCLUDE [api-management-policy-generic-alert](../../includes/api-management-policy-generic-alert.md)]
 
@@ -58,7 +58,7 @@ The policy assumes that Dapr runtime is running in a sidecar container in the sa
 
 ### Usage notes
 
-Dapr support must be [enabled](api-management-dapr-policies.md#enable-dapr-support-in-the-self-hosted-gateway) in the self-hosted gateway.
+Dapr support must be [enabled](self-hosted-gateway-enable-dapr.md) in the self-hosted gateway.
 
 
 ## Example

articles/api-management/publish-to-dapr-policy.md

@@ -14,7 +14,7 @@ ms.author: danlep
 
 The `publish-to-dapr` policy instructs API Management gateway to send a message to a Dapr Publish/Subscribe topic. The policy accomplishes that by making an HTTP POST request to `http://localhost:3500/v1.0/publish/{{pubsub-name}}/{{topic}}`, replacing template parameters and adding content specified in the policy statement.
 
-The policy assumes that Dapr runtime is running in a sidecar container in the same pod as the gateway. Dapr runtime implements the Pub/Sub semantics. Learn more about [Dapr integration with API Management](api-management-dapr-policies.md).
+The policy assumes that Dapr runtime is running in a sidecar container in the same pod as the gateway. Dapr runtime implements the Pub/Sub semantics. Learn more about [Dapr integration with API Management](self-hosted-gateway-enable-dapr.md).
 
 [!INCLUDE [api-management-policy-generic-alert](../../includes/api-management-policy-generic-alert.md)]
 
@@ -47,7 +47,7 @@ The policy assumes that Dapr runtime is running in a sidecar container in the sa
 
 ### Usage notes
 
-Dapr support must be [enabled](api-management-dapr-policies.md#enable-dapr-support-in-the-self-hosted-gateway) in the self-hosted gateway.
+Dapr support must be [enabled](self-hosted-gateway-enable-dapr.md) in the self-hosted gateway.
 
 ## Example
 

articles/api-management/self-hosted-gateway-enable-dapr.md

@@ -0,0 +1,43 @@
+---
+title: Enable Dapr support in self-hosted gateway | Azure API Management
+description: Learn now to enable Dapr support in the self-hosted gateway of Azure API Management to expose and manage Dapr microservices as APIs. 
+services: api-management
+author: dlepow
+
+ms.service: api-management
+ms.topic: article
+ms.date: 05/01/2023
+ms.author: danlep
+---
+
+# Enable Dapr support in the self-hosted gateway
+
+Dapr integration in API Management enables operations teams to directly expose Dapr microservices deployed on Kubernetes clusters as APIs, and make those APIs discoverable and easily consumable by developers with proper controls across multiple Dapr deployments—whether in the cloud, on-premises, or on the edge.
+
+## About Dapr
+
+Dapr is a portable runtime for building stateless and stateful microservices-based applications with any language or framework. It codifies the common microservice patterns, like service discovery and invocation with build-in retry logic, publish-and-subscribe with at-least-once delivery semantics, or pluggable binding resources to ease composition using external services. Go to [dapr.io](https://dapr.io) for detailed information and instruction on how to get started with Dapr.
+
+## Enable Dapr support
+
+To turn on Dapr support in the API Management self-hosted gateway, add the following [Dapr annotations](https://docs.dapr.io/reference/arguments-annotations-overview/) to the [Kubernetes deployment template](how-to-deploy-self-hosted-gateway-kubernetes.md), replacing `app-name` with a desired name. A complete walkthrough of setting up and using API Management with Dapr is available [here](https://aka.ms/apim/dapr/walkthru).
+
+```yml
+template:
+    metadata:
+      labels:
+        app: app-name
+      annotations:
+        dapr.io/enabled: "true"
+        dapr.io/app-id: "app-name"
+```
+> [!TIP]
+> You can also deploy the [self-hosted gateway with Helm](how-to-deploy-self-hosted-gateway-kubernetes-helm.md) and use the Dapr configuration options.
+
+## Dapr integration policies
+
+API Management provides specific [policies](api-management-policies.md#dapr-integration-policies) to interact with Dapr APIs exposed through the self-hosted gateway.
+
+## Next steps
+
+* Learn more about [Dapr integration in API Management](https://cloudblogs.microsoft.com/opensource/2020/09/22/announcing-dapr-integration-azure-api-management-service-apim/)

articles/api-management/self-hosted-gateway-settings-reference.md

@@ -104,7 +104,4 @@ helm install azure-api-management-gateway \
 -   [Deploy self-hosted gateway to Docker](how-to-deploy-self-hosted-gateway-docker.md)
 -   [Deploy self-hosted gateway to Kubernetes](how-to-deploy-self-hosted-gateway-kubernetes.md)
 -   [Deploy self-hosted gateway to Azure Arc-enabled Kubernetes cluster](how-to-deploy-self-hosted-gateway-azure-arc.md)
-
-
-
-
+- [Enable Dapr support on self-hosted gateway](self-hosted-gateway-enable-dapr.md)

articles/api-management/set-backend-service-dapr-policy.md

@@ -14,7 +14,7 @@ ms.author: danlep
 
 The `set-backend-service` policy sets the target URL for the current request to `http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name}`, replacing template parameters with values specified in the policy statement.
 
-The policy assumes that Dapr runs in a sidecar container in the same pod as the gateway. Upon receiving the request, Dapr runtime performs service discovery and actual invocation, including possible protocol translation between HTTP and gRPC, retries, distributed tracing, and error handling. Learn more about [Dapr integration with API Management](api-management-dapr-policies.md).
+The policy assumes that Dapr runs in a sidecar container in the same pod as the gateway. Upon receiving the request, Dapr runtime performs service discovery and actual invocation, including possible protocol translation between HTTP and gRPC, retries, distributed tracing, and error handling. Learn more about [Dapr integration with API Management](self-hosted-gateway-enable-dapr.md).
 
 [!INCLUDE [api-management-policy-generic-alert](../../includes/api-management-policy-generic-alert.md)]
 
@@ -41,7 +41,7 @@ The policy assumes that Dapr runs in a sidecar container in the same pod as the
 
 ### Usage notes
 
-Dapr support must be [enabled](api-management-dapr-policies.md#enable-dapr-support-in-the-self-hosted-gateway) in the self-hosted gateway.
+Dapr support must be [enabled](self-hosted-gateway-enable-dapr.md) in the self-hosted gateway.
 
 ## Example