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.
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
Selecione Gateways em Implantação e infraestrutura.
Selecione o recurso de gateway que você pretende implantar.
Selecione Implantação.
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.
Verifique se o Docker está selecionado em Scripts de implantação.
Selecione o link do arquivo env.conf ao lado do Ambiente para baixar o arquivo.
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.
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>
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.
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
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.