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 melakukan pra-tahap objek layanan kluster dan catatan DNS di AKS yang diaktifkan oleh Azure Arc.
Sebelum Anda mulai
- Pastikan Anda memenuhi semua prasyarat dalam persyaratan sistem.
- Unduh dan instal modul AksHci PowerShell.
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). Selain itu, buat catatan DNS terkait yang menunjuk ke FQDN layanan kluster generik dengan alamat yang disediakan cloudservicecidr
. Untuk informasi selengkapnya tentang langkah-langkah dalam proses ini, lihat 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 komputer 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:
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 ditampilkan dalam contoh perintah ini untuk lingkungan Anda.
Langkah 4: Mengonfigurasi 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
Kustomisasi nilai yang diperlihatkan dalam perintah contoh ini untuk lingkungan Anda.
Langkah 5: Masuk ke Azure dan konfigurasikan pengaturan pendaftaran
Jalankan perintah PowerShell Set-AksHciRegistration berikut ini dengan langganan dan nama 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, Kubernetes - Jenis sumber daya Azure Arc dibuat di grup sumber daya yang diatur selama pendaftaran. Jangan hapus sumber daya ini, karena mewakili host Azure Kubernetes Service Anda. Anda dapat mengidentifikasi sumber daya dengan memeriksa bidang distribusinya untuk nilai tersebut aks_management
. Menghapus sumber daya ini menghasilkan penyebaran di luar kebijakan.