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

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

Pré-requisitos

• Conclua o seguinte guia de início rápido: Criar uma instância do Gerenciamento de API do Azure.
• Criar um ambiente do Docker: o Docker para Área de Trabalho é uma boa opção 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.
• Provisione um recurso de gateway em sua instância de Gerenciamento de API do Azure.

Observação

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

Implantar um gateway auto-hospedado no Docker

1. Selecione gateways autogerenciados em Implantação e infraestrutura.

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

3. Selecione Configurações>Implantação.

4. Observe que um token de acesso na caixa de texto token é gerado automaticamente para você usando os valores padrão de expiração e chave secreta . Caso seja necessário, escolha os valores desejados em um dos controles ou em ambos para gerar um token.

5. Verifique se o Docker está selecionado na opção 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 do Docker para sua área de transferência.

8. Cole o comando na janela do terminal (ou comando). Ajuste os mapeamentos de porta e o nome de contêiner, conforme necessário. O comando pressupõe que o arquivo de ambiente baixado esteja 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 o ambiente do Docker a executar o contêiner usando uma imagem de contêiner do Registro de Artefatos da Microsoft 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 auto-hospedado que você acabou de implantar relata um status íntegro.

    

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.

Conteúdo relacionado

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