Container Image - v2.3.0

Getting started

You can easily install the self-hosted gateway with Docker:

docker run -d -p 8080:8080 -p 8081:8081 --name <gateway-name> --envconfig.service.endpoint=<instance-name>.configuration.azure-api.net
config.service.auth=<auth-token> mcr.microsoft.com/azure-api-management/gateway:2.3.0

Learn how you can install it on other container platforms:

• Deploy self-hosted gateway on Kubernetes with Helm
• Deploy self-hosted gateway on Kubernetes with Azure Arc (Preview)
• Deploy self-hosted gateway on Kubernetes with YAML

Here are other relevant resources:

• Authenticate self-hosted gateway with Azure AD
• Self-hosted gateway on Microsoft Artifact Registry
• Migrate to self-hosted gateway v2
• Our image tagging strategy

What is new?

Features

• Support for using Azure AD authentication for Configuration API v2 (docs)
• Support for using Configuration API v2 with custom hostname (docs)
• Support for exposing system metrics in OpenTelemetry Collector (configuration reference)

Fixes / Changes

• Provide automated fallback for regional Azure AD based on DNS failures (see MSAL discussion)
• Improve logging around local log sink creation/connection outcome
• Fix for CVE-2023-29491 vulnerability in our base image (High Severity | details)
• Fixed a bug where CPU spikes are caused due to excessive logging due to ScheduledActionMissedDeadline
• Fixed a bug where logs are polluted with System.Diagnostics.Tracing.EventPayload entries
• Fixed a bug where localsyslog telemetry was no longer sent correctly due to connection issues while streaming
• Fixed a bug where request fails with exception Stack empty

Breaking Changes

None.

Removal

None.