Implantar um gateway auto-hospedado do API Management do Azure no Docker
APLICA-SE A: Desenvolvedor | Premium
Este artigo fornecerá as etapas necessárias para implantar um componente de gateway auto-hospedado do API Management do Azure em um ambiente do Docker.
Observação
A hospedagem de gateway auto-hospedado no Docker é mais adequada em casos de uso de avaliação e desenvolvimento. Recomendamos usar o Kubernetes na 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
- Conclua o início rápido a seguir: Criar uma instância do Gerenciamento de API do Azure
- Criar um ambiente do Docker. O Docker para Desktop é uma opção adequada para fins de desenvolvimento e avaliação. Confira a documentação do Docker para obter informações sobre todas as edições do Docker, os respectivos recursos e uma documentação abrangente sobre o Docker.
- Provisionar um recurso de gateway em sua instância de API Management
Observação
Um gateway auto-hospedado deve ser empacotado como um contêiner do Docker baseado no Linux x64 e x86.
Implantar um gateway auto-hospedado no Docker
Selecione Gateways na opção Implantação e infraestrutura.
Selecione o recurso de gateway que você deseja implantar.
Selecione Implantação.
Observe que um token de acesso foi gerado de modo automático para você na caixa de texto Token usando os valores padrão de Vencimento e Chave secreta. Caso seja necessário, escolha os valores desejados em um dos controles ou em ambos para gerar um token.
Verifique se o Docker está selecionado na opção Scripts de implantação.
Clique no link do arquivo env.conf ao lado da opção Ambiente para baixar o arquivo.
Clique no ícone Copiar localizado na extremidade direita da caixa de texto Executar a fim de 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 de contêiner, conforme necessário. Observe que o comando supõe que o arquivo de ambiente baixado está disponível 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 o ambiente do Docker a executar o contêiner usando a 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 do 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 ao portal do Azure, clique em Visão Geral e confirme se o contêiner de gateway auto-hospedado recém implantado está relatando um status da integridade.
Dica
Use o comando console docker container logs <gateway-name>
para exibir um instantâneo do log do gateway auto-hospedado.
Use o comando docker container logs --help
para conferir todas as opções de exibição de log.
Próximas etapas
- Para saber mais sobre o gateway auto-hospedado, confira a Visão geral do gateway auto-hospedado do API Management do Azure.
- Configurar um nome de domínio personalizado para um gateway auto-hospedado.