Set-AksHciConfig
개요
Azure Kubernetes Service 호스트에 대한 구성 설정을 설정하거나 업데이트합니다.
구문
호스트에 대한 구성 설정
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 로컬 클러스터 또는 Windows Server 2019 Datacenter 장애 조치(failover) 클러스터에 배포하는 경우 매개 변수와 -cloudConfigLocation 매개 변수를 -workingDir 지정해야 합니다. 단일 노드 Windows Server 2019 Datacenter의 경우 모든 매개 변수는 선택 사항이며 기본값으로 설정됩니다. 그러나 최적의 성능을 위해 2-4 노드 Azure 로컬 클러스터 배포를 사용하는 것이 좋습니다.
예제
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 이미지를 저장하는 디렉터리의 경로입니다. 이 매개 변수는 필수입니다. 경로는 공유 스토리지 경로(예: SMB 공유)(예: C:\ClusterStorage\Volume2\ImageStore\\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
클라우드 에이전트가 구성을 저장하는 위치입니다. 이 매개 변수는 필수입니다. 경로는 공유 스토리지 경로(예: 또는 SMB 공유(예: C:\ClusterStorage\Volume2\ImageStore\\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