Implantar um gateway auto-hospedado do Azure API Management no Docker

APLICA-SE A: Developer | Prémio

Este artigo fornece as etapas para implantar o componente de gateway auto-hospedado do Gerenciamento de API do Azure em um ambiente do Docker.

Importante

O suporte para imagens de contêiner de gateway auto-hospedado do Azure API Management versão 0 e versão 1 termina em 1º de outubro de 2023, juntamente com sua API de Configuração v1 correspondente. Use nosso guia de migração para usar o gateway auto-hospedado v2.0.0 ou superior com a API de configuração v2. Saiba mais em nossa documentação de substituição

Nota

A hospedagem de gateway auto-hospedado no Docker é mais adequada para casos de uso de avaliação e desenvolvimento. O Kubernetes é recomendado para uso em produção. Saiba como implantar com o Helm ou usando o arquivo YAML de implantação para saber como implantar o gateway auto-hospedado no Kubernetes.

Pré-requisitos

• Concluir o início rápido seguinte: Criar uma instância da Gestão de API do Azure
• Crie um ambiente do Docker. O Docker for Desktop é uma boa opção para fins de desenvolvimento e avaliação. Consulte a documentação do Docker para obter informações sobre todas as edições do Docker, seus recursos e documentação abrangente sobre o próprio Docker.
• Provisionar um recurso de gateway em sua instância de Gerenciamento de API

Nota

O gateway auto-hospedado é empacotado como um contêiner do Docker baseado em Linux x86-64.

Implantar o gateway auto-hospedado no Docker

1. Selecione Gateways em Implantação e infraestrutura.

2. Selecione o recurso de gateway que você pretende implantar.

3. Selecione Implantação.

4. Observe que um token de acesso na caixa de texto Token foi gerado automaticamente para você usando os valores de chave padrão Expiração e Segredo. Se necessário, escolha os valores desejados em um ou ambos os controles para gerar um novo token.

5. Verifique se o Docker está selecionado em Scripts de implantação.

6. Selecione o link do arquivo env.conf ao lado do Ambiente para baixar o arquivo.

7. Selecione o ícone de cópia localizado na extremidade direita da caixa de texto Executar para copiar o comando do Docker para a área de transferência.

8. Cole o comando na janela do terminal (ou comando). Ajuste os mapeamentos de porta e o nome do contêiner conforme necessário. Observe que o comando pressupõe que o arquivo de ambiente baixado está presente no diretório atual.

   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. Execute o comando. O comando instrui seu ambiente do Docker a executar o contêiner usando uma imagem de contêiner do Microsoft Artifact Registry e a mapear as portas HTTP (8080) e HTTPS (8081) do contêiner para as portas 80 e 443 no host.

10. Execute o comando abaixo para verificar se o contêiner do gateway está em execução:

    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. Volte para o portal do Azure, clique em Visão geral e confirme se o contêiner de gateway auto-hospedado que você acabou de implantar está relatando um status íntegro.

    

Gorjeta

Use console docker container logs <gateway-name> o comando para exibir um instantâneo do log de gateway auto-hospedado.

Use docker container logs --help o comando para ver todas as opções de visualização de log.

Próximos passos

• Para saber mais sobre o gateway auto-hospedado, consulte Visão geral do gateway auto-hospedado do Gerenciamento de API do Azure.
• Configure o nome de domínio personalizado para o gateway auto-hospedado.