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

APLICA-SE A: Programador | Premium

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

Note

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

Prerequisites

• Conclua a instrução de início rápido seguinte: Criar uma instância da Gestão de APIs do Azure.
• Criar um ambiente 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.
• Provisione um recurso de gateway em sua instância de Gerenciamento de API do Azure.

Note

Os gateways auto-hospedados são empacotados como contêineres do Docker baseados em Linux x86-64.

Implantar o gateway auto-hospedado no Docker

1. Selecione Gateways autogeridos em Implementação + infraestrutura.

2. Selecione o recurso de gateway que deseja implantar.

3. Selecione Configurações>de implantação.

4. Observe que um token de acesso na caixa de texto Token é 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 Copiar localizado na extremidade direita da caixa de texto Executar para copiar o comando 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. O comando assume 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 mapear as portas HTTP (8080) e HTTPS (8081) do contêiner para as portas 80 e 443 no host.

10. Execute o seguinte comando 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, selecione Visão geral e confirme se o contêiner de gateway autohospedado que você acabou de implantar relata um status íntegro.

    

Tip

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

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

Conteúdo relacionado

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