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-preview-2⚠️ This is a preview release for which we do not provide support and should only be used for evaluation/experimentation.
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.EventPayloadentries - 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.