Set-AksHciConfig
Sinopsis
Mengatur atau memperbarui pengaturan konfigurasi untuk host Azure Kubernetes Service.
Sintaks
Mengatur konfigurasi untuk host
Set-AksHciConfig -imageDir <String>
-workingDir <String>
-cloudConfigLocation <String>
-vnet <Virtual Network>
[-nodeConfigLocation <String>]
[-controlPlaneVmSize <VmSize>]
[-sshPublicKey <String>]
[-macPoolStart <String>]
[-macPoolEnd <String>]
[-proxySettings <ProxySettings>]
[-cloudServiceCidr <String>]
[-version <String>]
[-nodeAgentPort <int>]
[-nodeAgentAuthorizerPort <int>]
[-cloudAgentPort <int>]
[-cloudAgentAuthorizerPort <int>]
[-clusterRoleName <String>]
[-cloudLocation <String>]
[-skipHostLimitChecks]
[-skipRemotingChecks]
[-insecure]
[-skipUpdates]
[-forceDnsReplication]
Deskripsi
Mengatur pengaturan konfigurasi untuk host Azure Kubernetes Service. Jika menyebarkan pada simpul 2-8 di kluster Azure Stack HCI atau kluster failover Windows Server 2019, Anda harus menentukan parameter -workingDir dan -cloudConfigLocation. Untuk satu node Windows Server 2019 Datacenter, semua parameter bersifat opsional dan diatur ke nilai defaultnya.
Contoh
Untuk menyebarkan pada kluster simpul 2-8 dengan jaringan DHCP dan VLAN
$vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -vlanID 7
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Untuk menyebarkan pada kluster simpul 2-8 dengan jaringan DHCP tanpa VLAN
$vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254"
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Untuk menyebarkan dengan jaringan IP statis dan VLAN
$vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -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" -vlanID 7
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Untuk menyebarkan dengan jaringan IP statis tanpa VLAN
$vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -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"
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Untuk menyebarkan dengan server proksi
$proxySetting = New-AksHciProxySetting -name "corpProxy" -http http://contosoproxy:8080 -https https://contosoproxy:8443 -noProxy localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16 -credential $proxyCredential
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Untuk menyebarkan dengan layanan kluster agen cloud yang telah dikonfigurasi sebelumnya dan catatan DNS
Sebelum menjalankan contoh ini, Anda harus membuat layanan kluster generik di Active Directory dengan nama ca-cloudagent (atau nama pilihan Anda), tetapi panjangnya jangan melebihi 32 karakter. Anda juga perlu membuat rekaman DNS terkait yang menunjuk ke FQDN dari layanan kluster generik dengan alamat cloudservicecidr yang disediakan.
Penyebaran AKS di Azure Stack HCI dan Windows Server akan mencoba mencari lokasi clusterRoleName yang ditentukan di Active Directory sebelum melanjutkan penyebaran.
Catatan
Setelah AKS di Azure Stack HCI dan Windows Server disebarkan, informasi ini tidak dapat diubah.
$vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -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" -vlanID 7
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"
Parameter
-imageDir
Jalur ke direktori tempat Azure Kubernetes Service di Azure Stack HCI dan Windows Server akan menyimpan gambar VHD-nya. Parameter ini bersifat wajib. Jalur harus menunjuk ke jalur penyimpanan bersama seperti C:\ClusterStorage\Volume2\ImageStore, atau berbagi SMB misalnya \\FileShare\ImageStore.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: %systemdrive%\AksHciImageStore
Accept pipeline input: False
Accept wildcard characters: False
-workingDir
Ini adalah direktori kerja untuk modul yang akan dipakai untuk menyimpan file kecil. Parameter ini bersifat wajib. Jalur harus menunjuk ke jalur penyimpanan bersama seperti c:\ClusterStorage\Volume2\ImageStore, atau berbagi SMB seperti \\FileShare\ImageStore.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False
-cloudConfigLocation
Lokasi di mana agen cloud berada akan menyimpan konfigurasinya. Parameter ini bersifat wajib. Jalur harus menunjuk ke jalur penyimpanan bersama seperti C:\ClusterStorage\Volume2\ImageStore, atau berbagi SMB misalnya \\FileShare\ImageStore. Lokasi harus berada di bagian dengan ketersediaan tinggi sehingga penyimpanan akan selalu dapat diakses.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False
-vnet
Nama objek AksHciNetworkSetting yang dibuat dengan perintah New-AksHciNetworkSetting.
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-nodeConfigLocation
Lokasi di mana agen node berada akan menyimpan konfigurasi mereka. Setiap node memiliki agen node, sehingga konfigurasinya adalah lokal untuk node itu. Lokasi ini harus jalur lokal. Default %systemdrive%\programdata\wssdagent untuk semua penyebaran.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: %systemdrive%\programdata\wssdagent
Accept pipeline input: False
Accept wildcard characters: False
-controlPlaneVmSize
Ukuran mesin virtual untuk dibuat untuk bidang kontrol. Untuk mendapatkan daftar ukuran mesin virtual yang tersedia, jalankan Get-AksHciVmSize.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Standard_A4_V2
Accept pipeline input: False
Accept wildcard characters: False
-sshPublicKey
Jalur ke file kunci publik SSH. Dengan menggunakan kunci publik ini, Anda akan dapat masuk ke salah satu mesin virtual yang dibuat oleh penyebaran Azure Kubernetes Service di Azure Stack HCI dan Windows Server. Jika memiliki kunci publik SSH milik sendiri, maka Anda akan melewati lokasinya di sini. Jika tidak ada kunci yang disediakan, kami akan mencari di %systemdrive%\akshci\.ssh\akshci_rsa.pub. Jika file tidak ada, pasangan kunci SSH di lokasi di atas akan dihasilkan serta digunakan.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
Ini digunakan untuk menentukan awal alamat MAC dari kumpulan MAC yang ingin Anda gunakan untuk mesin virtual host Azure Kubernetes Service. Sintaks untuk alamat MAC mengharuskan bit yang paling tidak signifikan dari byte pertama harus selalu 0, dan byte pertama harus selalu angka genap (yaitu, 00, 02, 04, 06...). Alamat MAC yang khas dapat terlihat seperti: 02:1E:2B:78:00:00. Gunakan kumpulan MAC untuk penyebaran berumur panjang sehingga alamat MAC yang ditetapkan tetap konsisten. Kumpulan MAC berguna jika Anda memiliki persyaratan bahwa mesin virtual memiliki alamat MAC tertentu. Defaultnya adalah tidak ada.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Ini digunakan untuk menentukan akhir alamat MAC dari kumpulan MAC yang ingin Anda gunakan untuk mesin virtual host Azure Kubernetes Service. Sintaks untuk alamat MAC mensyaratkan bahwa bit yang paling tidak signifikan dari byte pertama harus 0, dan byte pertama harus angka genap (yaitu, 00, 02, 04, 06...). Byte pertama dari alamat yang diteruskan sebagai -macPoolEnd harus sama dengan byte pertama dari alamat yang diteruskan sebagai -macPoolStart. Gunakan kumpulan MAC untuk penyebaran berumur panjang sehingga alamat MAC yang ditetapkan tetap konsisten. Kumpulan MAC berguna jika Anda memiliki persyaratan bahwa mesin virtual memiliki alamat MAC tertentu. Defaultnya adalah tidak ada.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxySettings
Objek proksi dibuat menggunakan New-AksHciProxySetting.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-cloudServiceCidr
Dapat digunakan untuk menyediakan awalan IP/jaringan statis yang akan ditetapkan ke layanan MOC CloudAgent. Nilai ini harus diberikan menggunakan format CIDR. (Contoh 192.168.1.2/16). Anda mungkin ingin menentukan ini untuk memastikan bahwa hal penting apa pun di jaringan selalu dapat diakses karena alamat IP tidak akan berubah. Defaultnya adalah tidak ada.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-versi
Versi Azure Kubernetes Service di Azure Stack HCI dan Windows Server yang ingin Anda sebarkan. Defaultnya adalah versi yang terbaru. Kami tidak menyarankan pengubahan default.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentPort
Nomor port TCP/IP yang harus didengarkan oleh agen node, yang defaultnya ke 45000. Kami tidak menyarankan pengubahan default.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentAuthorizerPort
Nomor port TCP/IP yang harus digunakan agen node untuk port otorisasi mereka. Default ke 45001. Kami tidak menyarankan pengubahan default.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentPort
Nomor port TCP/IP yang harus didengarkan oleh agen cloud. Default ke 55000. Kami tidak menyarankan pengubahan default.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentAuthorizerPort
Nomor port TCP/IP yang harus digunakan agen cloud untuk port otorisasinya. Default ke 65000. Kami tidak menyarankan pengubahan default.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False
-clusterRoleName
Ini menentukan nama yang akan digunakan saat membuat agen cloud sebagai layanan umum dalam kluster. Ini default ke nama unik dengan awalan ca- dan akhiran guid (misalnya: "ca-9e6eb299-bc0b-4f00-9fd7-942843820c26"). Kami tidak menyarankan pengubahan default.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: A unique name with a prefix of ca- and a guid suffix
Accept pipeline input: False
Accept wildcard characters: False
-cloudLocation
Parameter ini memberikan nama lokasi Cloud kustom yang Dioperasikan Microsoft. Nama defaultnya adalah "MocLocation". Kami tidak menyarankan pengubahan default.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False
-skipHostLimitChecks
Meminta skrip untuk melewati pemeriksaan apa pun yang dilakukannya untuk mengonfirmasi bahwa memori dan ruang disk tersedia sebelum mengizinkan penyebaran dilanjutkan. Kami tidak merekomendasikan penggunaan pengaturan ini.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipRemotingChecks
Meminta skrip untuk melewati pemeriksaan apa pun yang dilakukannya untuk mengonfirmasi kemampuan pengendalian jarak jauh node lokal dan jarak jauh. Kami tidak merekomendasikan penggunaan pengaturan ini.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-insecure
Menyebarkan komponen Azure Kubernetes Service di Azure Stack HCI dan Windows Server, seperti agen cloud dan agen node, dalam mode tidak aman (tidak ada koneksi aman TLS). Kami tidak menyarankan penggunaan mode tidak aman di lingkungan produksi.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipUpdates
Gunakan bendera ini jika Anda ingin melewatkan pembaruan yang tersedia. Kami tidak merekomendasikan penggunaan pengaturan ini.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-forceDnsReplication
Replikasi DNS dapat memakan waktu hingga satu jam untuk beberapa sistem. Ini akan membuat penyebaran menjadi lambat. Jika mengalami masalah ini, Anda akan melihat bahwa Install-AksHci akan terjebak dalam perulangan. Untuk mengatasi masalah ini, cobalah untuk menggunakan bendera ini. Bendera -forceDnsReplication bukanlah perbaikan yang dijamin. Jika logika di balik bendera gagal, kesalahan akan disembunyikan, dan perintah akan diteruskan seolah-olah bendera tidak disediakan.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False