Memigrasikan cluster AKS Anda

Versi pendahulu cluster terpasang GKE dikenal sebagai cluster terpasang GKE (generasi sebelumnya). Dengan bermigrasi dari versi cluster terpasang GKE sebelumnya ke generasi saat ini, Anda akan mendapatkan akses ke fungsi ini, termasuk pengelolaan siklus proses dan pendaftaran Fleet. Migrasi adalah operasi satu arah: setelah Anda bermigrasi ke cluster terpasang GKE generasi saat ini, Anda tidak dapat kembali ke cluster terpasang GKE (generasi sebelumnya).

Kebijakan penomoran versi

Dokumen ini mengacu pada versi cluster terpasang GKE sebagai versi platform, untuk membedakannya dari versi Kubernetes. Cluster terpasang GKE menggunakan konvensi penomoran versi yang sama dengan GKE, misalnya, 1.21.5-gke.1. Saat melampirkan atau memperbarui cluster, Anda harus memilih versi platform yang versi minornya sama dengan atau satu tingkat di bawah versi Kubernetes cluster Anda. Misalnya, Anda dapat melampirkan cluster yang menjalankan Kubernetes v1.22.* dengan versi platform cluster terpasang GKE 1.21.* atau 1.22.*.

Hal ini memungkinkan Anda mengupgrade cluster ke versi minor berikutnya sebelum mengupgrade cluster terpasang GKE.

Memastikan Workload Identity diaktifkan

Cluster yang ada dari cluster terpasang GKE (generasi sebelumnya) harus mengaktifkan Workload Identity sebelum dimigrasikan ke cluster terpasang GKE generasi saat ini.

Untuk menentukan apakah WI diaktifkan, jalankan perintah berikut dan periksa output untuk mengetahui kolom Workload Identity:

gcloud container hub memberships describe MEMBERSHIP_NAME

Jika Workload Identity tidak diaktifkan, keanggotaan harus diperbarui untuk mengaktifkannya.

Perintah untuk memperbarui keanggotaan cluster Anda sedikit berbeda, bergantung pada apakah Anda telah mengonfigurasi cluster dengan penerbit OIDC pribadi default atau penerbit OIDC publik eksperimental. Pilih tab yang berlaku untuk cluster Anda:

Penerbit OIDC pribadi (default)

gcloud container hub memberships register MEMBERSHIP_NAME \
--context=KUBECONFIG_CONTEXT \
--kubeconfig=KUBECONFIG_PATH \
--enable-workload-identity \
--has-private-issuer

Ganti:

  • MEMBERSHIP_NAME: nama keanggotaan cluster Anda
  • KUBECONFIG_CONTEXT: konteks dalam kubeconfig untuk mengakses cluster AKS
  • KUBECONFIG_PATH: jalur ke file kubeconfig Anda

Penerbit OIDC publik

  • Ambil URL penerbit OIDC cluster Anda dengan perintah berikut:
  az aks show -n CLUSTER_NAME \
    -g RESOURCE_GROUP \
    --query "oidcIssuerProfile.issuerUrl" -otsv

Output dari perintah ini adalah URL penerbit OIDC Anda. Simpan nilai ini untuk digunakan nanti.

  • Perbarui keanggotaan:
gcloud container fleet memberships register MEMBERSHIP_NAME \
--context=KUBECONFIG_CONTEXT \
--kubeconfig=KUBECONFIG_PATH \
--enable-workload-identity \
--public-issuer-url=OIDC_URL

Ganti:

  • MEMBERSHIP_NAME: nama keanggotaan cluster Anda
  • KUBECONFIG_CONTEXT: konteks dalam kubeconfig untuk mengakses cluster AKS
  • KUBECONFIG_PATH: jalur ke kubeconfig Anda
  • OIDC_URL: URL OIDC yang diambil sebelumnya

Memigrasikan cluster Anda

Untuk memigrasikan cluster Anda dari cluster terpasang GKE (generasi sebelumnya) ke cluster terpasang GKE:

  1. Ekstrak konteks kubeconfig cluster Anda dan simpan dalam variabel lingkungan KUBECONFIG_CONTEXT:

    KUBECONFIG_CONTEXT=$(kubectl config current-context)

  2. Jalankan perintah berikut untuk memigrasikan cluster Anda ke cluster terpasang GKE generasi saat ini. Perintah ini mengekstrak detail relevan dari konfigurasi cluster Anda dan mendaftarkan cluster Anda ke Google Fleet Management, serta menginstal atau mengupgrade software yang diperlukan, seperti agen siklus proses, di cluster Anda.

    gcloud container attached clusters import \
  --location=GOOGLE_CLOUD_REGION \
  --fleet-membership=FLEET_MEMBERSHIP \
  --platform-version=PLATFORM_VERSION \
  --distribution=CLUSTER_DISTRIBUTION \
  --context=KUBECONFIG_CONTEXT \
  [--kubeconfig=KUBECONFIG_PATH]

    Ganti:

    • GOOGLE_CLOUD_REGION: lokasi tempat cluster Anda dikelola Google Cloud
    • FLEET_MEMBERSHIP: penentu keanggotaan yang sepenuhnya memenuhi syarat dari cluster terdaftar Anda (lihat di bawah)
    • PLATFORM_VERSION: versi cluster terpasang GKE yang Anda ingin migrasikan (contoh: v1.22.0-gke.1)
    • CLUSTER_DISTRIBUTION: jenis cluster - eks untuk Elastic Kubernetes Service AWS, aks untuk Azure Kubernetes Service, atau generic untuk distribusi lainnya
    • KUBECONFIG_CONTEXT: nama konteks di kubeconfig Anda untuk terhubung ke cluster Anda dengan
    • KUBECONFIG_PATH: lokasi file kubeconfig Anda. Jika tidak ditentukan, nilai defaultnya adalah ~/.kube/config

    Penentu keanggotaan adalah string yang secara unik mengidentifikasi cluster terpasang Anda dan memiliki bentuk projects/PROJECT_NUMBER/locations/global/memberships/MEMBERSHIP_ID, dengan

    • PROJECT_NUMBER adalah nomor project host Fleet Anda. Anda harus menentukan nomor project yang sama dengan nomor project yang saat ini dimiliki cluster Anda

    • MEMBERSHIP_ID: ini harus berupa ID keanggotaan fleet dari cluster Anda yang ada. Cluster terpasang GKE akan menggunakan nilai ini sebagai nama cluster Anda.

Dukungan Workload Identity Azure

Azure menawarkan dukungan WI dalam pratinjau publik. Mengaktifkan fitur ini akan mengubah URL penerbit OIDC cluster Anda. Jika Anda telah mendaftarkan cluster dengan URL OIDC sebelumnya, Anda tidak dapat mengupdate ke URL baru karena kolom tersebut saat ini tidak dapat diupdate.

Untuk mengatasi hal ini:

  1. Buat ulang cluster Anda dengan workload identity diaktifkan.
  2. Lampirkan cluster AKS Anda.
  3. Migrasikan workload Anda ke cluster baru.
  4. Hapus cluster lama.