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

Langkah berikutnya

Referensi AksHci PowerShell