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

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.

Nota

Hospedar una puerta de enlace autohospedada en Docker es más adecuada para casos de uso de evaluación y desarrollo. Kubernetes está recomendado para un uso de producción. Aprenda a implementar una puerta de enlace autohospedada en Kubernetes con Helm o mediante un archivo YAML de implementación.

Requisitos previos

• Complete el siguiente inicio rápido: Creación de una instancia de Azure API Management.
• Creación de un entorno de Docker: Docker para Escritorio es una buena opción para fines de desarrollo y evaluación. Consulte la documentación de Docker para obtener información sobre todas las ediciones de Docker, sus características y la documentación completa de Docker.
• Aprovisione un recurso de puerta de enlace en la instancia de Azure API Management.

Nota

Las puertas de enlace autohospedadas se empaquetan como contenedores de Docker basados en Linux x86-64.

Implementación de la puerta de enlace autohospedada en Docker

1. Seleccione Puertas de enlace autohospedados en Implementación e infraestructura.

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

3. Seleccione Configuración>Implementación.

4. Tenga en cuenta que un token de acceso en el cuadro de texto Token se genera automáticamente mediante 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. El comando supone 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 una imagen de contenedor del Registro de artefactos de Microsoft y asignar los puertos HTTP (8080) y HTTPS (8081) del contenedor a los puertos 80 y 443 en el host.

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

    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, seleccione Información general y confirme que el contenedor de puerta de enlace autohospedado que acaba de implementar informa de un estado correcto.

    

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.

Contenido relacionado

• Para más información sobre la puerta de enlace autohospedada, consulte Visión general de la puerta de enlace autohospedada.
• Configure un nombre de dominio personalizado para una puerta de enlace autohospedada.