PowerShell을 사용하여 사전 준비된 클러스터 서비스 개체 및 DNS 레코드를 사용하여 Azure Kubernetes Service 호스트 배포

적용 대상: Azure Stack HCI의 AKS, Windows Server의 AKS

이 방법 가이드에서는 AKS 하이브리드에 미리 준비된 클러스터 서비스 개체 및 DNS 레코드가 있는 경우 PowerShell을 사용하여 AKS 호스트 배포를 구성하는 방법을 알아봅니다.

시작하기 전에

1단계: 배포를 위해 Active Directory 및 DNS 서버 준비

AKS 하이브리드가 검색을 위해 Active Directory 및 DNS 시스템에 클라우드 에이전트 일반 클러스터 이름을 등록할 수 있도록 DNS 환경에서 동적 DNS 업데이트를 사용하도록 설정할 수 없는 경우 Active Directory 및 DNS에서 해당 레코드를 미리 만들어야 합니다.

이름 ca-cloudagent (또는 32자를 초과하지 않는 선택한 이름)을 사용하여 Active Directory에서 일반 클러스터 서비스를 만듭니다. 또한 제공 cloudservicecidr 된 주소를 사용하여 일반 클러스터 서비스의 FQDN을 가리키는 연결된 DNS 레코드를 만들어야 합니다. 이 프로세스의 단계에 대한 자세한 내용은 장애 조치(failover) 클러스터링 설명서에서 확인할 수 있습니다.

AKS 배포는 배포를 계속하기 전에 Active Directory에서 지정된 clusterRoleName 를 찾으려고 시도합니다.

참고

AKS가 배포되면 이 정보를 변경할 수 없습니다.

2단계: 배포를 위해 머신 준비

모든 물리적 노드에서 검사를 실행하여 AKS 하이브리드를 설치하기 위해 모든 요구 사항이 충족되는지 확인합니다. 관리자 권한으로 PowerShell을 열고 다음 Initialize-AksHciNode 명령을 실행합니다.

Initialize-AksHciNode

3단계: 가상 네트워크 만들기

배포에서 사용할 노드에 대한 가상 네트워크를 만들려면 New-AksHciNetworkSetting PowerShell 명령을 사용하여 환경 변수를 만듭니다. 나중에 고정 IP를 사용하는 배포를 구성하는 데 사용됩니다. DHCP를 사용하여 AKS 배포를 구성하려면 New-AksHciNetworkSetting 을 참조하세요. 일부 네트워킹 노드 개념을 검토할 수도 있습니다.

#static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -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" 

참고

환경에 대한 이 예제 명령에 지정된 값을 사용자 지정해야 합니다.

4단계: 사전 준비된 클러스터 서비스 개체 및 DNS 레코드를 사용하여 배포 구성

Set-AksHciConfig 명령을 사용하여 Azure Kubernetes Service 호스트에 대한 구성 설정을 지정합니다. , , cloudServiceCidrcloudConfigLocationclusterRoleName 매개 변수를 workingDir지정해야 합니다. 구성 세부 정보를 다시 설정하려면 새 매개 변수를 사용하여 명령을 다시 실행합니다.

다음 명령을 사용하여 배포를 구성합니다.

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

참고

환경에 대한 이 예제 명령에 지정된 값을 사용자 지정해야 합니다.

5단계: Azure에 로그인하고 등록 설정 구성

구독 및 리소스 그룹 이름으로 다음 Set-AksHciRegistration PowerShell 명령을 실행하여 Azure에 로그인합니다. 계속하려면 Azure 구독과 미국 동부, 동남 아시아 또는 서유럽 Azure 지역에 기존 Azure 리소스 그룹이 있어야 합니다.

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

5단계: 새 배포 시작

배포를 구성한 후에는 배포를 시작해야 합니다. 배포를 시작하면 AKS 하이브리드 에이전트/서비스 및 AKS 호스트가 설치됩니다. 배포를 시작하려면 다음 명령을 실행합니다.

Install-AksHci

경고

Azure Kubernetes Service 호스트를 설치하는 동안 등록 중에 설정된 리소스 그룹에 Kubernetes - Azure Arc 리소스 종류가 만들어집니다. 이 리소스는 Azure Kubernetes Service 호스트를 나타내기 때문에 삭제하지 마세요. 해당 배포 필드에 값 aks_management이 있는지 확인하여 리소스를 식별할 수 있습니다. 이 리소스를 삭제하면 정책 외 배포가 발생합니다.

이 방법 가이드에서는 사전 준비된 클러스터 서비스 개체 및 DNS 레코드가 있는 경우 PowerShell을 사용하여 Azure Kubernetes Service 호스트를 설정하는 방법을 알아보았습니다.

다음 단계