Implantar um gateway autogerido no Kubernetes usando YAML

APLICA-SE A: Desenvolvedor | Premium

Este artigo descreve as etapas para implantar o componente de gateway auto-hospedado do Gerenciamento de API do Azure em um cluster Kubernetes.

Nota

Pode também implementar o gateway autogerido num cluster Kubernetes habilitado para Azure Arc como extensão de cluster.

Pré-requisitos

• Conclua o seguinte guia de início rápido: Criar uma instância da Gestão de API do Azure.

• Crie um cluster Kubernetes ou tenha acesso a um existente.

  Gorjeta

  Os clusters de nó único funcionam bem para fins de desenvolvimento e avaliação. Use clusters de vários nós certificados pelo Kubernetes no local ou na nuvem para cargas de trabalho de produção

• Provisione um recurso de gateway auto-hospedado em sua instância de Gerenciamento de API.

Implementar no Kubernetes

Gorjeta

As etapas a seguir implantam o gateway auto-hospedado no Kubernetes e habilitam a autenticação para a instância de Gerenciamento de API usando um token de acesso de gateway (chave de autenticação). Você também pode implantar o gateway auto-hospedado no Kubernetes e habilitar a autenticação para a instância de Gerenciamento de API usando o Microsoft Entra ID.

1. Selecione Gateways em Implantação e infraestrutura.
2. Selecione o recurso de gateway auto-hospedado que você deseja implantar.
3. Selecione Implantação.
4. Um token de acesso na caixa de texto Token foi gerado automaticamente para você, com base nos valores de chave padrão Expiração e Segredo . Se necessário, escolha valores em um ou ambos os controles para gerar um novo token.
5. Selecione a guia Kubernetes no Scripts de implantação.
6. Selecione o <link do arquivo gateway-name>.yml e baixe o arquivo YAML.
7. Selecione o ícone de cópia no canto inferior direito da caixa de texto Deploy para salvar os kubectl comandos na área de transferência.
8. Ao usar o Serviço Kubernetes do Azure (AKS), execute az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin em uma nova sessão de terminal.
9. Corra os comandos para criar os objetos Kubernetes necessários no namespace default e inicie os pods de gateway auto-hospedados a partir de imagem de contêiner baixada do Microsoft Artifact Registo.
   • A primeira etapa cria um segredo do Kubernetes que contém o token de acesso gerado na etapa 4. Em seguida, o sistema cria uma implementação do Kubernetes para o gateway auto-hospedado, que utiliza um ConfigMap com a configuração do gateway.

Confirme se o gateway está em execução

1. Execute o seguinte comando para verificar se a implantação foi bem-sucedida. Pode levar um pouco de tempo para que todos os objetos sejam criados e para que os pods sejam inicializados.

   kubectl get deployments
   

   Deveria retornar

   NAME             READY   UP-TO-DATE   AVAILABLE   AGE
   <gateway-name>   1/1     1            1           18s
   

2. Execute o seguinte comando para verificar se os serviços foram criados com êxito. Os IPs e as portas do seu serviço serão diferentes.

   kubectl get services
   

   Deveria retornar

   NAME                                TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
   <gateway-name>-live-traffic         ClusterIP      None            <none>        4290/UDP,4291/UDP   9m1s
   <gateway-name>-instance-discovery   LoadBalancer   10.99.236.168   <pending>     80:31620/TCP,443:30456/TCP   9m1s
   

3. Volte para o portal do Azure e selecione Visão geral.

4. Confirme se Status mostra uma marca de seleção verde, seguida por uma contagem de nós que corresponde ao número de réplicas especificadas no arquivo YAML. Este estado significa que os pods de gateway auto-hospedado implementados estão a comunicar-se com sucesso com o serviço de Gestão de API e têm um "sinal de vida" regular.

Gorjeta

• Execute o kubectl logs deployment/<gateway-name> comando para visualizar logs de um pod selecionado aleatoriamente se houver mais de um.
• Execute kubectl logs -h para obter um conjunto completo de opções de comando, como exibir logs para um pod ou contêiner específico.

Conteúdo relacionado

• Para saber mais sobre o gateway auto-hospedado, consulte Visão geral do gateway auto-hospedado.
• Saiba como implantar o gateway auto-hospedado do Gerenciamento de API em clusters Kubernetes habilitados para Azure Arc.
• Saiba mais sobre as orientações para executar o gateway auto-hospedado no Kubernetes em produção.