Partilhar via

Implantar um gateway de Gerenciamento de API do Azure no Azure Arc (visualização)

APLICA-SE A: Programador | Premium

Com a integração entre o Gerenciamento de API do Azure e o Azure Arc no Kubernetes, você pode implantar o componente de gateway de Gerenciamento de API como uma extensão em um cluster Kubernetes habilitado para Azure Arc.

A implantação do gateway de Gerenciamento de API em um cluster Kubernetes habilitado para Azure Arc expande o suporte ao Gerenciamento de API para ambientes híbridos e multicloud. Habilite a implantação usando uma extensão de cluster para tornar o gerenciamento e a aplicação de políticas ao cluster habilitado para ArcGIS do Azure uma experiência consistente.

Important

Atualmente, o gateway auto-hospedado da Gestão de API no Azure Arc está em visualização (preview). Durante a versão prévia, a extensão do gateway de Gerenciamento de API está disponível nas seguintes regiões:

  • Ásia (Leste, Sudeste)
  • Austrália (Central, Central 2, Leste e Sudeste)
  • Brasil (Sul e Sudeste)
  • Canadá (Central, Leste)
  • Europa (Norte, Oeste)
  • França (Centro e Sul)
  • Alemanha (Norte e Centro-Oeste)
  • Índia (Central, Sul, Oeste, Jio central & Jio Oeste)
  • Japão (Leste e Oeste)
  • Coreia (Central e Sul)
  • Noruega (Leste e Oeste)
  • África do Sul (Norte e Oeste)
  • Suécia (Central)
  • Suíça (Norte e Oeste)
  • Emirados Árabes Unidos (EAU - Central & Norte)
  • Reino Unido (UK -Sul)
  • Estados Unidos (EUA - Central, Central EUAP, Leste, Leste 2, Leste 2 EUAP, Centro-Norte, Centro-Sul, Centro-Oeste, Oeste, Oeste 2, Oeste 3)

Note

Você também pode implantar o gateway auto-hospedado diretamente no Kubernetes.

Prerequisites

Implantar a extensão de gateway de Gerenciamento de API usando a CLI do Azure

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. Selecione Deployment + infrastructure>Gateways no menu de navegação lateral.

  3. Selecione e abra seu recurso de gateway provisionado na lista.

  4. No recurso de gateway provisionado, clique em Implantação no menu de navegação lateral.

  5. Anote os valores do Token e do endpoint de Configuração para a próxima etapa.

  6. Na CLI do Azure, implante a extensão de gateway usando o az k8s-extension create comando. Preencha os valores de token e configuration URL.

    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.configuration.uri='<Configuration URL>' \
    --config-protected-settings gateway.auth.token='<token>' \
    --configuration-settings service.type='LoadBalancer' --release-train preview

    Tip

    -protected- flag for gateway.auth.token é opcional, mas recomendado.

  7. Verifique o status da implantação usando o seguinte comando da 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 status do gateway mostra uma marca de seleção verde com uma contagem de nós. Este estado indica que foram implantados os pods de gateway auto-hospedados:

    • Estão se comunicando com êxito com o serviço de Gerenciamento de API.
    • Ter um "batimento cardíaco" regular.

Implantar a extensão do gateway de Gerenciamento de API usando o portal do Azure

  1. No portal do Azure, navegue até o cluster conectado ao Azure Arc.

  2. No menu à esquerda, selecione Configurações>Extensões + aplicativos>+ Adicionar>gateway de gerenciamento de API (visualização).

  3. Selecione Criar.

  4. Na janela Instalar gateway de Gestão de API, configure a extensão do gateway:

    • Selecione a assinatura e o grupo de recursos para sua instância de Gerenciamento de API.
    • Em Detalhes do gateway, selecione a instância de Gerenciamento de API e o nome do gateway. Insira um escopo de namespace para sua extensão e, opcionalmente, um número de réplicas, se suportado em sua camada de serviço de gerenciamento de API.
    • Em Configuração do Kubernetes, selecione a configuração padrão ou uma configuração diferente para o cluster. Para obter opções, consulte Configurações de extensão disponíveis.

    Captura de ecrã a mostrar a implementação da extensão no portal do Azure

  5. Na guia Monitoramento , habilite opcionalmente o monitoramento para carregar solicitações de rastreamento de métricas para o gateway e o back-end. Caso esteja ativado, selecione um Log Analytics espaço de trabalho existente.

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

Configurações de extensão disponíveis

A extensão de gateway auto-hospedado para Azure Arc fornece muitas definições de configuração para personalizar a extensão para seu ambiente. Esta seção lista as configurações de implantação necessárias e as configurações opcionais para integração com o Log Analytics. Para obter uma lista completa de configurações, consulte a referência da extensão de gateway auto-hospedado.

Configurações necessárias

As seguintes configurações de extensão são necessárias.

Setting Description
gateway.configuration.uri Ponto de extremidade de configuração no serviço de Gerenciamento de API para o gateway auto-hospedado.
gateway.auth.token Token de gateway (chave de autenticação) para autenticar no serviço de Gerenciamento de API. Normalmente começa com GatewayKey.
service.type Configuração do serviço Kubernetes para o gateway: LoadBalancer, NodePortou ClusterIP.

Configurações do Log Analytics

Para habilitar o monitoramento do gateway auto-hospedado, defina as seguintes configurações do Log Analytics:

Setting Description
monitoring.customResourceId ID de recurso do Azure Resource Manager para a instância de Gerenciamento de API.
monitoring.workspaceId ID do espaço de trabalho do Log Analytics.
monitoring.ingestionKey Segredo com chave de ingestão do Log Analytics.

Note

Se você não ativou o Log Analytics:

  1. Percorra o guia de início rápido Criar um espaço de trabalho do Log Analytics.
  2. Saiba onde encontrar as configurações do agente do Log Analytics.

Conteúdo relacionado

  • Last updated on