AKS için Azure Kubernetes Application Network'i kullanmaya başlama (önizleme)

Önemli

AKS önizleme özellikleri self servis ve kabul temelinde kullanılabilir. Önizlemeler "olduğu gibi" ve "mevcut olduğu şekilde" sağlanmakta olup, hizmet seviyesi anlaşmalarına ve sınırlı garantilere dahil edilmemektedir. AKS önizlemeleri, müşteri desteği ekibi tarafından maksimum çaba gösterilerek kısmen ele alınmaktadır. Bu nedenle, bu özellikler üretim kullanımı için tasarlanmamıştır. Daha fazla bilgi için aşağıdaki destek makalelerine bakın:

Bu makale AKS için Azure Kubernetes Uygulama Ağı'yla çalışmaya başlamanıza yardımcı olur. Uygulama Ağı kaynağı oluşturmak ve bir AKS kümesini buna üye küme olarak bağlamak için adım adım yönergeler sağlar.

Önkoşullar

Ortam değişkenlerini belirleme

  • Azure Kubernetes Uygulama Ağı kaynağınız ve kümeniz için aşağıdaki ortam değişkenlerini ayarlayın. Azure Kubernetes Uygulama Ağınıza eklemeden önce var olan bir kümeyi kullanabilir veya sonraki bir adımda bir küme oluşturabilirsiniz.

    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>

Özelliği genel önizleme için kaydetme

  1. komutunu kullanarak az feature register Azure Kubernetes Uygulama Ağı özelliğini kaydedin.

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

  2. Özelliğin kaydedilmesini bekleyin. Komutunu kullanarak az feature show durumu de kontrol edebilirsiniz.

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

    Kayıt tamamlandığında çıkıştaki properties.state alanı Registered gösterecektir.

  3. Özellik kaydedildikten sonra az provider register komutunu kullanarak Microsoft.AppLink kaynak sağlayıcısının kaydını yenileyin.

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

AppNet CLI uzantısını yükleme

  • komutunu kullanarak AppNet CLI uzantısını az extension add yükleyin.

    az extension add --name appnet-preview

Etkin aboneliği ayarlama

  • komutunu kullanarak etkin aboneliği Azure Kubernetes Uygulama Ağı için kullanmak istediğiniz abonelik olarak az account set ayarlayın.

    az account set --subscription $SUBSCRIPTION

AKS kümesi oluşturma

Uyarı

Üye kümelerin ayrı kaynak gruplarında olması gerekmez. Azure Kubernetes Uygulama Ağı kaynağıyla aynı kaynak grubunda olabilirler. Ancak, tüm üye kümelerin aynı kiracıda olması gerekir.

Azure Kubernetes Uygulama Ağı'na bağlanmak için mevcut bir AKS kümeniz yoksa bir tane oluşturmanız gerekir. Azure Kubernetes Uygulama Ağı, aşağıdaki gereksinimleri karşılayan AKS kümeleri gerektirir:

Zaten bu gereksinimleri karşılayan bir kümeniz varsa bu adımı atlayabilirsiniz.

  1. komutunu kullanarak az group create AKS kümeniz için bir kaynak grubu oluşturun.

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

  2. az aks create, --enable-oidc-issuer ve --enable-aad bayraklarıyla --enable-gateway-api komutunu kullanarak AKS tarafından yönetilen Microsoft Entra tümleştirmesi, OIDC veren ve yönetilen Kubernetes Gateway API eklentisi etkinleştirilmiş bir AKS kümesi oluşturun. Bu kümede Istio hizmet ağı eklentisini () --enable-azure-service-mesh.

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

Azure Kubernetes Uygulama Ağı kaynağı oluşturma

  1. komutunu kullanarak az group create Azure Kubernetes Uygulama Ağı kaynağınız için bir kaynak grubu oluşturun.

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

  2. komutunu kullanarak az appnet create bir Azure Kubernetes Uygulama Ağı kaynağı oluşturun.

    Uyarı

    Bir Uygulama Ağı kaynağının konumunu, aboneliğini veya kaynak grubunu oluşturduktan sonra değiştiremezsiniz.

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

    Oluşturma işlemi birkaç dakika sürebilir. Çıktının properties.provisioningState alanı, başarıyla oluşturulmuş bir Azure Kubernetes Uygulama Ağı için Succeeded gösterir.

  3. komutunu kullanarak az appnet show Azure Kubernetes Uygulama Ağı kaynağınızı görüntüleyin.

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

Aks kümesine Azure Kubernetes Uygulama Ağı'nın üyesi olarak katılma

Bir üye kümeyi Azure Kubernetes Uygulama Ağı'na eklediğinizde, bu küme için aşağıdaki yükseltme modlarından birini belirtebilirsiniz: tam olarak yönetilen veya kendi kendine yönetilen. Yükseltme modu, Azure Kubernetes Uygulama Ağı'nın ikincil sürüm yükseltmelerinin üye kümeye nasıl uygulanacağını belirler. Üye katılımı sırasında bir yükseltme modu belirtmezseniz, varsayılan olarak SelfManagedolur. Yükseltme modları hakkında daha fazla bilgi için bkz. Azure Kubernetes Uygulama Ağı üyeleri için yükseltmeleri yapılandırma.

Uyarı

Üyenin üst Uygulama Ağı, konumu, aboneliği veya kaynak grubunu katıldıktan sonra değiştiremezsiniz. Bunlardan herhangi birini değiştirmek için üyeyi kaldırın ve yeni değerlerle yeniden birleşin.

  • Azure Kubernetes Uygulama Ağı'nın bir üyesi olarak bir AKS kümesine katılmak için, az appnet member join komutunu ve --upgrade-mode parametresini FullyManaged veya SelfManaged şeklinde ayarlayarak kullanın. Aşağıdaki örnekte, bir üye kümenin SelfManaged modda nasıl katılacağınız gösterilmektedir:

    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

Üye kümesi bağlantısını doğrulama

  • Kümeye katıldıktan sonra komutunu kullanarak az appnet member show bağlantıyı doğrulayabilir ve üye ayrıntılarını görüntüleyebilirsiniz.

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

    Örneğin, Stable yayın kanalında tam yönetilen moda kaydolunduğunda, çıktı şöyle olur:

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

Azure Kubernetes Uygulama Ağı üyelerini listeleme

Azure Kubernetes Uygulama Ağına birden çok küme katılabilir.

  • komutunu kullanarak Azure Kubernetes Uygulama Ağı'nın tüm üyelerini listeleyin az appnet member list .

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

Azure Kubernetes Uygulama Ağı kaynaklarını silme

Azure Kubernetes Uygulama Ağı kaynağının silinmesi tüm üyelerini otomatik olarak kaldırır, bu nedenle önce üyeleri kaldırmanız gerekmez. Bir üyenin tek tek ya da bu zincirleme işlem yoluyla kaldırılması, ilgili AKS kümesini silmez.

Azure Kubernetes Uygulama Ağı üyesini kaldırma

Uyarı

Bir üyeyi kaldırmadan önce, daha önce uyguladığınız , istio.io/use-waypointve istio.io/use-waypoint-namespacegibi istio.io/dataplane-modeIstio etiketlerini kaynaklardan kaldırarak iş yüklerinizi ortam veri düzleminden kaldırmanız gerekir.

  1. komutunu kullanarak Azure Kubernetes Uygulama Ağı'ndan bir üyeyi az appnet member remove kaldırın.

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

  2. komutunu kullanarak üyenin az appnet member list kaldırıldığını doğrulayın.

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

Azure Kubernetes Uygulama Ağı kaynağını silme

  • komutunu kullanarak az appnet delete Azure Kubernetes Uygulama Ağı kaynağını silin.

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

İlgili içerik

Azure Kubernetes Uygulama Ağı hakkında daha fazla bilgi edinmek için aşağıdaki makalelere bakın:

  • Son güncelleştirme: