Menyebarkan host Azure Kubernetes Service dengan objek layanan kluster pra-tahap dan rekaman DNS menggunakan PowerShell

Berlaku untuk: AKS di Azure Stack HCI 22H2, AKS di Windows Server

Panduan cara penggunaan ini menjelaskan cara menggunakan PowerShell untuk mengonfigurasi penyebaran host AKS jika Anda memiliki objek layanan kluster pra-tahap dan rekaman DNS di AKS yang diaktifkan oleh Azure Arc.

Sebelum Anda mulai

Langkah 1: Siapkan Active Directory dan server DNS Anda untuk penyebaran

Jika Anda tidak dapat mengaktifkan pembaruan DNS dinamis di lingkungan DNS Anda untuk memungkinkan AKS diaktifkan oleh Arc untuk mendaftarkan nama kluster generik agen cloud di Direktori Aktif dan sistem DNS untuk penemuan, Anda harus membuat catatan masing-masing di Direktori Aktif dan DNS.

Buat layanan kluster generik di Direktori Aktif dengan nama ca-cloudagent (atau nama pilihan Anda yang tidak melebihi 32 karakter). Anda juga harus membuat catatan DNS terkait yang menunjuk ke FQDN layanan kluster generik dengan alamat yang disediakan cloudservicecidr . Detail selengkapnya tentang langkah-langkah dalam proses ini dapat ditemukan di dokumentasi Pengklusteran Failover.

Penyebaran AKS mencoba menemukan yang ditentukan clusterRoleName di Direktori Aktif sebelum melanjutkan penyebaran.

Catatan

Setelah AKS disebarkan, informasi ini tidak dapat diubah.

Langkah 2: Siapkan mesin Anda untuk penyebaran

Jalankan pemeriksaan pada setiap simpul fisik untuk melihat apakah semua persyaratan terpenuhi untuk menginstal AKS Arc. Buka PowerShell sebagai administrator dan jalankan perintah Initialize-AksHciNode berikut ini:

Initialize-AksHciNode

Langkah 3: Buat jaringan virtual

Untuk membuat jaringan virtual untuk simpul dalam penyebaran Anda untuk digunakan, buat variabel lingkungan dengan New-AksHciNetworkSetting perintah PowerShell. Variabel ini digunakan nanti untuk mengonfigurasi penyebaran yang menggunakan IP statis. Jika Anda ingin mengonfigurasi penyebaran AKS dengan DHCP, lihat New-AksHciNetworkSetting misalnya. Anda juga dapat meninjau beberapa konsep node jaringan.

#static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1" 

Catatan

Anda harus menyesuaikan nilai yang diberikan dalam perintah contoh ini untuk lingkungan Anda.

Langkah 4: Konfigurasikan penyebaran Anda dengan objek layanan kluster dan rekaman DNS yang telah ditahapkan sebelumnya

Atur pengaturan konfigurasi untuk host AKS menggunakan perintah Set-AksHciConfig . Anda harus menentukan parameter workingDir, cloudServiceCidr, cloudConfigLocation, dan clusterRoleName. Jika Anda ingin mengatur ulang detail konfigurasi, jalankan perintah lagi dengan parameter baru.

Konfigurasikan penyebaran Anda dengan perintah berikut:

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

Catatan

Sesuaikan nilai yang diberikan dalam perintah contoh ini untuk lingkungan Anda.

Langkah 5: Masuk ke Azure dan konfigurasikan pengaturan pendaftaran

Jalankan perintah PowerShell Set-AksHciRegistration berikut ini dengan nama langganan dan grup sumber daya Anda untuk masuk ke Azure. Anda harus memiliki langganan Azure, dan grup sumber daya Azure yang sudah ada di wilayah Azure US Timur, Asia Tenggara, atau Eropa Barat untuk melanjutkan:

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

Langkah 6: Mulai penyebaran baru

Setelah mengonfigurasi penyebaran, Anda harus memulainya. Memulai penyebaran menginstal agen/layanan AKS dan host AKS. Untuk memulai penerapan, jalankan perintah berikut:

Install-AksHci

Peringatan

Selama penginstalan host AKS, jenis sumber daya Kubernetes - Azure Arc dibuat di grup sumber daya yang diatur selama pendaftaran. Jangan dihapus karena sumber daya ini mewakili host Azure Kubernetes Service Anda. Anda dapat mengidentifikasi sumber daya dengan memeriksa bidang distribusinya untuk nilai aks_management. Menghapus sumber daya ini menghasilkan penyebaran di luar kebijakan.

Dalam panduan cara ini, Anda mempelajari cara menyiapkan host AKS menggunakan PowerShell jika Anda memiliki objek layanan kluster dan rekaman DNS yang telah ditahapkan sebelumnya.

Langkah berikutnya