Introducción a Azure Kubernetes Application Network para AKS (versión preliminar)

Importante

Las características en versión preliminar de AKS están disponibles a elección del usuario y en régimen de autoservicio. Las versiones preliminares se proporcionan "tal cual" y "como están disponibles", y están excluidas de los Acuerdos de nivel de servicio y garantía limitada. Las versiones preliminares de AKS cuentan con soporte parcial por parte del servicio al cliente en la medida de lo posible. Por lo tanto, estas características no están diseñadas para su uso en producción. Para más información, consulte los siguientes artículos de soporte:

Este artículo le ayuda a empezar a trabajar con Azure Kubernetes Application Network para AKS. Proporciona instrucciones paso a paso para crear un recurso de Application Network y conectar un clúster de AKS a él como un clúster miembro.

Prerrequisitos

Establecimiento de variables de entorno

  • Establezca las siguientes variables de entorno para el recurso y el clúster de Application Network de Azure Kubernetes. Puede usar un clúster existente o crear uno en un paso posterior antes de agregarlo a la red de aplicaciones de 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>

Registro de la característica para la versión preliminar pública

  1. Registre la característica para Azure Kubernetes Application Network mediante el az feature register comando .

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

  2. Espere a que se registre la característica. Puede comprobar el estado mediante el az feature show comando .

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

    El properties.state campo de la salida se mostrará Registered cuando se complete el registro.

  3. Una vez registrada la característica, actualice el registro del proveedor de recursos Microsoft.AppLink mediante el az provider register comando .

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

Instalación de la extensión de la CLI de AppNet

  • Instale la extensión de la CLI de AppNet mediante el az extension add comando .

    az extension add --name appnet-preview

Establecimiento de una suscripción activa

  • Establezca la suscripción activa que desea utilizar para Azure Kubernetes Application Network mediante el comando az account set.

    az account set --subscription $SUBSCRIPTION

Creación de un clúster de AKS

Nota:

Los clústeres de miembros no necesitan estar en grupos de recursos independientes. Pueden estar en el mismo grupo de recursos que el recurso de Azure Kubernetes Application Network. Sin embargo, todos los clústeres miembro deben estar en la misma entidad.

Si no tiene un clúster de AKS existente para conectarse a Azure Kubernetes Application Network, debe crear uno. Azure Kubernetes Application Network requiere clústeres de AKS que cumplan los siguientes requisitos:

Si tiene un clúster existente que ya cumple estos requisitos, puede omitir este paso.

  1. Cree un grupo de recursos para el clúster de AKS mediante el az group create comando .

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

  2. Cree un clúster de AKS con la integración de Microsoft Entra administrada por AKS, el emisor de OIDC y el complemento administrado de la API de puerta de enlace de Kubernetes habilitados con el comando az aks create y las marcas --enable-oidc-issuer, --enable-aad y --enable-gateway-api. No habilite el complemento de malla de servicios de Istio (--enable-azure-service-mesh) en este clúster.

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

Creación de un recurso de Azure Kubernetes Application Network

  1. Cree un grupo de recursos para el recurso de Azure Kubernetes Application Network mediante el az group create comando .

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

  2. Cree un recurso de Azure Kubernetes Application Network mediante el az appnet create comando .

    Nota:

    No se puede cambiar la ubicación, la suscripción o el grupo de recursos de un recurso de Application Network después de crearlo.

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

    El proceso de creación puede tardar unos minutos. El campo properties.provisioningState de la salida muestra Succeeded para una Red de Aplicación de Azure Kubernetes creada exitosamente.

  3. Consulte el recurso de Azure Kubernetes Application Network mediante el az appnet show comando .

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

Unirse a un clúster de AKS como miembro de Azure Kubernetes Application Network

Al unir un clúster miembro a Azure Kubernetes Application Network, puede especificar uno de los siguientes modos de actualización para ese clúster: totalmente administrado o autoadministrado. El modo de actualización determina cómo se aplican las actualizaciones de versiones secundarias de Azure Kubernetes Application Network al clúster miembro. Si no especifica un modo de actualización durante la incorporación de un miembro, el valor predeterminado es SelfManaged. Para más información sobre los modos de actualización, consulte Configuración de actualizaciones para los miembros de Application Network de Azure Kubernetes.

Nota:

No puede cambiar la red de aplicaciones primaria de un miembro, la ubicación, la suscripción o el grupo de recursos después de unirse a él. Para cambiar cualquiera de estos elementos, quite el miembro y vuelva a unirlo con los nuevos valores.

  • Únase a un clúster de AKS como miembro de Azure Kubernetes Application Network mediante el comando az appnet member join con el parámetro --upgrade-mode establecido en FullyManaged o SelfManaged. En el ejemplo siguiente se muestra cómo unirse a un clúster miembro en modo SelfManaged.

    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

Comprobación de la conectividad del clúster miembro

  • Después de unir el clúster, puede comprobar la conectividad y ver los detalles del miembro mediante el az appnet member show comando .

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

    Por ejemplo, si se inscribe en modo totalmente administrado con el canal de versión Stable, la salida tendría el siguiente aspecto:

    {
  "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"
}

Enumeración de los miembros de Application Network de Azure Kubernetes

Varios clústeres pueden unirse a una instancia de Azure Kubernetes Application Network.

  • Enumere todos los miembros de una instancia de Azure Kubernetes Application Network mediante el az appnet member list comando .

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

Eliminación de recursos de Azure Kubernetes Application Network

Al eliminar un recurso de red de aplicaciones de Kubernetes de Azure se quitan automáticamente todos sus miembros, por lo que no es necesario quitar primero los miembros. Al quitar un miembro, ya sea individualmente o a través de esta cascada, no se elimina el clúster de AKS correspondiente.

Eliminación de un miembro de Application Network de Azure Kubernetes

Nota:

Antes de quitar un miembro, debe eliminar las cargas de trabajo del plano de datos tipo "ambient"; para ello, quite etiquetas de Istio que haya aplicado anteriormente, como istio.io/use-waypoint, istio.io/use-waypoint-namespace y istio.io/dataplane-mode, de los recursos.

  1. Quite un miembro de Azure Kubernetes Application Network mediante el az appnet member remove comando .

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

  2. Compruebe que el miembro se quitó mediante el comando az appnet member list.

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

Eliminación de un recurso de Azure Kubernetes Application Network

  • Elimine el recurso de Azure Kubernetes Application Network mediante el az appnet delete comando .

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

Contenido relacionado

Para más información sobre Azure Kubernetes Application Network, consulte los artículos siguientes:

  • Se actualizó por última vez el