Set-AksHciConfig
Riepilogo
Imposta o aggiorna le impostazioni di configurazione per l'host servizio Azure Kubernetes.
Sintassi
Impostare la configurazione per l'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]
Descrizione
Imposta le impostazioni di configurazione per l'host servizio Azure Kubernetes. Se si esegue la distribuzione in un cluster locale di Azure a 2-4 nodi o in un cluster di failover di Windows Server 2019 Datacenter, è necessario specificare i -workingDir parametri e -cloudConfigLocation . Per windows Server 2019 Datacenter a nodo singolo, tutti i parametri sono facoltativi e impostati su valori predefiniti. Tuttavia, per ottenere prestazioni ottimali, è consigliabile usare una distribuzione cluster locale di Azure a 2-4 nodi.
Esempi
Per eseguire la distribuzione in un cluster a 2-4 nodi con rete 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"
Per eseguire la distribuzione con rete IP statica
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"
Per eseguire la distribuzione con un server proxy
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"
Parametri
-imageDir
Percorso della directory in cui il servizio Azure Kubernetes archivia le immagini del disco rigido virtuale. Questo parametro è obbligatorio. Il percorso deve puntare a un percorso di archiviazione condiviso, ad esempio C:\ClusterStorage\Volume2\ImageStore, o a una condivisione SMB, ad esempio \\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
Directory di lavoro per il modulo da usare per l'archiviazione di file di piccole dimensioni. Questo parametro è obbligatorio. Il percorso deve puntare a un percorso di archiviazione condiviso, ad esempio 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
Percorso in cui l'agente cloud archivia la configurazione. Questo parametro è obbligatorio. Il percorso deve puntare a un percorso di archiviazione condiviso, ad esempio C:\ClusterStorage\Volume2\ImageStore, o a una condivisione SMB, \\FileShare\ImageStoread esempio . La posizione deve trovarsi in una condivisione a disponibilità elevata in modo che lo spazio di archiviazione sia sempre accessibile.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False
vnet-
Nome dell'oggetto AksHciNetworkSetting creato con il New-AksHciNetworkSetting comando .
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createAutoConfigContainers
Consente di disabilitare la distribuzione automatica dei dati delle macchine virtuali nei volumi condivisi del cluster . Per disabilitare la distribuzione automatica, usare false come argomento per questo parametro. Se la distribuzione automatica è disabilitata, viene usato solo il file CSV selezionato per imageDir . Il valore predefinito è true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Richiama il download offline durante Install-AksHci. È anche necessario eseguire Enable-AksHciOfflineDownload. Questo flag viene usato in combinazione con il -stagingShare parametro .
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-offsiteTransferCompleted
Imposta la distribuzione in modo da usare gli artefatti scaricati fuori sede e trasferiti nel server di distribuzione durante Install-AksHci. Questo flag viene usato in combinazione con il -offlineDownload parametro e -stagingShare .
-modo
Modalità di download da usare per il download offline. Usare minimum se si vogliono ottenere le immagini minime per la distribuzione ibrida del servizio Azure Kubernetes. Questa opzione include le immagini Linux necessarie e solo l'immagine Kubernetes necessaria. Usare full se si vogliono tutte le immagini per la distribuzione ibrida del servizio Azure Kubernetes. Questa opzione include tutte le immagini Linux e Windows e tutte le immagini Kubernetes supportate. Usare questo parametro in combinazione con il -offlineDownload parametro . Il valore predefinito è full.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-stagingShare
Percorso locale in cui si desidera scaricare le immagini. Usare in parallelo con il offlineDownload parametro .
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-nodeConfigLocation
Percorso in cui gli agenti del nodo archiviano la configurazione. Ogni nodo ha un agente del nodo, quindi la configurazione è locale per tale nodo. Questa posizione deve essere un percorso locale. L'impostazione predefinita è per %systemdrive%\programdata\wssdagent tutte le distribuzioni.
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
Dimensioni della macchina virtuale da creare per il piano di controllo. Per ottenere un elenco delle dimensioni di macchina virtuale disponibili, eseguire 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
Percorso di un file di chiave pubblica SSH. Usando questa chiave pubblica, è possibile accedere a una delle macchine virtuali create dalla distribuzione ibrida del servizio Azure Kubernetes. Se si ha la propria chiave pubblica SSH, passare la posizione qui. Se non viene fornita alcuna chiave, cerchiamo uno sotto %systemdrive%\akshci\.ssh\akshci_rsa.pub. Se il file non esiste, viene generata una coppia di chiavi SSH in questo percorso e usata.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
Specifica l'inizio dell'indirizzo MAC del pool MAC che si vuole usare per la macchina virtuale host servizio Azure Kubernetes. La sintassi per l'indirizzo MAC richiede che il bit meno significativo del primo byte sia sempre 0 e il primo byte deve essere sempre un numero pari (ovvero 00, 02, 04, 06...). Un indirizzo MAC tipico può essere simile al seguente: 02:1E:2B:78:00:00. Usare i pool MAC per distribuzioni di lunga durata in modo che gli indirizzi MAC assegnati siano coerenti. I pool MAC sono utili se si ha un requisito per cui le macchine virtuali hanno indirizzi MAC specifici. Il valore predefinito è None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Specifica la fine dell'indirizzo MAC del pool MAC che si vuole usare per la macchina virtuale host servizio Azure Kubernetes. La sintassi per l'indirizzo MAC richiede che il bit meno significativo del primo byte sia sempre 0 e il primo byte deve essere sempre un numero pari (ovvero 00, 02, 04, 06...). Il primo byte dell'indirizzo passato come -macPoolEnd deve essere uguale al primo byte dell'indirizzo passato come -macPoolStart. Usare i pool MAC per distribuzioni di lunga durata in modo che gli indirizzi MAC assegnati siano coerenti. I pool MAC sono utili se si ha un requisito per cui le macchine virtuali hanno indirizzi MAC specifici. Il valore predefinito è None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxySettings
Oggetto proxy creato con 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
Fornisce un prefisso ip/rete statico da assegnare al servizio CloudAgent MOC. Questo valore deve essere fornito usando il formato CIDR; ad esempio 192.168.1.2/16. È possibile specificare questo parametro per assicurarsi che qualsiasi elemento importante nella rete sia sempre accessibile, perché l'indirizzo IP non cambia. Il valore predefinito è None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-versione
Versione ibrida del servizio Azure Kubernetes che si vuole distribuire. Il valore predefinito è la versione più recente. Non è consigliabile modificare il valore predefinito.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentPort
Numero di porta TCP/IP in cui gli agenti del nodo devono essere in ascolto, che per impostazione predefinita è 45000. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentAuthorizerPort
Numero di porta TCP/IP che gli agenti del nodo devono usare per la porta di autorizzazione. Il valore predefinito è 45001. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentPort
Numero di porta TCP/IP su cui l'agente cloud deve rimanere in ascolto. Il valore predefinito è 55000. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentAuthorizerPort
Numero di porta TCP/IP che l'agente cloud deve usare per la porta di autorizzazione. Il valore predefinito è 65000. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False
-clusterRoleName
Specifica il nome da usare durante la creazione dell'agente cloud come servizio generico all'interno del cluster. Per impostazione predefinita, questo parametro è un nome univoco con un prefisso ca- e un suffisso GUID. Non è consigliabile modificare il valore predefinito.
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
Fornisce un nome personalizzato per la posizione del cloud gestito da Microsoft. Il nome predefinito è MocLocation. Non è consigliabile modificare il valore predefinito.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False
-skipHostLimitChecks
Richiede che lo script ignori eventuali controlli per verificare che la memoria e lo spazio su disco siano disponibili prima di consentire la continuazione della distribuzione. Non è consigliabile usare questa impostazione.
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
Richiede che lo script ignori eventuali controlli per confermare le funzionalità di comunicazione remota ai nodi locali e remoti. Non è consigliabile usare questa impostazione.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-malsicuro
Distribuisce componenti ibridi del servizio Azure Kubernetes, ad esempio agenti cloud e agenti del nodo, in modalità non sicura (senza connessioni protette TLS). Non è consigliabile usare la modalità non sicura negli ambienti di produzione.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipUpdates
Usare questo flag se si desidera ignorare gli aggiornamenti disponibili. Non è consigliabile usare questa impostazione.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-forceDnsReplication
La replica DNS può richiedere fino a un'ora in alcuni sistemi. Ciò fa sì che la distribuzione sia lenta. Se si verifica questo problema, si noterà che Install-AksHci è bloccato in un ciclo. Per superare questo problema, provare a usare questo flag. Il -forceDnsReplication flag non è una correzione garantita. Se la logica sottostante il flag ha esito negativo, l'errore viene nascosto e il comando procede come se il flag non fosse stato specificato.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipValidationChecks
Usare questo flag se si desidera ignorare i controlli di convalida dell'infrastruttura dell'ambiente e dell'input di configurazione utente. Questi controlli evidenziano i potenziali problemi da risolvere prima di procedere con l'installazione. Non è consigliabile usare questa impostazione.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False