Comece com Azure Kubernetes Application Network for AKS (pré-visualização)

Importante

Os recursos de pré-visualização do AKS estão disponíveis numa base de autosserviço e adesão voluntária. As visualizações prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões de teste do AKS são parcialmente cobertas pelo suporte ao cliente numa base de melhor esforço. Assim sendo, estas funcionalidades não se destinam ao uso em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

Este artigo ajuda-o a começar com a Azure Kubernetes Application Network para AKS. Fornece instruções passo a passo para criar um recurso de Rede de Aplicações e ligar um cluster AKS a ele como um cluster membro.

Pré-requisitos

Definir variáveis de ambiente

  • Defina as seguintes variáveis de ambiente para o seu recurso e cluster Azure Kubernetes Application Network. Pode usar um cluster existente ou criar um numa etapa posterior antes de o adicionar à sua Rede de Aplicações Azure Kubernetes.

    export SUBSCRIPTION=<subscription-id>
export LOCATION=<location>
export APPNET_RG=<resource-group-for-appnet-resource>
export APPNET_NAME=<appnet-name>
export APPNET_MEMBER_NAME=<appnet-member-name>
export AKS_RG=<aks-cluster-resource-group>
export CLUSTER_NAME=<cluster-name>

Registe a funcionalidade para uma prévia pública

  1. Registe a funcionalidade para o Azure Kubernetes Application Network usando o az feature register comando.

    az feature register --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION

  2. Espere que a funcionalidade seja registada. Podes verificar o estado usando o az feature show comando.

    az feature show --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION

    O properties.state campo na saída mostrará Registered quando o registo está concluído.

  3. Depois de a funcionalidade ser registada, atualize o registo do fornecedor de recursos Microsoft.AppLink usando o az provider register comando.

    az provider register --namespace Microsoft.AppLink --subscription $SUBSCRIPTION

Instale a extensão da CLI do AppNet

  • Instala a extensão da CLI do AppNet usando o az extension add comando.

    az extension add --name appnet-preview

Definir subscrição ativa

  • Defina a subscrição ativa para aquela que pretende usar para a Rede de Aplicações Azure Kubernetes usando o az account set comando.

    az account set --subscription $SUBSCRIPTION

Criar um cluster do AKS

Observação

Os clusters de membros não precisam de estar em grupos de recursos separados. Podem estar no mesmo grupo de recursos que o recurso Azure Kubernetes Application Network. No entanto, todos os clusters membros devem estar no mesmo locatário.

Se não tiver um cluster AKS existente para se ligar à Azure Kubernetes Application Network, precisa de criar um. A Azure Kubernetes Application Network requer clusters AKS que cumpram os seguintes requisitos:

Se tiver um cluster já existente que cumpra estes requisitos, pode saltar este passo.

  1. Cria um grupo de recursos para o teu cluster AKS usando o az group create comando.

    az group create --name $AKS_RG --location $LOCATION

  2. Crie um cluster AKS com a integração do Microsoft Entra gerida pelo AKS, o emissor OIDC e o suplemento gerido da API de Gateway do Kubernetes ativados, utilizando o comando az aks create com as opções --enable-oidc-issuer, --enable-aad e --enable-gateway-api. Não ative o suplemento de malha de serviços Istio (--enable-azure-service-mesh) neste cluster.

    az aks create --name $CLUSTER_NAME --resource-group $AKS_RG --enable-oidc-issuer --enable-aad --enable-gateway-api

Crie um recurso de Rede de Aplicações Kubernetes no Azure

  1. Crie um grupo de recursos para o seu recurso Azure Kubernetes Application Network usando o az group create comando.

    az group create --name $APPNET_RG --location $LOCATION

  2. Crie um recurso Azure Kubernetes Application Network usando o az appnet create comando.

    Observação

    Não pode alterar a localização, subscrição ou grupo de recursos de uma Rede de Aplicações depois de a criar.

    az appnet create --resource-group $APPNET_RG --name $APPNET_NAME --location $LOCATION  --identity-type SystemAssigned

    O processo de criação pode demorar alguns minutos. O properties.provisioningState campo da saída mostra Succeeded para uma Rede de Aplicações Azure Kubernetes criada com sucesso.

  3. Visualize o seu recurso Azure Kubernetes Application Network usando o az appnet show comando.

    az appnet show --resource-group $APPNET_RG --name $APPNET_NAME

Junte-se a um cluster AKS como membro da Azure Kubernetes Application Network

Quando juntar um cluster membro à Azure Kubernetes Application Network, pode especificar um dos seguintes modos de atualização para esse cluster: totalmente gerido ou autogerido. O modo de atualização determina como as pequenas atualizações de versão da Azure Kubernetes Application Network são aplicadas ao cluster membro. Se não especificares um modo de atualização durante a adesão dos membros, define-se por defeito para SelfManaged. Para mais informações sobre modos de atualização, consulte Configurar atualizações para membros da Azure Kubernetes Application Network.

Observação

Não é possível alterar a Rede de Aplicações principal, a localização, a subscrição ou o grupo de recursos de um membro depois de o associar. Para alterar qualquer um destes, remova o membro e volte a juntá-lo com os novos valores.

  • Junte-se a um cluster AKS enquanto membro da Azure Kubernetes Application Network, usando o comando az appnet member join com o parâmetro --upgrade-mode definido como FullyManaged ou SelfManaged. O exemplo seguinte mostra como juntar-se a um cluster de membros no SelfManaged modo:

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged

Verificar a conectividade do membro do cluster

  • Depois de se juntar ao cluster, pode verificar a conectividade e visualizar os detalhes dos membros usando o az appnet member show comando.

    az appnet member show --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME

    Por exemplo, se estiver inscrito no modo totalmente gerido com Stable canal de lançamento, a saída seria a seguinte:

    {
  "id": "/subscriptions/$SUBSCRIPTION/resourceGroups/$APPNET_RG/providers/Microsoft.AppLink/appLinks/$APPNET_NAME/appLinkMembers/$APPNET_MEMBER_NAME",
  "location": "myLocation",
  "name": "myMemberName",
  "properties": {
    "clusterType": "AKS",
    "connectivityProfile": {
      "eastWestGateway": {
        "visibility": "Internal"
      }
    },
    "metadata": {
      "resourceId": "/subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME"
    },
    "observabilityProfile": {
      "metrics": {
        "metricsEndpoint": "https://myMember-mcp-fqdn.appnet.net"
      }
    },
    "provisioningState": "Succeeded",
    "upgradeProfile": {
      "mode": "FullyManaged",
      "fullyManagedUpgradeProfile": {
        "releaseChannel": "Stable"
      }
    }
  },
  "resourceGroup": "myAppNetRG",
  "type": "microsoft.applink/applinks/applinkmembers"
}

Listar membros da Rede de Aplicações do Azure Kubernetes

Vários clusters podem juntar-se a uma Rede de Aplicações Azure Kubernetes.

  • Liste todos os membros de uma Rede de Aplicações Azure Kubernetes usando o az appnet member list comando.

    az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME --output table

Eliminar recursos de Rede de Aplicação do Azure Kubernetes

Eliminar um recurso da Azure Kubernetes Application Network remove automaticamente todos os seus membros, por isso não precisa de remover membros primeiro. Remover um membro, seja individualmente ou através desta cascata, não apaga o correspondente cluster AKS.

Remover um membro da Rede de Aplicações Azure Kubernetes

Observação

Antes de remover um membro, deve remover as suas cargas de trabalho do plano de dados ambiente removendo os rótulos Istio que aplicou anteriormente, como istio.io/use-waypoint, istio.io/use-waypoint-namespace, e istio.io/dataplane-mode, dos recursos.

  1. Remover um membro da Azure Kubernetes Application Network usando o az appnet member remove comando.

    az appnet member remove --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME

  2. Verifique se o membro foi removido usando o az appnet member list comando.

    az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME

Elimine um recurso de Rede de Aplicações do Azure Kubernetes

  • Elimine o recurso Azure Kubernetes Application Network usando o az appnet delete comando.

    az appnet delete --resource-group $APPNET_RG --appnet-name $APPNET_NAME

Conteúdo relacionado

Para saber mais sobre a Azure Kubernetes Application Network, consulte os seguintes artigos:

  • Última atualização a