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>
[-createAutoConfigContainers {true, false}]
[-offlineDownload]
[-offsiteTransferCompleted]
[-mode {minimum, full}]
[-stagingShare <String>]
[-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>]
[-concurrentDownloads <int>]
[-skipHostLimitChecks]
[-skipRemotingChecks]
[-skipValidationChecks]
[-insecure]
[-skipUpdates]
[-forceDnsReplication]
Deskripsi
Mengatur pengaturan konfigurasi untuk host Azure Kubernetes Service. Jika Anda menyebarkan pada kluster Azure Stack HCI simpul 2-4 atau kluster failover Pusat Data Windows Server 2019, Anda harus menentukan -workingDir parameter dan -cloudConfigLocation . Untuk Pusat Data Windows Server 2019 simpul tunggal, semua parameter bersifat opsional dan diatur ke nilai defaultnya. Namun, untuk kinerja optimal, sebaiknya gunakan penerapan kluster 2-4 node Azure Stack HCI.
Contoh
Untuk menyebarkan pada kluster simpul 2-4 dengan jaringan DHCP
PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254"
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Untuk menyebarkan dengan jaringan IP statis
PS C:\> $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\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Untuk menyebarkan dengan server proksi
PS C:\> $proxySettings = 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\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Parameter
-imageDir
Jalur ke direktori tempat AKS menyimpan gambar VHD-nya. Parameter ini diperlukan. 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: False
Position: Named
Default value: %systemdrive%\AksHciImageStore
Accept pipeline input: False
Accept wildcard characters: False
-workingDir
Direktori kerja untuk modul yang digunakan untuk menyimpan file kecil. Parameter ini diperlukan. Jalur harus menunjuk ke jalur penyimpanan bersama, seperti c:\ClusterStorage\Volume2\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 tempat agen cloud menyimpan konfigurasinya. Parameter ini diperlukan. Jalur harus menunjuk ke jalur penyimpanan bersama, seperti C:\ClusterStorage\Volume2\ImageStore, atau berbagi SMB seperti \\FileShare\ImageStore. Lokasi harus berada di berbagi yang sangat tersedia sehingga penyimpanan 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 New-AksHciNetworkSetting perintah .
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createAutoConfigContainers
Memungkinkan Anda menonaktifkan distribusi otomatis data VM pada volume bersama kluster (CSV). Untuk menonaktifkan distribusi otomatis, gunakan false sebagai argumen untuk parameter ini. Jika distribusi otomatis dinonaktifkan, hanya CSV yang Anda pilih yang imageDir digunakan. Nilai defaultnya adalah true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Memanggil unduhan offline selama Install-AksHci. Anda juga harus menjalankan Enable-AksHciOfflineDownload. Bendera ini digunakan bersama dengan -stagingShare parameter .
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-offsiteTransferCompleted
Mengatur penyebaran untuk menggunakan artefak yang diunduh di luar lokasi dan ditransfer ke server penyebaran selama Install-AksHci. Bendera ini digunakan bersama dengan -offlineDownload parameter dan -stagingShare .
-Mode
Mode unduhan yang ingin Anda gunakan untuk pengunduhan offline. Gunakan minimum jika Anda menginginkan gambar minimum untuk penyebaran hibrid AKS. Opsi ini mencakup gambar Linux yang diperlukan dan hanya gambar Kubernetes yang diperlukan. Gunakan full jika Anda ingin semua gambar untuk penyebaran hibrid AKS. Opsi ini mencakup semua gambar Linux dan Windows dan semua gambar Kubernetes yang didukung. Gunakan parameter ini bersama dengan -offlineDownload parameter . Default adalah full.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-stagingShare
Jalur lokal ke tempat Anda ingin gambar diunduh. Gunakan bersama dengan offlineDownload parameter .
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-nodeConfigLocation
Lokasi di mana agen simpul menyimpan konfigurasi mereka. Setiap simpul memiliki agen simpul, sehingga konfigurasinya lokal untuk simpul tersebut. 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 dapat masuk ke salah satu VM yang dibuat oleh penyebaran hibrid AKS. Jika Anda memiliki kunci umum SSH Anda sendiri, lewati lokasinya di sini. Jika tidak ada kunci yang disediakan, kami mencari satu di bawah %systemdrive%\akshci\.ssh\akshci_rsa.pub. Jika file tidak ada, pasangan kunci SSH dihasilkan di lokasi ini dan digunakan.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
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 berupa angka genap (yaitu, 00, 02, 04, 06...). Alamat MAC umum dapat terlihat seperti ini: 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. Default adalah None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Menentukan akhir 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 berupa angka genap (yaitu, 00, 02, 04, 06...). Byte pertama dari alamat yang diteruskan sebagai -macPoolEnd harus sama dengan byte pertama 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. Default adalah None.
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
Menyediakan prefiks IP/jaringan statis yang akan ditetapkan ke layanan MOC CloudAgent. Nilai ini harus disediakan menggunakan format CIDR; misalnya, 192.168.1.2/16. Anda mungkin ingin menentukan parameter ini untuk memastikan bahwa apa pun yang penting di jaringan selalu dapat diakses, karena alamat IP tidak berubah. Default adalah None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-versi
Versi hibrid AKS 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 tempat agen simpul harus mendengarkan, yang defaultnya adalah 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 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
Menentukan nama yang akan digunakan saat membuat agen cloud sebagai layanan generik dalam kluster. Parameter ini default ke nama unik dengan awalan ca- dan akhiran GUID. 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
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 agar skrip melompati pemeriksaan apa pun untuk mengonfirmasi bahwa memori dan ruang disk tersedia sebelum memungkinkan 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 agar skrip melompati pemeriksaan apa pun untuk mengonfirmasi kemampuan jarak jauh ke simpul 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 hibrid AKS, seperti agen cloud dan agen simpul, 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. Hal ini menyebabkan penyebaran menjadi lambat. Jika Anda mengalami masalah ini, Anda akan melihat bahwa Install-AksHci terjebak dalam perulangan. Untuk mengatasi masalah ini, cobalah untuk menggunakan bendera ini. Bendera -forceDnsReplication bukan perbaikan yang dijamin. Jika logika di balik bendera gagal, kesalahan disembunyikan, dan perintah berlanjut 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
-skipValidationChecks
Gunakan bendera ini jika Anda ingin melewati pemeriksaan validasi infrastruktur lingkungan dan input konfigurasi pengguna. Pemeriksaan ini menyoroti potensi masalah yang harus diatasi sebelum melanjutkan penginstalan. 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