Mulai menggunakan Azure Kubernetes Application Network untuk AKS (pratinjau)

Penting

Fitur pratinjau AKS tersedia atas dasar layanan mandiri dan pendaftaran sukarela. Pratinjau disediakan "apa adanya" dan "sebagaimana tersedia," dan pratinjau tersebut dikecualikan dari perjanjian tingkat layanan (SLA) serta garansi terbatas. Pratinjau AKS sebagian didukung oleh dukungan pelanggan berdasarkan upaya terbaik yang dapat dilakukan. Dengan demikian, fitur-fitur ini tidak dimaksudkan untuk penggunaan produksi. Untuk informasi lebih lanjut, lihat artikel dukungan berikut ini:

Artikel ini membantu Anda mulai menggunakan Azure Kubernetes Application Network untuk AKS. Ini menyediakan instruksi langkah demi langkah untuk membuat sumber daya Jaringan Aplikasi dan menghubungkan kluster AKS sebagai kluster anggota.

Prasyarat

Sebuah langganan Azure. Jika Anda tidak memilikinya, buat akun gratis.
Azure CLI versi 2.84.0 atau yang lebih baru. Periksa versi Anda menggunakan az --version perintah . Untuk menginstal atau memperbarui, lihat Menginstal Azure CLI.
Untuk kluster AKS yang ada dan baru, pastikan kluster tersebut memenuhi persyaratan berikut. Persyaratan ini divalidasi saat Anda bergabung dengan kluster sebagai anggota:
- Add-on mesh layanan berbasis Istio (ServiceMeshProfile) tidak diaktifkan. Kluster yang sudah mengaktifkan add-on Istio tidak dapat bergabung dengan Azure Jaringan Aplikasi Kubernetes.
- integrasi Microsoft Entra yang dikelola AKS diaktifkan.
- Pengeluar sertifikat OIDC diaktifkan.
- Penginstalan API Gateway Kubernetes Terkelola diaktifkan.
Verifikasi dukungan untuk kluster Kubernetes yang ada menggunakan kebijakan dukungan.

Atur variabel lingkungan

Atur variabel lingkungan berikut untuk sumber daya dan kluster Azure Kubernetes Application Network Anda. Anda dapat menggunakan kluster yang ada atau membuatnya di langkah selanjutnya sebelum menambahkannya ke Azure Kubernetes Application Network.

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>

Daftarkan fitur untuk pratinjau publik

Daftarkan fitur untuk Azure Kubernetes Application Network menggunakan az feature register perintah .

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

Tunggu hingga fitur didaftarkan. Anda dapat memeriksa status menggunakan az feature show perintah .
```
az feature show --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION
```
Bidang properties.state dalam output akan ditampilkan Registered ketika pendaftaran selesai.
Setelah fitur terdaftar, perbarui pendaftaran penyedia sumber daya Microsoft.AppLink menggunakan perintah az provider register.
```
az provider register --namespace Microsoft.AppLink --subscription $SUBSCRIPTION
```

Menginstal ekstensi AppNet CLI

Instal ekstensi AppNet CLI menggunakan az extension add perintah .
```
az extension add --name appnet-preview
```

Mengatur langganan aktif

Tetapkan langganan aktif ke langganan yang ingin Anda gunakan untuk Azure Kubernetes Application Network menggunakan perintah az account set.
```
az account set --subscription $SUBSCRIPTION 
```

Membuat kluster AKS

Nota

Kluster anggota tidak perlu berada dalam grup sumber daya terpisah. Mereka dapat berada dalam grup sumber daya yang sama dengan sumber daya Azure Kubernetes Application Network. Namun, semua kluster anggota harus berada di penyewa yang sama.

Jika Anda tidak memiliki kluster AKS yang ada untuk terhubung ke Azure Kubernetes Application Network, Anda perlu membuatnya. Azure Kubernetes Application Network memerlukan kluster AKS yang memenuhi persyaratan berikut:

Add-on mesh layanan berbasis Istio (ServiceMeshProfile) tidak diaktifkan.
Integrasi Microsoft Entra yang dikelola AKS diaktifkan.
Pengeluar sertifikat OIDC diaktifkan.
Penginstalan API Gateway Kubernetes Terkelola diaktifkan.

Jika Anda memiliki kluster yang sudah memenuhi persyaratan ini, Anda dapat melewati langkah ini.

Buat grup sumber daya untuk kluster AKS Anda menggunakan az group create perintah .
```
az group create --name $AKS_RG --location $LOCATION 
```
Buat kluster AKS dengan integrasi Microsoft Entra yang dikelola AKS, issuer OIDC, dan add-on Gateway API Kubernetes terkelola yang diaktifkan menggunakan perintah az aks create dengan flag --enable-oidc-issuer, --enable-aad, dan --enable-gateway-api. Jangan aktifkan add-on mesh layanan Istio (--enable-azure-service-mesh) pada kluster ini.
```
az aks create --name $CLUSTER_NAME --resource-group $AKS_RG --enable-oidc-issuer --enable-aad --enable-gateway-api
```

Membuat sumber daya Azure Kubernetes Application Network

Buat grup sumber daya untuk sumber daya Azure Kubernetes Application Network Anda menggunakan az group create perintah .
```
az group create --name $APPNET_RG --location $LOCATION 
```
Buat sumber daya Azure Kubernetes Application Network menggunakan az appnet create perintah .
```
az appnet create --resource-group $APPNET_RG --name $APPNET_NAME --location $LOCATION  --identity-type SystemAssigned
```
Proses pembuatan mungkin memakan waktu beberapa menit. Bidang properties.provisioningState output menunjukkan Succeeded jaringan aplikasi Azure Kubernetes yang berhasil dibuat.
Lihat sumber daya Azure Kubernetes Application Network Anda menggunakan az appnet show perintah .
```
az appnet show --resource-group $APPNET_RG --name $APPNET_NAME
```

Bergabung dengan kluster AKS sebagai anggota Azure Kubernetes Application Network

Saat bergabung dengan kluster anggota ke Azure Kubernetes Application Network, Anda dapat menentukan salah satu mode peningkatan berikut untuk kluster tersebut: dikelola sepenuhnya atau dikelola sendiri. Mode peningkatan menentukan bagaimana peningkatan versi minor Azure Kubernetes Application Network diterapkan ke kluster anggota. Jika Anda tidak menentukan mode peningkatan saat bergabung sebagai anggota, maka secara default mode tersebut adalah SelfManaged. Untuk informasi selengkapnya tentang mode peningkatan, lihat Mengonfigurasi peningkatan untuk anggota Azure Kubernetes Application Network.

Gabungkan kluster AKS sebagai anggota Azure Kubernetes Application Network menggunakan perintah az appnet member join dengan parameter --upgrade-mode yang diatur ke FullyManaged atau SelfManaged. Contoh berikut menunjukkan cara menggabungkan kluster anggota dalam SelfManaged mode:

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

Memverifikasi konektivitas kluster anggota

Setelah bergabung dengan kluster, Anda dapat memverifikasi konektivitas dan melihat detail anggota menggunakan az appnet member show perintah .

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

Misalnya, jika terdaftar dalam mode pengelolaan penuh dengan Stable saluran rilis, output akan terlihat seperti:

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

Mencantumkan anggota Jaringan Aplikasi Azure Kubernetes

Beberapa kluster dapat bergabung dengan Azure Kubernetes Application Network.

Daftarkan semua anggota Azure Kubernetes Application Network menggunakan perintah az appnet member list.
```
az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME --output table
```

Menghapus sumber daya Jaringan Aplikasi Azure Kubernetes

Anda harus menghapus semua anggota sebelum dapat menghapus sumber daya Azure Kubernetes Application Network. Menghapus anggota tidak menghapus kluster AKS yang sesuai.

Menghapus anggota Azure Kubernetes Application Network

Nota

Sebelum menghapus anggota, Anda harus menghapus beban kerja dari bidang data sekitar dengan menghapus label Istio yang sebelumnya Anda terapkan, seperti istio.io/use-waypoint, , istio.io/use-waypoint-namespacedan istio.io/dataplane-mode, dari sumber daya.

Hapus anggota dari Azure Kubernetes Application Network menggunakan az appnet member remove perintah .

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

Verifikasi bahwa anggota telah dihapus menggunakan az appnet member list perintah .
```
az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME 
```

Menghapus sumber daya Azure Kubernetes Application Network

Hapus sumber daya Azure Kubernetes Application Network menggunakan az appnet delete perintah .
```
az appnet delete --resource-group $APPNET_RG --appnet-name $APPNET_NAME
```

Untuk mempelajari selengkapnya tentang Azure Kubernetes Application Network, lihat artikel berikut:

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-05-20