Implementación de una puerta de enlace autohospedada de Azure API Management en Docker

  • Artículo

SE APLICA A: Desarrollador | Premium

En este artículo se detallan los pasos para implementar un componente de puerta de enlace autohospedada de Azure API Management en un entorno de Docker.

Importante

El 1 de octubre de 2023 finaliza la compatibilidad con las imágenes de contenedor de la versión 0 y la versión 1 de la puerta de enlace autohospedada de Azure API Management, junto con su correspondiente Configuration API v1. Use nuestra guía de migración para usar la puerta de enlace autohospedada v2.0.0 o posterior con Configuration API v2. Obtenga más información en nuestra documentación de desuso

Nota

El hospedaje de una puerta de enlace autohospedada en Docker es más adecuado para los casos de uso de evaluación y desarrollo. Kubernetes está recomendado para un uso de producción. Obtenga más información sobre cómo implementar con Helm o archivos YAML de implementación para aprender a implementar la puerta de enlace autohospedada en Kubernetes.

Requisitos previos

Nota

La puerta de enlace autohospedada se empaqueta como un contenedor de Docker basado en Linux x86-64.

Implementación de la puerta de enlace autohospedada en Docker

  1. Seleccione Puertas de enlace en Deployment and infrastructure (Implementación e infraestructura).

  2. Seleccione el recurso de puerta de enlace que desea implementar.

  3. Seleccione Implementación.

  4. Tenga en cuenta que en el cuadro de texto Token se generará automáticamente un token de acceso con los valores predeterminados de Expiración y Clave secreta. Si es necesario, elija los valores deseados en uno o ambos controles para generar un nuevo token.

  5. Asegúrese de que Docker esté seleccionado en Scripts de implementación.

  6. Seleccione el vínculo del archivo env.conf junto al Entorno para descargar el archivo.

  7. Seleccione el icono Copiar situado en el extremo derecho del cuadro de texto Ejecutar para copiar el comando de Docker en el portapapeles.

  8. Pegue el comando en la ventana de terminal (o comando). Ajuste las asignaciones de puerto y el nombre del contenedor según sea necesario. Tenga en cuenta que el comando da por supuesto que el archivo de entorno descargado está presente en el directorio actual.

    docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>

  9. Ejecute el comando. El comando indica al entorno de Docker que ejecute el contenedor mediante la imagen de contenedor del Registro de artefacto de Microsoft y que asigne los puertos HTTP (8080) y HTTPS (8081) del contenedor a los puertos 80 y 443 del host.

  10. Ejecute el siguiente comando para comprobar si se está ejecutando el contenedor de puerta de enlace:

    docker ps
CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                         NAMES
895ef0ecf13b        mcr.microsoft.com/azure-api-management/gateway:latest   "/bin/sh -c 'dotnet …"   5 seconds ago       Up 3 seconds        0.0.0.0:80->8080/tcp, 0.0.0.0:443->8081/tcp   my-gateway

  11. Vuelva a Azure Portal, haga clic en Información general y confirme que el contenedor de puerta de enlace autohospedada que acaba de implementar está notificando un estado correcto.

    estado de la puerta de enlace

Sugerencia

Use el comando console docker container logs <gateway-name> para ver una instantánea del registro de la puerta de enlace autohospedada.

Use el comando docker container logs --help para ver todas las opciones de visualización del registro.

Pasos siguientes