Hızlı başlangıç: PowerShell kullanarak Azure Stack HUP üzerinde Azure Kubernetes hizmet konağını ayarlamaQuickstart: Set up an Azure Kubernetes Service host on Azure Stack HCI using PowerShell

Uygulama hedefi: Azure Stack HI, Windows Server 2019 DatacenterApplies to: Azure Stack HCI, Windows Server 2019 Datacenter

Bu hızlı başlangıçta, PowerShell kullanarak bir Azure Kubernetes hizmet konağını ayarlamayı öğreneceksiniz.In this quickstart, you'll learn how to set up an Azure Kubernetes Service host using PowerShell. Bunun yerine Windows Yönetim Merkezi 'ni kullanmak için bkz. Windows Yönetim Merkezi Ile ayarlama.To instead use Windows Admin Center, see Set up with Windows Admin Center.

Başlamadan önceBefore you begin

Aşağıdakilerden birine sahip olduğunuzdan emin olun:Make sure you have one of the following:

  • 2-4 düğüm Azure Stack HCı kümesi2-4 node Azure Stack HCI cluster
  • Windows Server 2019 Datacenter yük devretme kümesiWindows Server 2019 Datacenter failover cluster
  • Tek düğümlü Windows Server 2019 DatacenterSingle node Windows Server 2019 Datacenter

Başlamadan önce, sistem gereksinimleri sayfasındaki tüm önkoşulları karşıladığınızdan emin olun.Before getting started, make sure you have satisfied all the prerequisites on the system requirements page. Azure Stack HCı kümesine bir 2-4 düğümü kullanmanızı öneririz.We recommend having a 2-4 node Azure Stack HCI cluster. Yukarıdakilerden herhangi birine sahip değilseniz Azure Stack HCI kayıt sayfasındakiyönergeleri izleyin.If you don't have any of the above, follow instructions on the Azure Stack HCI registration page.

Önemli

Azure Stack HI 'de Azure Kubernetes hizmeti kaldırılırken bkz. Azure Stack hu üzerinde Azure Kubernetes hizmetini kaldırma ve yönergeleri dikkatle izleyin.When removing Azure Kubernetes Service on Azure Stack HCI, see Remove Azure Kubernetes Service on Azure Stack HCI and carefully follow the instructions.

1. Adım: Akshcı PowerShell modülünü Indirme ve yüklemeStep 1: Download and install the AksHci PowerShell module

AKS-HCI-Public-Preview-Dec-2020 Azure Kubernetes HIZMETINDEN Azure Stack CI kayıt sayfasındanindirin.Download the AKS-HCI-Public-Preview-Dec-2020 from the Azure Kubernetes Service on Azure Stack HCI registration page. ZIP dosyası AksHci.Powershell.zip PowerShell modülünü içerir.The zip file AksHci.Powershell.zip contains the PowerShell module.

Azure Kubernetes hizmetini daha önce PowerShell veya Windows Yönetim Merkezi kullanarak Azure Stack HI 'ye yüklediyseniz, yeni PowerShell modülü için iki yükleme akışı vardır: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:

  • PowerShell modülünün temiz bir yüklemesini gerçekleştirin, bu nedenle temiz bir sistemle başlamanız ve daha önce dağıtılmış iş yükleriniz kaldırılır.Perform a clean installation of the PowerShell module, so you start with a clean system and your previously deployed workloads are removed. Temiz bir yükleme gerçekleştirmek için 1,1. adıma gidin.To perform a clean installation, go to Step 1.1.
  • Sisteminizi ve iş yüklerinizi yerinde tutmak istiyorsanız PowerShell modülünü yükseltin.Upgrade the PowerShell module if you want to keep your system and workloads in place. PowerShell modülünü yükseltmek için 1,2. adıma gidin.To upgrade the PowerShell module, go to Step 1.2.

Adım 1,1: Akshcı PowerShell modülünün temiz yüklemesini TemizlemeStep 1.1: Clean install of the AksHci PowerShell module

Devam etmeden önce aşağıdaki komutu çalıştırın.Run the following command before proceeding.

Uninstall-AksHci

Tüm PowerShell pencerelerini kapatın.Close all PowerShell windows. Yolda bulunan Akshcı, Akshcı. UI, MOC ve MSK8sDownloadAgent için var olan tüm dizinleri silin %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. Mevcut dizinler silindikten sonra, yeni zip dosyasının içeriğini ayıklayabilirsiniz.Once the existing directories are deleted, you can extract the contents of the new zip file. ZIP dosyasını doğru konumda () ayıkladığınızdan emin olun %systemdrive%\program files\windowspowershell\modules .Make sure to extract the zip file in the correct location (%systemdrive%\program files\windowspowershell\modules). Ardından, aşağıdaki komutları çalıştırın.Then, run the following commands.

Import-Module AksHci

Tüm PowerShell pencerelerini yeniden kapatın ve bir yönetim oturumunu yeniden açın ve 1,3. adım-yükseltilen PowerShell modülünü doğrulama adımına geçin.Close all PowerShell windows again and reopen an administrative session and proceed to Step 1.3 - Validate upgraded PowerShell module.

Adım 1,2: Akshcı PowerShell modülünü yükseltmeStep 1.2: Upgrade the AksHci PowerShell module

Tüm PowerShell pencerelerini kapatın.Close all PowerShell windows. Yolda bulunan Akshcı, Akshcı. UI, MOC ve MSK8sDownloadAgent için var olan tüm dizinleri silin %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. Bu dizinler kaldırıldıktan sonra, yeni zip dosyasının içeriğini ayıklayabilirsiniz.Once these directories are removed, you can extract the contents of the new zip file. ZIP dosyasını doğru konumda () ayıkladığınızdan emin olun %systemdrive%\program files\windowspowershell\modules .Make sure to extract the zip file in the correct location (%systemdrive%\program files\windowspowershell\modules). Ardından, aşağıdaki komutları çalıştırın.Then, run the following commands.

Import-Module AksHci

Yukarıdaki komutları çalıştırdıktan sonra, tüm PowerShell pencerelerini kapatın ve aşağıda açıklandığı şekilde PowerShell modülü yükseltmesini doğrulamak üzere bir yönetim oturumunu yeniden açın ve ardından bu Update-AksHci komutu belgede daha sonra anlatıldığı gibi çalıştırın.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.

Adım 1,3: yükseltilen PowerShell modülünü doğrulamaStep 1.3: Validate upgraded PowerShell module

PowerShell modülünün en son sürümüne sahip olup olmadığınızı denetlemek için Tüm PowerShell pencerelerini kapatın ve yeni bir yönetim oturumunu yeniden açın.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

ÇıktılarınOutput:

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

2. Adım: makinenize dağıtım için hazırlamaStep 2: Prepare your machine(s) for deployment

Tüm gereksinimlerin Azure Kubernetes hizmetini Azure Stack CI üzerinde yüklemeye karşılanıp karşılanmadığını görmek için her fiziksel düğümdeki denetimleri çalıştırın.Run checks on every physical node to see if all the requirements are satisfied to install Azure Kubernetes Service on Azure Stack HCI.

PowerShell 'i yönetici olarak açın ve aşağıdaki komutu çalıştırın.Open PowerShell as an administrator and run the following command.

Initialize-AksHciNode

Denetimler tamamlandığında, yeşil metinde "bitti" görüntülendiğini görürsünüz.When the checks are finished, you'll see "Done" displayed in green text.

3. Adım: dağıtımınızı yapılandırmaStep 3: Configure your deployment

Azure Kubernetes hizmet ana bilgisayarı için yapılandırma ayarlarını belirleyin.Set the configuration settings for the Azure Kubernetes Service host. Azure Stack HCı kümesine veya bir Windows Server 2019 Datacenter yük devretme kümesine 2-4 düğümünde dağıtım yapıyorsanız, imageDir ve parametrelerini belirtmeniz gerekir cloudConfigLocation .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. Tek düğümlü Windows Server 2019 Datacenter için tüm parametreler isteğe bağlıdır ve varsayılan değerlerine ayarlanır.For a single node Windows Server 2019 Datacenter, all parameters are optional and set to their default values. Ancak en iyi performans için, bir 2-4 düğümü Azure Stack HCI küme dağıtımı kullanmanızı öneririz.However, for optimal performance, we recommend using a 2-4 node Azure Stack HCI cluster deployment.

Aşağıdaki komutla dağıtımınızı yapılandırın.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]

ÖrnekExample

DHCP ağıyla 2-4 düğümlü bir küme üzerinde dağıtım yapmak için:To deploy on a 2-4 node cluster with DHCP networking:

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

Bir sanal IP havuzu ile dağıtmak için: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

Yük Dengeleyici ile dağıtmak için stacked_kube_vip :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

Bir ara sunucu ile dağıtmak için: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

İsteğe bağlı parametrelerOptional parameters

-imageDir

Azure Stack CI üzerinde Azure Kubernetes hizmetinin VHD görüntülerini depolayacağı dizinin yolu.The path to the directory where Azure Kubernetes Service on Azure Stack HCI will store its VHD images. %systemdrive%\AksHciImageStoreTek düğümlü dağıtımlar için varsayılan değerdir.Defaults to %systemdrive%\AksHciImageStore for single node deployments. Çok düğümlü dağıtımlar için bu parametrenin belirtilmesi gerekir.For multi-node deployments, this parameter must be specified. Yol, gibi bir paylaşılan depolama yoluna veya gibi bir  C:\ClusterStorage\Volume2\ImageStore   SMB paylaşımıyla işaret etmelidir  \\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

Bulut aracısının yapılandırmasını depolayacağı konum.The location where the cloud agent will store its configuration. %systemdrive%\wssdcloudagentTek düğümlü dağıtımlar için varsayılan değerdir.Defaults to %systemdrive%\wssdcloudagent for single node deployments. Konum, yukarıdaki yol ile aynı olabilir  -imageDir .The location can be the same as the path of -imageDir above.Çok düğümlü dağıtımlar için bu parametrenin belirtilmesi gerekir. For *multi-node deployments, this parameter must be specified*. Yol, gibi bir paylaşılan depolama yoluna veya gibi bir  C:\ClusterStorage\Volume2\ImageStore   SMB paylaşımıyla işaret etmelidir  \\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. Depolama alanının her zaman erişilebilir olması için konumun yüksek oranda kullanılabilir bir paylaşımda olması gerekir.The location needs to be on a highly available share so that the storage will always be accessible.

-nodeConfigLocation

Düğüm aracılarının yapılandırmalarını depolayacağı konum.The location where the node agents will store their configuration. Her düğüm bir düğüm aracısına sahiptir, bu nedenle yapılandırması yereldir.Every node has a node agent, so its configuration is local to it. Bu konum bir yerel yol olmalıdır.This location must be a local path. Tüm dağıtımlar için varsayılan olarak ' dir %systemdrive%\programdata\wssdagent .Defaults to %systemdrive%\programdata\wssdagent for all deployments.

-vnetName

Sanal makinelerin bağlanacağı sanal anahtarın adı.The name of the virtual switch to connect the virtual machines to. Konakta zaten bir dış anahtar varsa, anahtarın adını buraya geçirmeniz gerekir.If you already have an external switch on the host, you should pass the name of the switch here. Anahtar yoksa, oluşturulur.The switch will be created if it does not exist."Dış" adı varsayılan olarak belirlenmiştir. Defaults to “External” name.

-controlPlaneVmSize

Denetim düzlemi için oluşturulacak VM 'nin boyutu.The size of the VM to create for the control plane. Kullanılabilir VM boyutlarının bir listesini almak için öğesini çalıştırın Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-loadBalancerVmSize

Load Balancer VM 'Ler için oluşturulacak VM 'nin boyutu.The size of the VM to create for the Load Balancer VMs. Kullanılabilir VM boyutlarının bir listesini almak için öğesini çalıştırın Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-sshPublicKey

SSH ortak anahtar dosyasının yolu.Path to an SSH public key file. Bu ortak anahtarı kullanarak Azure Kubernetes hizmeti tarafından Azure Stack HI dağıtımında oluşturulan herhangi bir VM 'de oturum açabilirsiniz.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. Kendi SSH ortak anahtarınız varsa, konumunu buraya geçitirsiniz.If you have your own SSH public key, you will pass its location here. Anahtar sağlanmazsa, altında bir tane görünür %systemdrive%\akshci\.ssh\akshci_rsa.pub .If no key is provided, we will look for one under %systemdrive%\akshci\.ssh\akshci_rsa.pub. Dosya yoksa, yukarıdaki konumda bir SSH anahtar çifti oluşturulur ve kullanılır.If the file does not exist, an SSH key pair in the above location will be generated and used.

-vipPoolStartIp

Dağıtımınız için VIP havuzlarını kullanırken, bu parametre havuzun ağ başlangıcını belirtir.When using VIP pools for your deployment, this parameter specifies the network start of the pool. IP adresi havuzunun tutarlı kalmasını sağlamak için, uzun süreli dağıtımlar için VIP havuzları kullanmanız gerekir.You should use VIP pools for long-lived deployments to guarantee that a pool of IP addresses remain consistent. Her zaman ulaşılabilir olması gereken iş yükleriniz varsa bu faydalıdır.This is useful when you have workloads that always need to be reachable. Varsayılan değer: none.Default is none.

-vipPoolEndIp

Dağıtımınız için VIP havuzlarını kullanırken, bu parametre havuzun ağ sonunu belirtir.When using VIP pools for your deployment, this parameter specifies the network end of the pool. IP adresi havuzunun tutarlı kalmasını sağlamak için, uzun süreli dağıtımlar için VIP havuzları kullanmanız gerekir.You should use VIP pools for long-lived deployments to guarantee that a pool of IP addresses remain consistent. Her zaman ulaşılabilir olması gereken iş yükleriniz varsa bu faydalıdır.This is useful when you have workloads that always need to be reachable. Varsayılan değer: none.Default is none.

-macPoolStart

Bu, Azure Kubernetes hizmet ana makinesi için kullanmak istediğiniz MAC havuzunun MAC adresinin başlangıcını belirtmek için kullanılır.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. MAC adresi için sözdizimi, ilk baytın en az önemli bitinin her zaman 0 olması ve ilk baytın her zaman çift sayı olması gerekir (yani, 00, 02, 04, 06...). Tipik bir MAC adresi şöyle görünebilir: 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. Atanan MAC adreslerinin tutarlı olması için uzun süreli dağıtımlar için MAC havuzları kullanın.Use MAC pools for long-lived deployments so that MAC addresses assigned are consistent. Bu, VM 'Lerin belirli MAC adreslerine sahip olması için bir gereksinimleriniz varsa yararlıdır.This is useful if you have a requirement that the VMs have specific MAC addresses. Varsayılan değer: none.Default is none.

-macPoolEnd

Bu, Azure Kubernetes hizmet ana makinesi için kullanmak istediğiniz MAC havuzunun MAC adresinin sonunu belirtmek için kullanılır.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. MAC adresi için sözdizimi, ilk baytın en az önemli bitinin her zaman 0 olması ve ilk baytın her zaman çift sayı olması gerekir (yani, 00, 02, 04, 06...). Olarak geçirilen adresin ilk baytı -macPoolEnd , olarak geçirilmiş adresin ilk baytla aynı olmalıdır -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. Atanan MAC adreslerinin tutarlı olması için uzun süreli dağıtımlar için MAC havuzları kullanın.Use MAC pools for long-lived deployments so that MAC addresses assigned are consistent. Bu, VM 'Lerin belirli MAC adreslerine sahip olması için bir gereksinimleriniz varsa yararlıdır.This is useful if you have a requirement that the VMs have specific MAC addresses. Varsayılan değer: none.Default is none.

-vlanID

Bu, bir ağ VLAN KIMLIĞI belirtmek için kullanılabilir.This can be used to specify a network VLAN ID. Azure Kubernetes hizmet ana bilgisayarı ve Kubernetes kümesi VM ağ bağdaştırıcıları, belirtilen VLAN KIMLIĞIYLE etiketlenecek.Azure Kubernetes Service host and Kubernetes cluster VM network adapters will be tagged with the provided VLAN ID. Doğru bağlantıyı almak için etiketlenmesi gereken belirli bir VLAN KIMLIĞI varsa, bu kullanılmalıdır.This should be used if there is a specific VLAN ID that needs to be tagged to get the right connectivity. Varsayılan değer: none.Default is none.

-kvaLoadBalancerType

Bu, ya da unstacked_haproxy alır stacked_kube_vip .This takes in either unstacked_haproxy or stacked_kube_vip. unstacked_haproxy , Azure Kubernetes hizmet ana bilgisayarının API sunucu uç noktası olarak ayrı bir yük dengeleyici VM 'nin HAProxy ile dağıtıldığı varsayılandır.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_vip, Azure Kubernetes hizmet ana bilgisayarı için bir yük dengeleyici çözümüdür, Kubevıp.stacked_kube_vipis a load balancer solution, Kubevip, for the Azure Kubernetes Service host. API sunucusunu IP aracılığıyla yüksek oranda kullanılabilir tutmak için denetim düzlemi düğümleri genelinde bir kayan IP olarak konakta bir statik IP adresi belirtmenize olanak tanır.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. Bu seçenek seçilirse, parametrede statik IP adresini belirtmeniz kvaControlPlaneEndpoint ve ayrı bir yük DENGELEYICI VM dağıtılmamalıdır.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 , bellek, CPU ve dağıtım süresini kaydederek daha kolay bir IP adresi gerektirir.stacked_kube_vip requires an IP address and is more resource friendly by saving memory, CPU, and deployment time. Kayan IP olarak kullanılacak bir IP adresiniz yoksa, kullanmanız gerekir unstacked_haproxy .If you do not have an IP address to use as the floating IP, you should use unstacked_haproxy. İkinci seçenek, yük dengeleyici VM gerektirir.The latter option requires a load balancer VM.

-kvaControlPlaneEndpoint

Bu, parametresi olarak ayarlandığında Azure Kubernetes hizmet ana bilgisayarı API sunucu adresi olarak kullanılacak statik IP adresini belirtir kvaLoadBalancerType 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. Kullanılıyorsa stacked_kube_vip , bu parametrenin belirtilmesi gerekir.If stacked_kube_vip is used, this parameter must be specified.

-proxyServerHTTP

Bu, HTTP uç noktalarına erişmesi gereken tüm bileşenler tarafından kullanılması gereken bir ara sunucu URI 'SI sağlar.This provides a proxy server URI that should be used by all components that need to reach HTTP endpoints. URI biçimi URI şemasını, sunucu adresini ve bağlantı noktasını (yani,) içerir https://server.com:8888) .The URI format includes the URI schema, server address, and port (that is, https://server.com:8888). Varsayılan değer: none.Default is none.

-proxyServerHTTPS

Bu, HTTPS uç noktalarına erişmesi gereken tüm bileşenler tarafından kullanılması gereken bir ara sunucu URI 'SI sağlar.This provides a proxy server URI that should be used by all components that need to reach HTTPS endpoints. URI biçimi URI şemasını, sunucu adresini ve bağlantı noktasını (yani,) içerir https://server.com:8888) .The URI format includes the URI schema, server address, and port (that is, https://server.com:8888). Varsayılan değer: none.Default is none.

-proxyServerNoProxy

Bu, proxy 'den muaf tutulacak, virgülle ayrılmış adreslerin bir dizesidir.This is a comma-delimited string of addresses that will be exempt from the proxy. Varsayılan değer localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16 olarak belirlenmiştir.Default value is localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16. Bu, localhost trafiğini (localhost, 127.0.0.1), iç Kubernetes hizmet trafiğini (. svc), Kubernetes hizmeti CıDR 'i (10.96.0.0/12) ve Kubernetes POD CıDR 'i (10.244.0.0/16) ara sunucudan dışlar.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. Bu parametreyi, daha fazla alt ağ aralığı veya ad muafiyetleri eklemek için kullanabilirsiniz.You can use this parameter to add more subnet ranges or name exemptions. Bu parametrenin ayarları, doğru bir şekilde yapılandırılmamışsa, iç Kubernetes küme trafiğini proxy 'nize beklenmedik şekilde yönlendirebilmeniz için çok önemlidir. Bu, ağ iletişiminde çeşitli hatalara neden olabilir.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

Bu, HTTP/HTTPS ara sunucularınızda kimlik doğrulaması için Kullanıcı adı ve parola sağlar.This provides the username and password to authenticate to your HTTP/HTTPS proxy servers. Get-CredentialBu parametreye geçirilecek bir nesne oluşturmak için ' i kullanabilirsiniz PSCredential .You can use Get-Credential to generate a PSCredential object to pass to this parameter. Varsayılan değer: none.Default is none.

-cloudServiceCidr

Bu, MOC Cloudadgent hizmetine atanacak statik bir IP/ağ öneki sağlamak için kullanılabilir.This can be used to provide a static IP/network prefix to be assigned to the MOC CloudAgent service. Bu değer CıDR biçimi kullanılarak sağlanmalıdır.This value should be provided using the CIDR format. (Örnek: 192.168.1.2/16).(Example: 192.168.1.2/16). IP adresi değişmediğinden ağ üzerinde önemli her şeyin erişilebilir olduğundan emin olmak için bunu belirtmek isteyebilirsiniz.You may want to specify this to ensure that anything important on the network is always accessible because the IP address will not change. Varsayılan değer: none.Default is none.

-workingDir

Bu, modülün küçük dosyaları depolamak için kullanacağı çalışma dizinidir.This is a working directory for the module to use for storing small files. Varsayılan olarak %PROGRAMFILES%\AksHci   , ve çoğu dağıtım için değiştirilmemelidir.Defaults to %PROGRAMFILES%\AksHci and should not be changed for most deployments.Varsayılan değer değiştirilmesini önermiyoruz. We do not recommend changing the default.

-version

Dağıtmak istediğiniz Azure Stack CI üzerinde Azure Kubernetes hizmeti sürümü.The version of Azure Kubernetes Service on Azure Stack HCI that you want to deploy. Varsayılan değer en son sürümdür.The default is the latest version. Varsayılan değer değiştirilmesini önermiyoruz.We do not recommend changing the default.

-vnetType

Bağlanılacak veya oluşturulacak sanal anahtar türü.The type of virtual switch to connect to or create. Bu varsayılan "External" anahtar türüdür.This defaults to “External” switch type. Varsayılan değer değiştirilmesini önermiyoruz.We do not recommend changing the default.

-nodeAgentPort

Düğüm aracılarının dinlemesi gereken TCP/IP bağlantı noktası numarası.The TCP/IP port number that node agents should listen on. Varsayılan olarak 45000 ' dir.Defaults to 45000.Varsayılan değer değiştirilmesini önermiyoruz. We do not recommend changing the default.

-nodeAgentAuthorizerPort

Düğüm aracılarının yetkilendirme bağlantı noktaları için kullanması gereken TCP/IP bağlantı noktası numarası.The TCP/IP port number that node agents should use for their authorization port. Varsayılan olarak 45001 ' dir.Defaults to 45001. Varsayılan değer değiştirilmesini önermiyoruz.We do not recommend changing the default.

-clusterRoleName

Bu, bulut Aracısı küme içinde genel bir hizmet olarak oluşturulurken kullanılacak adı belirtir.This specifies the name to use when creating cloud agent as a generic service within the cluster. Bu, varsayılan olarak CA ön ekine ve bir GUID sonekine sahip benzersiz bir ada sahiptir (örneğin: "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”). Varsayılan değer değiştirilmesini önermiyoruz.We do not recommend changing the default.

-cloudLocation

Bu parametre özel bir Microsoft tarafından çalıştırılan bulut konum adı sağlar.This parameter provides a custom Microsoft Operated Cloud location name. Varsayılan ad "MocLocation" dır.The default name is "MocLocation". Varsayılan değer değiştirilmesini önermiyoruz.We do not recommend changing the default.

-skipHostLimitChecks

, Dağıtımın devam edebilmesi için belleği doğrulamak üzere gereken belleği ve disk alanını doğrulamak için komut dosyasını ister.Requests the script to skip any checks it does to confirm memory and disk space is available before allowing the deployment to proceed. Bu ayarın kullanılması önerilmez.We do not recommend using this setting.

-insecure

Azure Kubernetes hizmetini, bulut Aracısı ve düğüm aracıları gibi Azure Stack HI bileşenlerinde güvenli olmayan modda (TLS güvenliği olmayan bağlantı olmadan) dağıtır.Deploys Azure Kubernetes Service on Azure Stack HCI components such as cloud agent and node agent(s) in insecure mode (no TLS secured connections).Üretim ortamlarında güvenli olmayan mod kullanılması önerilmez.  We do not recommend using insecure mode in production environments.

-skipUpdates

Kullanılabilir herhangi bir güncelleştirmeyi atlamak istiyorsanız bu bayrağı kullanın.Use this flag if you want to skip any updates available. Bu ayarın kullanılması önerilmez.We do not recommend using this setting.

-forceDnsReplication

DNS çoğaltma, bazı sistemlerde bir saate kadar sürebilir.DNS replication can take up to an hour on some systems. Bu, dağıtımın yavaş olmasına neden olur.This will cause the deployment to be slow. Bu sorunla karşılaşırsanız Install-AksHci bir döngüde takılacaktır.If you hit this issue, you'll see that the Install-AksHci will be stuck in a loop. Bu sorunu daha fazla almak için bu bayrağı kullanmayı deneyin.To get past this issue, try to use this flag. -forceDnsReplicationBayrak garantili bir çözüm değildir.The -forceDnsReplication flag is not a guaranteed fix. Bayrağın arkasındaki mantık başarısız olursa, hata gizlenir ve komut, bayrak sağlanmadıysa olarak devam eder.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.

Azure Stack CI yapılandırmasındaki Azure Kubernetes hizmetini sıfırlayınReset the Azure Kubernetes Service on Azure Stack HCI configuration

Azure Stack CI yapılandırmasındaki Azure Kubernetes hizmetini sıfırlamak için aşağıdaki komutları çalıştırın.To reset the Azure Kubernetes Service on Azure Stack HCI configuration, run the following commands. Bu komutun kendi kendine çalıştırılması yapılandırmayı varsayılan değerlere sıfırlayacaktır.Running this command on its own will reset the configuration to default values.

Set-AksHciConfig

4. Adım: yeni bir dağıtım başlatmaStep 4: Start a new deployment

Dağıtımınızı yapılandırdıktan sonra, dağıtımı başlatmanız gerekir.After you've configured your deployment, you must start deployment. Bu işlem, Azure Kubernetes hizmetini Azure Stack CI aracıları/Hizmetleri ve Azure Kubernetes hizmet ana bilgisayarına yükler.This will install the Azure Kubernetes Service on Azure Stack HCI agents/services and the Azure Kubernetes Service host.

Dağıtıma başlamak için aşağıdaki komutu çalıştırın.To begin deployment, run the following command.

Install-AksHci

Dağıtılmış Azure Kubernetes hizmet konağını doğrulamaVerify your deployed Azure Kubernetes Service host

Azure Kubernetes hizmet ana bilgisayarın dağıtıldığından emin olmak için aşağıdaki komutu çalıştırın.To ensure that your Azure Kubernetes Service host was deployed, run the following command. Ayrıca, Kubernetes kümelerini dağıttıktan sonra aynı komutu kullanarak edinebilirsiniz.You will also be able to get Kubernetes clusters using the same command after deploying them.

Get-AksHciCluster

ÇıktılarınOutput:


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

5. Adım: kubectl kullanarak kümelerinize erişinStep 5: Access your clusters using kubectl

Kubectl kullanarak Azure Kubernetes hizmet konağına veya Kubernetes kümenize erişmek için aşağıdaki komutu çalıştırın.To access your Azure Kubernetes Service host or Kubernetes cluster using kubectl, run the following command. Bu, kubectl için varsayılan kubeconfig dosyası olarak belirtilen kümenin kubeconfig dosyasını kullanacaktır.This will use the specified cluster's kubeconfig file as the default kubeconfig file for kubectl.

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

ÖrnekExample

Get-AksHciCredential -clusterName clustergroup-management

Gerekli ParametrelerRequired Parameters

clusterName

Kümenin adı.The name of the cluster.

İsteğe Bağlı ParametrelerOptional Parameters

outputLocation

Kubeconfig 'in indirilmesini istediğiniz konum.The location where you want the kubeconfig downloaded. %USERPROFILE%\.kube varsayılan değerdir.Default is %USERPROFILE%\.kube.

Günlükleri almaGet logs

Tüm yığınlarınızın günlüklerini almak için aşağıdaki komutu çalıştırın.To get logs from your all your pods, run the following command. Bu komut, yolunda adlı bir çıktı sıkıştırması klasörü oluşturur akshcilogs C:\wssd\akshcilogs .This command will create an output zipped folder called akshcilogs in the path C:\wssd\akshcilogs.

Get-AksHciLogs

Azure Stack CI üzerinde Azure Kubernetes hizmeti 'nin en son sürümüne güncelleştirmeUpdate to the latest version of Azure Kubernetes Service on Azure Stack HCI

Azure Stack HI 'de Azure Kubernetes hizmeti 'nin en son sürümüne güncelleştirmek için aşağıdaki komutu çalıştırın.To update to the latest version of Azure Kubernetes Service on Azure Stack HCI, run the following command. Update komutu yalnızca Ekim sürümünü yüklediyseniz işe yarar.The update command only works if you have installed the Oct release. Ekim sürümünden daha eski olan yayınlar için çalışmaz.It will not work for releases older than the October release. Bu güncelleştirme komutu, Azure Kubernetes hizmet konağını ve şirket içi Microsoft tarafından çalıştırılan bulut platformunu güncelleştirir.This update command updates the Azure Kubernetes Service host and the on-premise Microsoft operated cloud platform. Bu önizleme sürümünde, Kubernetes sürümü ve AKS ana bilgisayar işletim sistemi sürümü hala aynı kalır.For this preview release, the Kubernetes version and AKS host OS version still remain the same. Bu komut, var olan herhangi bir iş yükü kümesini yükseltmez.This command does not upgrade any existing workload clusters. AKS ana bilgisayarı güncelleştirildikten sonra oluşturulan yeni iş yükü kümeleri, Windows düğümü işletim sistemi sürümü ve Kubernetes sürümü açısından mevcut iş yükü kümelerinden farklıdır.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

Windows düğümleri ile Kubernetes kümelerinizde desteklenmeyen Windows Server işletim sistemi sürümlerini çalıştırmaya engel olmak üzere yönetim kümesini güncelleştirdikten hemen sonra iş yükü kümelerini güncelleştirmenizi öneririz.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. İş yükü kümenizi güncelleştirmek için iş yükü kümenizi güncelleştirmemakalesini ziyaret edin.To update your workload cluster, visit update your workload cluster.

Azure Stack CI üzerinde Azure Kubernetes hizmetini yeniden başlatınRestart Azure Kubernetes Service on Azure Stack HCI

Azure Stack CI üzerinde Azure Kubernetes hizmetini yeniden başlatmak, varsa Kubernetes kümelerinizi ve Azure Kubernetes hizmet ana bilgisayarını kaldırır.Restarting Azure Kubernetes Service on Azure Stack HCI will remove all of your Kubernetes clusters if any, and the Azure Kubernetes Service host. Ayrıca, Azure Kubernetes hizmetini düğümlerin Azure Stack CI aracılarından ve hizmetlerinde de kaldırır.It will also uninstall the Azure Kubernetes Service on Azure Stack HCI agents and services from the nodes. Daha sonra, ana bilgisayar yeniden oluşturulana kadar özgün Install Process Steps aracılığıyla geri döner.It will then go back through the original install process steps until the host is recreated. İle yapılandırdığınız Azure Stack CI yapılandırmasındaki Azure Kubernetes hizmeti Set-AksHciConfig ve INDIRILEN VHDX görüntüleri korunur.The Azure Kubernetes Service on Azure Stack HCI configuration that you configured via Set-AksHciConfig and the downloaded VHDX images are preserved.

Azure Kubernetes hizmetini aynı yapılandırma ayarlarıyla Azure Stack HI 'de yeniden başlatmak için aşağıdaki komutu çalıştırın.To restart Azure Kubernetes Service on Azure Stack HCI with the same configuration settings, run the following command.

Restart-AksHci

Yapılandırma ayarlarını sıfırlama ve Azure Kubernetes hizmetini Azure Stack CI 'da yeniden yüklemeReset configuration settings and reinstall Azure Kubernetes Service on Azure Stack HCI

Azure Kubernetes hizmetini farklı yapılandırma ayarlarıyla Azure Stack HI 'ya yeniden yüklemek için, önce aşağıdaki komutu çalıştırın.To reinstall Azure Kubernetes Service on Azure Stack HCI with different configuration settings, run the following command first.

Uninstall-AksHci

Yukarıdaki komutu çalıştırdıktan sonra, aşağıdaki komutla yapılandırma ayarlarını değiştirebilirsiniz.After running the above command, you can change the configuration settings with the following command. Parametreler adım 3 ' te açıklananla aynı kalır.The parameters remain the same as described in Step 3. Bu komutu belirtilen parametre olmadan çalıştırırsanız, parametreler varsayılan değerlerine sıfırlanır.If you run this command with no specified parameters, the parameters will be reset to their default values.

Set-AksHciConfig

Yapılandırmayı istenen ayarlarınıza değiştirdikten sonra, Azure Stack HUBERNETES Azure Stack yeniden yüklemek için aşağıdaki komutu çalıştırın.After changing the configuration to your desired settings, run the following command to reinstall Azure Stack Kubernetes on Azure Stack HCI.

Install-AksHci

Azure Stack CI 'da Azure Kubernetes hizmetini kaldırmaRemove Azure Kubernetes Service on Azure Stack HCI

Azure Stack HI 'de Azure Kubernetes hizmetini kaldırmak için aşağıdaki komutu çalıştırın.To remove Azure Kubernetes Service on Azure Stack HCI, run the following command. Windows Yönetim Merkezi dağıtımını kaldırmak için PowerShell kullanıyorsanız, komutunu bayrağıyla çalıştırmanız gerekir -Force .If you are using PowerShell to uninstall a Windows Admin Center deployment, you must run the command with the -Force flag.

Uninstall-AksHci

Yukarıdaki komutu çalıştırdıktan sonra, Install-AksHci Azure Kubernetes hizmet konağını daha önce ile aynı yapılandırmayla yüklemek için komutunu çalıştırabilirsiniz.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. Yapılandırmayı değiştirmek istiyorsanız, Set-AksHciConfig install komutunu çalıştırmadan önce yapmak istediğiniz değişikliklerle çalıştırın.If you want to change the configuration, run Set-AksHciConfig with the changes you want to make before running the install command.

Eski yapılandırmayı sürdürmek istemiyorsanız, aşağıdaki komutu çalıştırın.If you don't want to retain the old configuration, run the following command.

Uninstall-AksHci -Force

PowerShell komutları Windows Yönetim Merkezi 'nin dağıtmak için daha önce kullanıldığı bir kümede çalıştırıldıysa, PowerShell modülü Windows Yönetim Merkezi yapılandırma dosyasının varlığını denetler.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. Windows Yönetim Merkezi, Windows Yönetim Merkezi yapılandırma dosyasını tüm düğümlere koyar.Windows Admin Center places the Windows Admin Center configuration file across all nodes. Kaldırma komutunu kullanırsanız ve Windows Yönetim merkezine geri döndüğünüzde, yukarıdaki Uninstall komutunu -Force bayrağıyla çalıştırın. Bu yapılmazsa, PowerShell ve Windows Yönetim Merkezi eşitlenmemiş olur.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.

Sonraki adımlarNext steps