Partilhar via


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

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.

    Status do gateway

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