Set-AksHciConfig

개요

Azure Kubernetes Service 호스트에 대한 구성 설정을 설정하거나 업데이트합니다.

Syntax

호스트에 대한 구성 설정

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]   

설명

Azure Kubernetes Service 호스트에 대한 구성 설정을 설정합니다. 2-4 노드 Azure Stack HCI 클러스터 또는 Windows Server 2019 Datacenter 장애 조치(failover) 클러스터에 배포하는 경우 및 -cloudConfigLocation 매개 변수를 -workingDir 지정해야 합니다. 단일 노드 Windows Server 2019 Datacenter의 경우 모든 매개 변수는 선택 사항이며 기본값으로 설정됩니다. 그러나 최적의 성능을 위해 2-4 노드 Azure Stack HCI 클러스터 배포를 사용하는 것이 좋습니다.

예제

DHCP 네트워킹을 사용하여 2-4 노드 클러스터에 배포하려면

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"

고정 IP 네트워킹을 사용하여 배포하려면

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"

프록시 서버를 사용하여 배포하려면

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"

매개 변수

-imageDir

AKS 하이브리드가 VHD 이미지를 저장하는 디렉터리의 경로입니다. 이 매개 변수는 필수입니다. 경로는 와 같은 C:\ClusterStorage\Volume2\ImageStore공유 스토리지 경로 또는 SMB 공유(예: \\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

작은 파일을 저장하는 데 사용할 모듈의 작업 디렉터리입니다. 이 매개 변수는 필수입니다. 경로는 와 같은 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

클라우드 에이전트가 구성을 저장하는 위치입니다. 이 매개 변수는 필수입니다. 경로는 와 같은 C:\ClusterStorage\Volume2\ImageStore공유 스토리지 경로 또는 SMB 공유(예: \\FileShare\ImageStore)를 가리킵니다. 스토리지에 항상 액세스할 수 있도록 위치가 항상 사용 가능한 공유에 있어야 합니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False

-vnet

명령을 사용하여 만든 AksHciNetworkSetting 개체의 New-AksHciNetworkSetting 이름입니다.

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-createAutoConfigContainers

CSV(클러스터 공유 볼륨)에서 VM 데이터의 자동 배포를 사용하지 않도록 설정할 수 있습니다. 자동 배포를 사용하지 않도록 설정하려면 이 매개 변수의 인수로 를 사용합니다 false . 자동 배포를 사용하지 않도록 설정하면 선택한 imageDir CSV만 사용됩니다. 기본값은 true입니다.

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-offlineDownload

Install-AksHci 중에 오프라인 다운로드를 호출합니다. Enable-AksHciOfflineDownload도 실행해야 합니다. 이 플래그는 매개 변수와 함께 -stagingShare 사용됩니다.

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-offsiteTransferCompleted

Install-AksHci 중에 오프사이트에서 다운로드하여 배포 서버로 전송된 아티팩트를 사용하도록 배포를 설정합니다. 이 플래그는 및 -stagingShare 매개 변수와 함께 -offlineDownload 사용됩니다.

-모드

오프라인 다운로드에 사용할 다운로드 모드입니다. AKS 하이브리드 배포에 대한 최소 이미지를 원하는 경우 를 사용합니다 minimum . 이 옵션에는 필수 Linux 이미지와 필요한 Kubernetes 이미지만 포함됩니다. AKS 하이브리드 배포에 대한 모든 이미지를 원하는 경우 를 사용합니다 full . 이 옵션에는 모든 Linux 및 Windows 이미지와 지원되는 모든 Kubernetes 이미지가 포함됩니다. 매개 변수와 함께 이 매개 변수를 -offlineDownload 사용합니다. 기본값은 full입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False

-stagingShare

이미지를 다운로드할 위치의 로컬 경로입니다. 매개 변수와 함께 를 offlineDownload 사용합니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-nodeConfigLocation

노드 에이전트가 구성을 저장하는 위치입니다. 모든 노드에는 노드 에이전트가 있으므로 해당 구성은 해당 노드에 로컬입니다. 이 위치는 로컬 경로여야 합니다. 모든 배포의 %systemdrive%\programdata\wssdagent 기본값은 입니다.

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

컨트롤 플레인에 대해 만들 VM의 크기입니다. 사용 가능한 VM 크기 목록을 얻으려면 를 실행 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

SSH 공개 키 파일의 경로입니다. 이 공개 키를 사용하여 AKS 하이브리드 배포에서 만든 VM에 로그인할 수 있습니다. 사용자 고유의 SSH 공개 키가 있는 경우 여기에 해당 위치를 전달합니다. 키가 제공되지 않으면 .pub에서 %systemdrive%\akshci\.ssh\akshci_rsa키를 찾습니다. 파일이 없으면 이 위치에 SSH 키 쌍이 생성되고 사용됩니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolStart

Azure Kubernetes Service 호스트 VM에 사용할 MAC 풀의 MAC 주소 시작을 지정합니다. MAC 주소의 구문을 사용하려면 첫 번째 바이트의 가장 중요한 비트는 항상 0이어야 하고 첫 번째 바이트는 항상 짝수(즉, 00, 02, 04, 06...)여야 합니다. 일반적인 MAC 주소는 02:1E:2B:78:00:00과 같이 표시할 수 있습니다. 할당된 MAC 주소가 일관되도록 수명이 긴 배포에 MAC 풀을 사용합니다. MAC 풀은 VM에 특정 MAC 주소가 있어야 한다는 요구 사항이 있는 경우에 유용합니다. 기본값은 None입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolEnd

Azure Kubernetes Service 호스트 VM에 사용할 MAC 풀의 MAC 주소 끝을 지정합니다. MAC 주소의 구문을 사용하려면 첫 번째 바이트의 가장 중요한 비트는 항상 0이어야 하고 첫 번째 바이트는 항상 짝수(즉, 00, 02, 04, 06...)여야 합니다. 로 -macPoolEnd 전달된 주소의 첫 번째 바이트는 로 전달된 주소의 첫 번째 바이트와 동일 -macPoolStart해야 합니다. 할당된 MAC 주소가 일관되도록 수명이 긴 배포에 MAC 풀을 사용합니다. MAC 풀은 VM에 특정 MAC 주소가 있어야 한다는 요구 사항이 있는 경우에 유용합니다. 기본값은 None입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-proxySettings

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

MOC CloudAgent 서비스에 할당할 고정 IP/네트워크 접두사를 제공합니다. 이 값은 CIDR 형식을 사용하여 제공해야 합니다. 예: 192.168.1.2/16. IP 주소가 변경되지 않으므로 네트워크에서 중요한 모든 항목에 항상 액세스할 수 있도록 이 매개 변수를 지정할 수 있습니다. 기본값은 None입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-version

배포하려는 AKS 하이브리드 버전입니다. 기본값은 최신 버전입니다. 기본값을 변경하지 않는 것이 좋습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentPort

노드 에이전트가 수신 대기해야 하는 TCP/IP 포트 번호이며, 기본값은 45000입니다. 기본값을 변경하지 않는 것이 좋습니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentAuthorizerPort

노드 에이전트가 권한 부여 포트에 사용해야 하는 TCP/IP 포트 번호입니다. 기본값은 45001입니다. 기본값을 변경하지 않는 것이 좋습니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentPort

클라우드 에이전트가 수신 대기해야 하는 TCP/IP 포트 번호입니다. 기본값은 55000입니다. 기본값을 변경하지 않는 것이 좋습니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentAuthorizerPort

클라우드 에이전트가 권한 부여 포트에 사용해야 하는 TCP/IP 포트 번호입니다. 기본값은 65000입니다. 기본값을 변경하지 않는 것이 좋습니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False

-clusterRoleName

클러스터 내에서 일반 서비스로 클라우드 에이전트를 만들 때 사용할 이름을 지정합니다. 이 매개 변수는 기본적으로 ca- 접두사와 GUID 접미사가 있는 고유한 이름으로 설정됩니다. 기본값을 변경하지 않는 것이 좋습니다.

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

사용자 지정 Microsoft 운영 클라우드 위치 이름을 제공합니다. 기본 이름은 MocLocation입니다. 기본값을 변경하지 않는 것이 좋습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False

-skipHostLimitChecks

배포를 진행하기 전에 메모리 및 디스크 공간을 사용할 수 있는지 확인하기 위해 스크립트가 검사를 건너뛰도록 요청합니다. 이 설정은 사용하지 않는 것이 좋습니다.

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

스크립트가 로컬 및 원격 노드 모두에 대한 원격 기능을 확인하기 위해 검사를 건너뛰도록 요청합니다. 이 설정은 사용하지 않는 것이 좋습니다.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-불안

안전하지 않은 모드(TLS 보안 연결 없음)에서 클라우드 에이전트 및 노드 에이전트와 같은 AKS 하이브리드 구성 요소를 배포합니다. 프로덕션 환경에서 안전하지 않은 모드를 사용하지 않는 것이 좋습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipUpdates

사용 가능한 업데이트를 건너뛰려면 이 플래그를 사용합니다. 이 설정은 사용하지 않는 것이 좋습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-forceDnsReplication

DNS 복제는 일부 시스템에서 최대 1시간이 걸릴 수 있습니다. 이로 인해 배포 속도가 느려집니다. 이 문제가 발생하면 루프에서 중단된 것을 Install-AksHci 볼 수 있습니다. 이 문제를 해결하려면 이 플래그를 사용하세요. 플래그는 -forceDnsReplication 보장된 수정이 아닙니다. 플래그 뒤에 있는 논리가 실패하면 오류가 숨겨지고 플래그가 제공되지 않은 것처럼 명령이 진행됩니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipValidationChecks

환경 인프라 및 사용자 구성 입력의 유효성 검사를 건너뛰려면 이 플래그를 사용합니다. 이러한 검사는 설치를 진행하기 전에 해결해야 할 잠재적인 문제를 강조 표시합니다. 이 설정은 사용하지 않는 것이 좋습니다.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

다음 단계

AksHci PowerShell 참조