Rychlý Start: nastavení hostitele služby Azure Kubernetes na Azure Stack HCI pomocí prostředí PowerShellQuickstart: Set up an Azure Kubernetes Service host on Azure Stack HCI using PowerShell

Platí pro: Azure Stack HCI, Windows Server 2019 DatacenterApplies to: Azure Stack HCI, Windows Server 2019 Datacenter

V tomto rychlém startu se dozvíte, jak nastavit hostitele služby Azure Kubernetes pomocí prostředí PowerShell.In this quickstart, you'll learn how to set up an Azure Kubernetes Service host using PowerShell. Pokud chcete místo toho použít Centrum pro správu systému Windows, přečtěte si téma nastavení v centru pro správu Windows.To instead use Windows Admin Center, see Set up with Windows Admin Center.

Než začneteBefore you begin

Ujistěte se, že máte jednu z následujících možností:Make sure you have one of the following:

  • cluster 2-4 Azure Stack HCL2-4 node Azure Stack HCI cluster
  • Cluster s podporou převzetí služeb při selhání datacenter Windows serveru 2019Windows Server 2019 Datacenter failover cluster
  • Windows Server 2019 Datacenter s jedním uzlemSingle node Windows Server 2019 Datacenter

Než začnete, ujistěte se, že jste splnili všechny požadavky na stránce požadavky na systém .Before getting started, make sure you have satisfied all the prerequisites on the system requirements page. Doporučujeme, abyste měli Azure Stack clusteru HCI v uzlu 2-4.We recommend having a 2-4 node Azure Stack HCI cluster. Pokud nemáte žádnou z výše uvedených informací, postupujte podle pokynů na stránce registrace rozhraní HCI Azure Stack.If you don't have any of the above, follow instructions on the Azure Stack HCI registration page.

Důležité

Při odebírání služby Azure Kubernetes na Azure Stack HCI si přečtěte téma Odebrání služby Azure Kubernetes na Azure Stack HCL a pečlivě postupujte podle pokynů.When removing Azure Kubernetes Service on Azure Stack HCI, see Remove Azure Kubernetes Service on Azure Stack HCI and carefully follow the instructions.

Krok 1: stažení a instalace modulu AksHci PowerShelluStep 1: Download and install the AksHci PowerShell module

Stáhněte si AKS-HCI-Public-Preview-Dec-2020 ze služby Azure Kubernetes na stránce registrace HCL Azure Stack.Download the AKS-HCI-Public-Preview-Dec-2020 from the Azure Kubernetes Service on Azure Stack HCI registration page. Soubor zip AksHci.Powershell.zip obsahuje modul PowerShellu.The zip file AksHci.Powershell.zip contains the PowerShell module.

Pokud jste dříve nainstalovali službu Azure Kubernetes Service na Azure Stack HCI pomocí prostředí PowerShell nebo centra pro správu Windows, existují dva toky instalace pro nový modul prostředí PowerShell:If you have previously installed Azure Kubernetes Service on Azure Stack HCI using PowerShell or Windows Admin Center, there are two installation flows for the new PowerShell module:

  • Proveďte čistou instalaci modulu PowerShell, takže začnete s čistým systémem a odebrali jste dříve nasazené úlohy.Perform a clean installation of the PowerShell module, so you start with a clean system and your previously deployed workloads are removed. Chcete-li provést čistou instalaci, použijte krok 1,1.To perform a clean installation, go to Step 1.1.
  • Pokud chcete zajistit, aby systém a úlohy byly na místě, upgradujte modul prostředí PowerShell.Upgrade the PowerShell module if you want to keep your system and workloads in place. Pokud chcete upgradovat modul PowerShellu, navštivte krok 1,2.To upgrade the PowerShell module, go to Step 1.2.

Krok 1,1: čistá instalace modulu PowerShellu pro AksHciStep 1.1: Clean install of the AksHci PowerShell module

Než budete pokračovat, spusťte následující příkaz.Run the following command before proceeding.

Uninstall-AksHci

Zavřete všechna okna PowerShellu.Close all PowerShell windows. Odstraňte všechny existující adresáře pro AksHci, AksHci. UI, Course a MSK8sDownloadAgent nacházející se v cestě %systemdrive%\program files\windowspowershell\modules .Delete any existing directories for AksHci, AksHci.UI, MOC, and MSK8sDownloadAgent located in the path %systemdrive%\program files\windowspowershell\modules. Po odstranění existujících adresářů můžete extrahovat obsah nového souboru ZIP.Once the existing directories are deleted, you can extract the contents of the new zip file. Přesvědčte se, zda je soubor zip extrahován ve správném umístění ( %systemdrive%\program files\windowspowershell\modules ).Make sure to extract the zip file in the correct location (%systemdrive%\program files\windowspowershell\modules). Pak spusťte následující příkazy.Then, run the following commands.

Import-Module AksHci

Zavřete všechna okna PowerShellu znovu a znovu otevřete relaci pro správu a pokračujte krokem 1,3 – ověřte upgradovaný modul PowerShellu.Close all PowerShell windows again and reopen an administrative session and proceed to Step 1.3 - Validate upgraded PowerShell module.

Krok 1,2: upgrade modulu PowerShellu pro AksHciStep 1.2: Upgrade the AksHci PowerShell module

Zavřete všechna okna PowerShellu.Close all PowerShell windows. Odstraňte všechny existující adresáře pro AksHci, AksHci. UI, Course a MSK8sDownloadAgent nacházející se v cestě %systemdrive%\program files\windowspowershell\modules .Delete any existing directories for AksHci, AksHci.UI, MOC, and MSK8sDownloadAgent located in the path %systemdrive%\program files\windowspowershell\modules. Po odebrání těchto adresářů můžete extrahovat obsah nového souboru ZIP.Once these directories are removed, you can extract the contents of the new zip file. Přesvědčte se, zda je soubor zip extrahován ve správném umístění ( %systemdrive%\program files\windowspowershell\modules ).Make sure to extract the zip file in the correct location (%systemdrive%\program files\windowspowershell\modules). Pak spusťte následující příkazy.Then, run the following commands.

Import-Module AksHci

Po spuštění výše uvedených příkazů zavřete všechna okna PowerShellu a znovu otevřete relaci pro správu, abyste ověřili upgrade modulu PowerShellu, jak je uvedeno níže, a pak Update-AksHci příkaz spusťte podle pokynů dále v dokumentu.After running the above commands, close all PowerShell windows and reopen an administrative session to validate PowerShell module upgrade as detailed below and then run the Update-AksHci command as instructed later in the document.

Krok 1,3: ověření aktualizovaného modulu PowerShelluStep 1.3: Validate upgraded PowerShell module

Zavřete všechna okna prostředí PowerShell a znovu otevřete novou relaci pro správu, abyste zkontrolovali, jestli máte nejnovější verzi modulu PowerShellu.Close all PowerShell windows and reopen a new administrative session to check if you have the latest version of the PowerShell module.

Get-Command -Module AksHci

VýkonemOutput:

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Alias           Initialize-AksHciNode                              0.2.12     AksHci
Function        Get-AksHciCluster                                  0.2.12     AksHci
Function        Get-AksHciConfig                                   0.2.12     AksHci
Function        Get-AksHciCredential                               0.2.12     AksHci
Function        Get-AksHciKubernetesVersion                        0.2.12     AksHci
Function        Get-AksHciLogs                                     0.2.12     AksHci
Function        Get-AksHciUpdates                                  0.2.12     AksHci
Function        Get-AksHciVersion                                  0.2.12     AksHci
Function        Get-AksHciVmSize                                   0.2.12     AksHci
Function        Install-AksHci                                     0.2.12     AksHci
Function        Install-AksHciAdAuth                               0.2.12     AksHci
Function        Install-AksHciArcOnboarding                        0.2.12     AksHci
Function        New-AksHciCluster                                  0.2.12     AksHci
Function        Remove-AksHciCluster                               0.2.12     AksHci
Function        Restart-AksHci                                     0.2.12     AksHci
Function        Set-AksHciClusterNodeCount                         0.2.12     AksHci
Function        Set-AksHciConfig                                   0.2.12     AksHci
Function        Uninstall-AksHci                                   0.2.12     AksHci
Function        Uninstall-AksHciAdAuth                             0.2.12     AksHci
Function        Uninstall-AksHciArcOnboarding                      0.2.12     AksHci
Function        Update-AksHci                                      0.2.12     AksHci
Function        Update-AksHciCluster                               0.2.12     AksHci

Krok 2: Příprava počítačů na nasazeníStep 2: Prepare your machine(s) for deployment

Spuštěním kontrol na každém fyzickém uzlu zjistíte, jestli jsou splněné všechny požadavky, aby se nainstalovala služba Azure Kubernetes na Azure Stack HCL.Run checks on every physical node to see if all the requirements are satisfied to install Azure Kubernetes Service on Azure Stack HCI.

Otevřete PowerShell jako správce a spusťte následující příkaz.Open PowerShell as an administrator and run the following command.

Initialize-AksHciNode

Po dokončení kontrol se zobrazí text "Hotovo" zobrazený zeleným textem.When the checks are finished, you'll see "Done" displayed in green text.

Krok 3: konfigurace nasazeníStep 3: Configure your deployment

Nastavte nastavení konfigurace pro hostitele služby Azure Kubernetes.Set the configuration settings for the Azure Kubernetes Service host. Pokud nasazujete v uzlu 2-4 Azure Stack clusteru HCI nebo v clusteru s podporou převzetí služeb při selhání s Windows serverem 2019 Datacenter, musíte zadat imageDir cloudConfigLocation parametry a.If you're deploying on a 2-4 node Azure Stack HCI cluster or a Windows Server 2019 Datacenter failover cluster, you must specify the imageDir and cloudConfigLocation parameters. Pro jeden uzel Windows Server 2019 Datacenter jsou všechny parametry volitelné a nastavené na výchozí hodnoty.For a single node Windows Server 2019 Datacenter, all parameters are optional and set to their default values. Pro zajištění optimálního výkonu však doporučujeme použít Azure Stack nasazení clusteru HCI v uzlu 2-4.However, for optimal performance, we recommend using a 2-4 node Azure Stack HCI cluster deployment.

Nakonfigurujte nasazení pomocí následujícího příkazu.Configure your deployment with the following command.

Set-AksHciConfig [-imageDir <String>]
                 [-cloudConfigLocation <String>]
                 [-nodeConfigLocation <String>]
                 [-vnetName <String>]
                 [-controlPlaneVmSize <VmSize>]
                 [-loadBalancerVmSize <VmSize>]
                 [-sshPublicKey <String>]
                 [-vipPoolStartIp <String>]
                 [-vipPoolEndIp <String>]
                 [-macPoolStart <String>]
                 [-macPoolEnd <String>]
                 [-vlanID <int>]
                 [-kvaLoadBalancerType {unstacked_haproxy, stacked_kube_vip}]
                 [-kvaControlPlaneEndpoint <String>]
                 [-proxyServerHTTP <String>]
                 [-proxyServerHTTPS <String>]
                 [-proxyServerNoProxy <String>]
                 [-proxyServerCredential <PSCredential>]
                 [-cloudServiceCidr <String>]
                 [-workingDir <String>]
                 [-version <String>]
                 [-vnetType <String>]
                 [-nodeAgentPort <int>]
                 [-nodeAgentAuthorizerPort <int>]
                 [-clusterRoleName <String>]
                 [-cloudLocation <String>]
                 [-skipHostLimitChecks]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]

PříkladExample

Postup nasazení v clusteru uzlu 2-4 se sítí DHCP:To deploy on a 2-4 node cluster with DHCP networking:

Set-AksHciConfig -imageDir c:\clusterstorage\volume1\Images -cloudConfigLocation c:\clusterstorage\volume1\Config

Nasazení s virtuálním fondem IP adres:To deploy with a virtual IP pool:

Set-AksHciConfig -imageDir c:\clusterstorage\volume1\Images -cloudConfigLocation c:\clusterstorage\volume1\Config -vipPoolStartIp 10.0.0.20 -vipPoolEndIp 10.0.0.80

Nasazení pomocí stacked_kube_vip Nástroje pro vyrovnávání zatížení:To deploy with stacked_kube_vip load balancer:

Set-AksHciConfig -imageDir c:\clusterstorage\volume1\Images -cloudConfigLocation c:\clusterstorage\volume1\Config -kvaLoadBalancerType stacked_kube_vip -kvaControlPlaneEndpoint 10.0.1.10

Nasazení pomocí proxy server:To deploy with a proxy server:

Set-AksHciConfig -imageDir c:\clusterstorage\volume1\Images -cloudConfigLocation c:\clusterstorage\volume1\Config -proxyServerHttp "http://proxy.contoso.com:8888" -proxyServerHttps "http://proxy.contoso.com:8888" -proxyServerNoProxy "localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16,10.231.110.0/24,10.68.237.0/24" -proxyServerCredential $credential

Volitelné parametryOptional parameters

-imageDir

Cesta k adresáři, do kterého služba Azure Kubernetes v Azure Stack HCL uloží své image VHD.The path to the directory where Azure Kubernetes Service on Azure Stack HCI will store its VHD images. Výchozí hodnota %systemdrive%\AksHciImageStore pro nasazení s jedním uzlem.Defaults to %systemdrive%\AksHciImageStore for single node deployments. U nasazení s více uzly je potřeba tento parametr zadat.For multi-node deployments, this parameter must be specified. Cesta musí ukazovat na cestu ke sdílenému úložišti, například  C:\ClusterStorage\Volume2\ImageStore   nebo na sdílenou složku SMB, jako je například  \\FileShare\ImageStore .The path must point to a shared storage path such as C:\ClusterStorage\Volume2\ImageStore or an SMB share such as \\FileShare\ImageStore.

-cloudConfigLocation

Umístění, do kterého bude cloudový agent ukládat svou konfiguraci.The location where the cloud agent will store its configuration. Výchozí hodnota %systemdrive%\wssdcloudagent pro nasazení s jedním uzlem.Defaults to %systemdrive%\wssdcloudagent for single node deployments. Umístění může být stejné jako cesta  -imageDir uvedená výše.The location can be the same as the path of -imageDir above.U nasazení s více uzly je potřeba tento parametr zadat. For *multi-node deployments, this parameter must be specified*. Cesta musí ukazovat na cestu ke sdílenému úložišti, například  C:\ClusterStorage\Volume2\ImageStore   nebo na sdílenou složku SMB, jako je například  \\FileShare\ImageStore .The path must point to a shared storage path such as C:\ClusterStorage\Volume2\ImageStore or an SMB share such as \\FileShare\ImageStore. Umístění musí být na vysoce dostupné sdílené složce, aby úložiště bylo vždycky dostupné.The location needs to be on a highly available share so that the storage will always be accessible.

-nodeConfigLocation

Umístění, kam budou v agentech zaukládána konfigurace.The location where the node agents will store their configuration. Každý uzel má agenta uzlu, takže jeho konfigurace je místní.Every node has a node agent, so its configuration is local to it. Toto umístění musí být místní cesta.This location must be a local path. Výchozí hodnota %systemdrive%\programdata\wssdagent pro všechna nasazení.Defaults to %systemdrive%\programdata\wssdagent for all deployments.

-vnetName

Název virtuálního přepínače, ke kterému se mají připojit virtuální počítačeThe name of the virtual switch to connect the virtual machines to. Pokud již máte na hostiteli externí přepínač, měli byste sem předat název tohoto přepínače.If you already have an external switch on the host, you should pass the name of the switch here. Přepínač bude vytvořen, pokud neexistuje.The switch will be created if it does not exist.Použije se výchozí název external. Defaults to “External” name.

-controlPlaneVmSize

Velikost virtuálního počítače, který se má vytvořit pro plochu ovládacího prvku.The size of the VM to create for the control plane. Pokud chcete získat seznam dostupných velikostí virtuálních počítačů, spusťte příkaz Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-loadBalancerVmSize

Velikost virtuálního počítače, který se má vytvořit pro virtuální počítače s Load BalancerThe size of the VM to create for the Load Balancer VMs. Pokud chcete získat seznam dostupných velikostí virtuálních počítačů, spusťte příkaz Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-sshPublicKey

Cesta k souboru veřejného klíče SSHPath to an SSH public key file. Pomocí tohoto veřejného klíče se budete moct přihlásit ke každému virtuálnímu počítači vytvořenému službou Azure Kubernetes při nasazení Azure Stack HCI.Using this public key, you will be able to log in to any of the VMs created by the Azure Kubernetes Service on Azure Stack HCI deployment. Pokud máte vlastní veřejný klíč SSH, předáte sem jeho umístění.If you have your own SSH public key, you will pass its location here. Pokud není zadaný žádný klíč, budeme ho podíváme za %systemdrive%\akshci\.ssh\akshci_rsa.pub .If no key is provided, we will look for one under %systemdrive%\akshci\.ssh\akshci_rsa.pub. Pokud soubor neexistuje, vygeneruje se a použije pár klíčů SSH ve výše uvedeném umístění.If the file does not exist, an SSH key pair in the above location will be generated and used.

-vipPoolStartIp

Při použití fondů VIP pro vaše nasazení tento parametr určuje spuštění sítě ve fondu.When using VIP pools for your deployment, this parameter specifies the network start of the pool. Fondy VIP byste měli použít pro dlouhotrvající nasazení, aby se zaručilo, že fond IP adres zůstane konzistentní.You should use VIP pools for long-lived deployments to guarantee that a pool of IP addresses remain consistent. To je užitečné v případě, že máte úlohy, které vždycky potřebují být dosažitelné.This is useful when you have workloads that always need to be reachable. Výchozí hodnota je none.Default is none.

-vipPoolEndIp

Při použití fondů VIP pro vaše nasazení tento parametr určuje síťový konec fondu.When using VIP pools for your deployment, this parameter specifies the network end of the pool. Fondy VIP byste měli použít pro dlouhotrvající nasazení, aby se zaručilo, že fond IP adres zůstane konzistentní.You should use VIP pools for long-lived deployments to guarantee that a pool of IP addresses remain consistent. To je užitečné v případě, že máte úlohy, které vždycky potřebují být dosažitelné.This is useful when you have workloads that always need to be reachable. Výchozí hodnota je none.Default is none.

-macPoolStart

Tato možnost slouží k určení začátku adresy MAC pro fond adres MAC, který chcete použít pro virtuální počítač hostitele služby Azure Kubernetes.This is used to specify the start of the MAC address of the MAC pool that you wish to use for the Azure Kubernetes Service host VM. Syntaxe adresy MAC vyžaduje, aby nejméně významný bit prvního bajtu měl vždy hodnotu 0 a první bajt by měl být vždy sudým číslem (tj. 00, 02, 04, 06...). Typická adresa MAC může vypadat takto: 02:1E: 2B: 78:00:00.The syntax for the MAC address requires that the least significant bit of the first byte should always be 0, and the first byte should always be an even number (that is, 00, 02, 04, 06...). A typical MAC address can look like: 02:1E:2B:78:00:00. Používejte fondy adres MAC pro dlouhodobá nasazení, aby se přiřazené adresy MAC shodovaly.Use MAC pools for long-lived deployments so that MAC addresses assigned are consistent. To je užitečné v případě, že máte požadavek, aby virtuální počítače měly konkrétní adresy MAC.This is useful if you have a requirement that the VMs have specific MAC addresses. Výchozí hodnota je none.Default is none.

-macPoolEnd

Tato možnost slouží k určení konce adresy MAC pro fond adres MAC, který chcete použít pro virtuální počítač hostitele služby Azure Kubernetes.This is used to specify the end of the MAC address of the MAC pool that you wish to use for the Azure Kubernetes Service host VM. Syntaxe adresy MAC vyžaduje, aby nejméně významný bit prvního bajtu měl vždy hodnotu 0 a první bajt by měl být vždy sudým číslem (tj. 00, 02, 04, 06...). První bajt předané adresy jako -macPoolEnd by měl být stejný jako první bajt adresy předané jako -macPoolStart .The syntax for the MAC address requires that the least significant bit of the first byte should always be 0, and the first byte should always be an even number (that is, 00, 02, 04, 06...). The first byte of the address passed as the -macPoolEnd should be the same as the first byte of the address passed as the -macPoolStart. Používejte fondy adres MAC pro dlouhodobá nasazení, aby se přiřazené adresy MAC shodovaly.Use MAC pools for long-lived deployments so that MAC addresses assigned are consistent. To je užitečné v případě, že máte požadavek, aby virtuální počítače měly konkrétní adresy MAC.This is useful if you have a requirement that the VMs have specific MAC addresses. Výchozí hodnota je none.Default is none.

-vlanID

Dá se použít k zadání ID sítě VLAN.This can be used to specify a network VLAN ID. Síťové adaptéry hostitele služby Azure Kubernetes a síťové adaptéry Kubernetes clusteru se označí pomocí zadaného ID sítě VLAN.Azure Kubernetes Service host and Kubernetes cluster VM network adapters will be tagged with the provided VLAN ID. Tato možnost by se měla použít, pokud existuje konkrétní ID sítě VLAN, které je potřeba označit a získat tak správné připojení.This should be used if there is a specific VLAN ID that needs to be tagged to get the right connectivity. Výchozí hodnota je none.Default is none.

-kvaLoadBalancerType

To má buď unstacked_haproxy nebo stacked_kube_vip .This takes in either unstacked_haproxy or stacked_kube_vip. unstacked_haproxy je výchozí, kde se jako koncový bod serveru rozhraní API hostitele služby Azure Kubernetes nasadí samostatný virtuální počítač nástroje pro vyrovnávání zatížení s HAProxy.unstacked_haproxy is the default where a separate load balancer VM is deployed with HAProxy as the Azure Kubernetes Service host's API server endpoint. stacked_kube_vipje Kubevipřešení pro vyrovnávání zatížení pro hostitele služby Azure Kubernetes.stacked_kube_vipis a load balancer solution, Kubevip, for the Azure Kubernetes Service host. Umožňuje zadat statickou IP adresu v hostiteli jako plovoucí IP adresu napříč uzly řídicí roviny, aby byl Server API vysoce dostupný prostřednictvím IP adresy.It allows you to specify a static IP address in the host as a floating IP across the control plane nodes to keep the API server highly available through the IP. Pokud zvolíte tuto možnost, musíte v parametru zadat statickou IP adresu kvaControlPlaneEndpoint a nasazený virtuální počítač nástroje pro vyrovnávání zatížení není nasazený.If this option is chosen, you must specify the static IP address in the kvaControlPlaneEndpoint parameter, and no separate load balancer VM is deployed.

stacked_kube_vip vyžaduje IP adresu a více prostředků je uživatelsky přívětivé při ukládání paměti, procesoru a času nasazení.stacked_kube_vip requires an IP address and is more resource friendly by saving memory, CPU, and deployment time. Pokud nemáte IP adresu, která se má použít jako plovoucí IP adresa, měli byste použít unstacked_haproxy .If you do not have an IP address to use as the floating IP, you should use unstacked_haproxy. Druhá možnost vyžaduje virtuální počítač nástroje pro vyrovnávání zatížení.The latter option requires a load balancer VM.

-kvaControlPlaneEndpoint

Tato možnost určuje statickou IP adresu, která se použije jako adresa serveru rozhraní API hostitele služby Azure Kubernetes, pokud kvaLoadBalancerType je parametr nastavený na hodnotu stacked_kube_vip .This specifies the static IP address to use as the Azure Kubernetes Service Host API server address when the kvaLoadBalancerType parameter is set to stacked_kube_vip. stacked_kube_vipJe-li použit, je nutné zadat tento parametr.If stacked_kube_vip is used, this parameter must be specified.

-proxyServerHTTP

To poskytuje proxy server identifikátor URI, který by měl být používán všemi součástmi, které vyžadují přístup ke koncovým bodům HTTP.This provides a proxy server URI that should be used by all components that need to reach HTTP endpoints. Formát identifikátoru URI zahrnuje schéma identifikátoru URI, adresu serveru a port (tj https://server.com:8888) ..The URI format includes the URI schema, server address, and port (that is, https://server.com:8888). Výchozí hodnota je none.Default is none.

-proxyServerHTTPS

To poskytuje proxy server identifikátor URI, který by měl být používán všemi součástmi, které vyžadují přístup k koncovým bodům HTTPS.This provides a proxy server URI that should be used by all components that need to reach HTTPS endpoints. Formát identifikátoru URI zahrnuje schéma identifikátoru URI, adresu serveru a port (tj https://server.com:8888) ..The URI format includes the URI schema, server address, and port (that is, https://server.com:8888). Výchozí hodnota je none.Default is none.

-proxyServerNoProxy

Jedná se o řetězec adres oddělených čárkami, který bude z proxy serveru vyloučen.This is a comma-delimited string of addresses that will be exempt from the proxy. Výchozí hodnota je localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16.Default value is localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16. Tato operace vylučuje provoz místního hostitele (localhost, 127.0.0.1), interní provoz služby Kubernetes (. svc), Kubernetes (10.96.0.0/12) a Kubernetes POD CIDR (10.244.0.0/16) z proxy server.This excludes the localhost traffic (localhost, 127.0.0.1), internal Kubernetes service traffic (.svc), the Kubernetes Service CIDR (10.96.0.0/12), and the Kubernetes POD CIDR (10.244.0.0/16) from the proxy server. Tento parametr můžete použít k přidání více rozsahů podsítí nebo výjimek názvů.You can use this parameter to add more subnet ranges or name exemptions. Nastavení tohoto parametru je velmi důležité, protože pokud není správně nakonfigurovaný, může se stát, že se interní provoz clusteru Kubernetes neočekávaně směruje do vašeho proxy serveru. To může způsobit různé chyby v síťové komunikaci.The settings for this parameter are very important because, if it's not correctly configured, you may unexpectedly route internal Kubernetes cluster traffic to your proxy. This can cause various failures in network communication.

-proxyServerCredential

Tím se zobrazí uživatelské jméno a heslo pro ověření na proxy serverech HTTP/HTTPS.This provides the username and password to authenticate to your HTTP/HTTPS proxy servers. Můžete použít Get-Credential k vygenerování PSCredential objektu, který se předává tomuto parametru.You can use Get-Credential to generate a PSCredential object to pass to this parameter. Výchozí hodnota je none.Default is none.

-cloudServiceCidr

Dá se použít k zadání předpony statické IP adresy nebo sítě, která se má přiřadit ke službě Course CloudAgent.This can be used to provide a static IP/network prefix to be assigned to the MOC CloudAgent service. Tato hodnota by měla být poskytnuta pomocí formátu CIDR.This value should be provided using the CIDR format. (Příklad: 192.168.1.2/16).(Example: 192.168.1.2/16). Možná budete chtít tuto skutečnost zadat, aby se zajistilo, že všechny důležité informace o síti budou vždycky dostupné, protože se IP adresa nemění.You may want to specify this to ensure that anything important on the network is always accessible because the IP address will not change. Výchozí hodnota je none.Default is none.

-workingDir

Toto je pracovní adresář, který modul používá k ukládání malých souborů.This is a working directory for the module to use for storing small files. %PROGRAMFILES%\AksHci   U většiny nasazení je výchozí hodnota a neměla by se měnit.Defaults to %PROGRAMFILES%\AksHci and should not be changed for most deployments.Nedoporučujeme měnit výchozí nastavení. We do not recommend changing the default.

-version

Verze služby Azure Kubernetes na Azure Stack HCL, kterou chcete nasadit.The version of Azure Kubernetes Service on Azure Stack HCI that you want to deploy. Výchozí hodnota je nejnovější verze.The default is the latest version. Nedoporučujeme měnit výchozí nastavení.We do not recommend changing the default.

-vnetType

Typ virtuálního přepínače, ke kterému se chcete připojit nebo kterou chcete vytvořit.The type of virtual switch to connect to or create. Toto je výchozí nastavení typu přepínače "externí".This defaults to “External” switch type. Nedoporučujeme měnit výchozí nastavení.We do not recommend changing the default.

-nodeAgentPort

Číslo portu TCP/IP, na kterém mají agenti naslouchat.The TCP/IP port number that node agents should listen on. Výchozí hodnota je 45000.Defaults to 45000.Nedoporučujeme měnit výchozí nastavení. We do not recommend changing the default.

-nodeAgentAuthorizerPort

Číslo portu TCP/IP, které agenti uzlu použijí pro svůj autorizační port.The TCP/IP port number that node agents should use for their authorization port. Výchozí hodnota je 45001.Defaults to 45001. Nedoporučujeme měnit výchozí nastavení.We do not recommend changing the default.

-clusterRoleName

Určuje název, který se použije při vytváření cloudového agenta jako generické služby v rámci clusteru.This specifies the name to use when creating cloud agent as a generic service within the cluster. Ve výchozím nastavení se jedná o jedinečný název s předponou CA – a příponou GUID (například CA-9e6eb299-bc0b-4f00-9fd7-942843820c26).This defaults to a unique name with a prefix of ca- and a guid suffix (for example: “ca-9e6eb299-bc0b-4f00-9fd7-942843820c26”). Nedoporučujeme měnit výchozí nastavení.We do not recommend changing the default.

-cloudLocation

Tento parametr poskytuje vlastní název Microsoft provozovaného cloudového umístění.This parameter provides a custom Microsoft Operated Cloud location name. Výchozí název je "MocLocation".The default name is "MocLocation". Nedoporučujeme měnit výchozí nastavení.We do not recommend changing the default.

-skipHostLimitChecks

Vyžádá skript, aby přeskočil všechny kontroly, které potvrdí, že je k dispozici paměť a místo na disku, než umožní nasazení pokračovat.Requests the script to skip any checks it does to confirm memory and disk space is available before allowing the deployment to proceed. Toto nastavení nedoporučujeme používat.We do not recommend using this setting.

-insecure

Nasadí službu Azure Kubernetes na Azure Stack komponenty HCI, jako je Cloud agent a agenti (s) v nezabezpečeném režimu (bez zabezpečených připojení TLS).Deploys Azure Kubernetes Service on Azure Stack HCI components such as cloud agent and node agent(s) in insecure mode (no TLS secured connections).Nedoporučujeme používat v produkčním prostředí nezabezpečený režim.  We do not recommend using insecure mode in production environments.

-skipUpdates

Tento příznak použijte, pokud chcete přeskočit všechny dostupné aktualizace.Use this flag if you want to skip any updates available. Toto nastavení nedoporučujeme používat.We do not recommend using this setting.

-forceDnsReplication

Replikace DNS může v některých systémech trvat až hodinu.DNS replication can take up to an hour on some systems. Tím dojde k pomalému nasazení.This will cause the deployment to be slow. Pokud dojde k tomuto problému, uvidíte, že Install-AksHci zablokování ve smyčce.If you hit this issue, you'll see that the Install-AksHci will be stuck in a loop. Pokud chcete tento problém obdržet, zkuste použít tento příznak.To get past this issue, try to use this flag. -forceDnsReplicationPříznak není zaručená oprava.The -forceDnsReplication flag is not a guaranteed fix. Pokud logika za příznakem selže, bude chyba skrytá a příkaz bude proveden, jako by nebyl poskytnut příznak.If the logic behind the flag fails, the error will be hidden, and the command will carry on as if the flag was not provided.

Resetování služby Azure Kubernetes v Azure Stack konfiguraci rozhraní HCIReset the Azure Kubernetes Service on Azure Stack HCI configuration

Pokud chcete resetovat službu Azure Kubernetes na Azure Stack konfiguraci HCI, spusťte následující příkazy.To reset the Azure Kubernetes Service on Azure Stack HCI configuration, run the following commands. Spuštění tohoto příkazu na vlastní nastavení obnoví výchozí hodnoty konfigurace.Running this command on its own will reset the configuration to default values.

Set-AksHciConfig

Krok 4: zahájení nového nasazeníStep 4: Start a new deployment

Po dokončení konfigurace nasazení musíte spustit nasazení.After you've configured your deployment, you must start deployment. Tím se nainstaluje služba Azure Kubernetes na Azure Stack agenti a služby HCI a hostitele služby Azure Kubernetes.This will install the Azure Kubernetes Service on Azure Stack HCI agents/services and the Azure Kubernetes Service host.

Nasazení zahájíte spuštěním následujícího příkazu.To begin deployment, run the following command.

Install-AksHci

Ověření nasazeného hostitele služby Azure KubernetesVerify your deployed Azure Kubernetes Service host

Pokud chcete zajistit, aby byl nasazený hostitel služby Azure Kubernetes, spusťte následující příkaz.To ensure that your Azure Kubernetes Service host was deployed, run the following command. Po nasazení budete moci získat clustery s Kubernetes pomocí stejného příkazu.You will also be able to get Kubernetes clusters using the same command after deploying them.

Get-AksHciCluster

VýkonemOutput:


Name            : clustergroup-management
Version         : v1.18.8
Control Planes  : 1
Linux Workers   : 0
Windows Workers : 0
Phase           : provisioned
Ready           : True

Krok 5: přístup ke svým clusterům pomocí kubectlStep 5: Access your clusters using kubectl

Pokud chcete získat přístup k hostiteli služby Azure Kubernetes nebo ke clusteru Kubernetes pomocí kubectl, spusťte následující příkaz.To access your Azure Kubernetes Service host or Kubernetes cluster using kubectl, run the following command. Tato akce použije zadaný soubor kubeconfig clusteru jako výchozí soubor kubeconfig pro kubectl.This will use the specified cluster's kubeconfig file as the default kubeconfig file for kubectl.

Get-AksHciCredential -clusterName <String>
                     [-outputLocation <String>]

PříkladExample

Get-AksHciCredential -clusterName clustergroup-management

Povinné parametryRequired Parameters

clusterName

Název clusteru.The name of the cluster.

Volitelné parametryOptional Parameters

outputLocation

Umístění, kam chcete stáhnout kubeconfig.The location where you want the kubeconfig downloaded. Výchozí je %USERPROFILE%\.kube.Default is %USERPROFILE%\.kube.

Získání protokolůGet logs

Pokud chcete získat protokoly ze všech lusků, spusťte následující příkaz.To get logs from your all your pods, run the following command. Tento příkaz vytvoří výstupní složku zip s názvem akshcilogs v cestě C:\wssd\akshcilogs .This command will create an output zipped folder called akshcilogs in the path C:\wssd\akshcilogs.

Get-AksHciLogs

Aktualizace na nejnovější verzi služby Azure Kubernetes ve Azure Stack HCIUpdate to the latest version of Azure Kubernetes Service on Azure Stack HCI

Pokud chcete aktualizovat na nejnovější verzi služby Azure Kubernetes v Azure Stack HCI, spusťte následující příkaz.To update to the latest version of Azure Kubernetes Service on Azure Stack HCI, run the following command. Příkaz Update funguje jenom v případě, že máte nainstalovanou verzi nástroje OCT.The update command only works if you have installed the Oct release. Nebude fungovat pro vydání starší verze než v říjnu.It will not work for releases older than the October release. Tento příkaz Update aktualizuje hostitele služby Azure Kubernetes a místní Microsoft provozovanou cloudovou platformu.This update command updates the Azure Kubernetes Service host and the on-premise Microsoft operated cloud platform. V této verzi Preview je verze Kubernetes a verze operačního systému AKS stále stejná.For this preview release, the Kubernetes version and AKS host OS version still remain the same. Tento příkaz neupgraduje žádné existující clustery úloh.This command does not upgrade any existing workload clusters. Nové clustery úloh vytvořené po aktualizaci hostitele AKS se budou lišit od stávajících clusterů úloh v souvislosti s verzí operačního systému Windows node a verzí Kubernetes.New workload clusters created after updating the AKS host will differ from existing workload clusters in terms of Windows node OS version and Kubernetes version.

Update-AksHci

Doporučujeme aktualizovat clustery úloh hned po aktualizaci clusteru pro správu, aby nedocházelo ke spouštění nepodporovaných verzí operačního systému Windows Server v clusterech Kubernetes s uzly Windows.We recommend updating workload clusters immediately after updating the management cluster to prevent running unsupported Windows Server OS versions in your Kubernetes clusters with Windows nodes. Pokud chcete aktualizovat svůj cluster úloh, přejděte na web aktualizovat cluster úloh.To update your workload cluster, visit update your workload cluster.

Restartovat službu Azure Kubernetes v Azure Stack HCLRestart Azure Kubernetes Service on Azure Stack HCI

Po restartování služby Azure Kubernetes v systému Azure Stack HCL dojde k odebrání všech clusterů Kubernetes a hostitele služby Azure Kubernetes.Restarting Azure Kubernetes Service on Azure Stack HCI will remove all of your Kubernetes clusters if any, and the Azure Kubernetes Service host. Odinstaluje taky službu Azure Kubernetes na Azure Stack agenty a služby HCI v uzlech.It will also uninstall the Azure Kubernetes Service on Azure Stack HCI agents and services from the nodes. Pak se vrátí zpět kroky původní instalace, dokud se hostitel znovu nevytvoří.It will then go back through the original install process steps until the host is recreated. Služba Azure Kubernetes na Azure Stack konfiguraci HCI, kterou jste nakonfigurovali prostřednictvím nástroje Set-AksHciConfig , a stažené image VHDX se zachovají.The Azure Kubernetes Service on Azure Stack HCI configuration that you configured via Set-AksHciConfig and the downloaded VHDX images are preserved.

Pokud chcete restartovat službu Azure Kubernetes v Azure Stack HCL se stejným nastavením konfigurace, spusťte následující příkaz.To restart Azure Kubernetes Service on Azure Stack HCI with the same configuration settings, run the following command.

Restart-AksHci

Resetovat nastavení konfigurace a přeinstalovat službu Azure Kubernetes Service na Azure Stack HCIReset configuration settings and reinstall Azure Kubernetes Service on Azure Stack HCI

Pokud chcete službu Azure Kubernetes přeinstalovat na Azure Stack HCL s jiným nastavením konfigurace, spusťte nejdřív následující příkaz.To reinstall Azure Kubernetes Service on Azure Stack HCI with different configuration settings, run the following command first.

Uninstall-AksHci

Po spuštění výše uvedeného příkazu můžete změnit nastavení konfigurace pomocí následujícího příkazu.After running the above command, you can change the configuration settings with the following command. Parametry zůstávají stejné, jak je popsáno v kroku 3.The parameters remain the same as described in Step 3. Pokud tento příkaz spustíte bez zadaných parametrů, obnoví se výchozí hodnoty parametrů.If you run this command with no specified parameters, the parameters will be reset to their default values.

Set-AksHciConfig

Po změně konfigurace na požadovaná nastavení spusťte následující příkaz, který přeinstaluje Azure Stack Kubernetes na Azure Stack HCI.After changing the configuration to your desired settings, run the following command to reinstall Azure Stack Kubernetes on Azure Stack HCI.

Install-AksHci

Odebrat službu Azure Kubernetes v Azure Stack HCIRemove Azure Kubernetes Service on Azure Stack HCI

Pokud chcete odebrat službu Azure Kubernetes v Azure Stack HCI, spusťte následující příkaz.To remove Azure Kubernetes Service on Azure Stack HCI, run the following command. Pokud odinstalujete nasazení centra pro správu Windows pomocí PowerShellu, musíte příkaz Spustit s -Force příznakem.If you are using PowerShell to uninstall a Windows Admin Center deployment, you must run the command with the -Force flag.

Uninstall-AksHci

Po spuštění výše uvedeného příkazu můžete spustit Install-AksHci příkaz pro instalaci hostitele služby Azure Kubernetes se stejnou konfigurací, jako jste předtím.After running the above command, you can run the Install-AksHci command to install the Azure Kubernetes Service host with the same configuration as before. Pokud chcete konfiguraci změnit, spusťte Set-AksHciConfig se změnami, které chcete provést před spuštěním příkazu install.If you want to change the configuration, run Set-AksHciConfig with the changes you want to make before running the install command.

Pokud nechcete zachovat starou konfiguraci, spusťte následující příkaz.If you don't want to retain the old configuration, run the following command.

Uninstall-AksHci -Force

Pokud se příkazy PowerShellu spouštějí v clusteru, kde se dřív používalo centrum pro správu Windows k nasazení, modul PowerShell zkontroluje existenci konfiguračního souboru centra pro správu systému Windows.If PowerShell commands are run on a cluster where Windows Admin Center was previously used to deploy, the PowerShell module checks the existence of the Windows Admin Center configuration file. Centrum pro správu systému Windows umístí konfigurační soubor centra pro správu systému Windows ve všech uzlech.Windows Admin Center places the Windows Admin Center configuration file across all nodes. Pokud použijete příkaz uninstall a vrátíte se zpátky do centra pro správu systému Windows, spusťte výše uvedený příkaz uninstall s -Force příznakem. Pokud tomu tak není, PowerShell a centrum pro správu Windows nebudou synchronizovány.If you use the uninstall command and go back to Windows Admin Center, run the above uninstall command with the -Force flag. If this is not done, PowerShell and Windows Admin Center will be out of sync.

Další krokyNext steps