Implementar uma porta de gestão AZure API em Azure Arc (pré-visualização)

Com a integração entre a Azure API Management e o Azure Arc em Kubernetes,pode implantar o componente de gateway de gestão API como uma extensão num cluster Azure Arc habilitado a Kubernetes.

Implantando o gateway de Gestão API num cluster Kubernetes ativado pelo Arco expande o suporte de Gestão API para ambientes híbridos e multi-cloud. Ative a implementação utilizando uma extensão de cluster para tornar as políticas de gestão e aplicação ao seu cluster ativado pelo Arco uma experiência consistente.

Importante

A API Management auto-hospedada gateway em Azure Arc está atualmente em pré-visualização.

Nota

Também pode implantar a porta de entrada auto-hospedada diretamente para Kubernetes.

Pré-requisitos

Implementar a extensão do gateway de gestão API utilizando o Azure CLI

  1. No portal Azure, navegue para o seu caso de Gestão API.

  2. Selecione Gateways do menu de navegação lateral.

  3. Selecione e abra o seu recurso de gateway aprovisionado a partir da lista.

  4. No seu recurso de gateway aprovisionado, clique em Implementação a partir do menu de navegação lateral.

  5. Tome nota dos valores de URL de Token e Configuração para o próximo passo.

  6. Em Azure CLI, desloque a extensão do gateway utilizando o az k8s-extension create comando. Preencha os token configuration URL valores e valores.

    az k8s-extension create --cluster-type connectedClusters --cluster-name <cluster-name> \
      --resource-group <rg-name> --name <extension-name> --extension-type Microsoft.ApiManagement.Gateway \
      --scope namespace --target-namespace <namespace> \
      --configuration-settings gateway.endpoint='<Configuration URL>' \
      --configuration-protected-settings gateway.authKey='<token>' --release-train preview
    

    Dica

    -protected- bandeira para authKey é opcional, mas recomendado.

  7. Verificar o estado de implantação utilizando o seguinte comando CLI:

    az k8s-extension show --cluster-type connectedClusters --cluster-name <cluster-name> --resource-group <rg-name> --name <extension-name>
    
  8. Navegue de volta para a lista gateways para verificar se o estado do gateway mostra uma marca de verificação verde com uma contagem de nós. Este estado significa que as cápsulas de porta de entrada auto-aloidas implantadas:

    • Estão a comunicar com sucesso com o serviço de Gestão da API.
    • Tenha um "batimento cardíaco" regular.

Implementar a extensão do gateway de gestão da API utilizando o portal Azure

  1. No portal Azure, navegue para o seu cluster ligado ao Arco Azure.

  2. No menu esquerdo, selecione Extensões (pré-visualização) > + Adicione gateway de > gestão API (pré-visualização).

  3. Selecione Criar.

  4. Na janela de gateway install da API Management, configurar a extensão do gateway:

    • Selecione o grupo de subscrição e recursos para a sua instância de Gestão de API.
    • Em detalhes gateway, selecione a instância de Gestão da API e o nome Gateway. Introduza uma extensão namespace para a sua extensão e opcionalmente uma série de Réplicas, se suportado no seu nível de serviço de Gestão API.
    • Na configuração de Kubernetes, selecione a configuração padrão ou uma configuração diferente para o seu cluster. Para obter opções, consulte as configurações de extensão disponíveis.

    Screenshot de implantação da extensão no portal Azure

  5. No separador Monitor, opcionalmente, permitir a monitorização para carregar as métricas de rastreio de pedidos para o gateway e backend. Se ativado, selecione um espaço de trabalho do Log Analytics existente.

  6. Selecione Rever + instalar e, em seguida, instalar.

Configurações de extensão disponíveis

São necessárias as seguintes configurações de extensão .

Definições Descrição
gateway.endpoint URL de configuração do ponto final do gateway.
gateway.authKey Token para acesso ao portal.
service.Type Configuração de serviço Kubernetes para o gateway: LoadBalancer NodePort , , ou ClusterIP .

Registar definições de Analítico

Para permitir a monitorização do gateway auto-hospedado, configufique as seguintes definições de Log Analytics:

Definições Descrição
monitoring.customResourceId ID de recursos Azure Resource Manager para o caso de Gestão da API.
monitoring.workspaceId ID do espaço de trabalho da Log Analytics.
monitoring.ingestionKey Segredo com chave de ingestão do Log Analytics.

Nota

Se não tiver ativado o Log Analytics:

  1. Caminhe pelo espaço de trabalho Create a Log Analytics.
  2. Saiba onde encontrar as definiçõesdo agente Log Analytics .

Passos Seguintes