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

  • 아티클

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

이 방법 가이드에서는 Azure Arc에서 사용하도록 설정된 AKS에서 미리 준비된 클러스터 서비스 개체 및 DNS 레코드가 있는 경우 PowerShell을 사용하여 AKS 호스트 배포를 구성하는 방법을 설명합니다.

시작하기 전에

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

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

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

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

참고

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

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

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

Initialize-AksHciNode

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

배포에서 사용할 노드에 대한 가상 네트워크를 만들려면 PowerShell 명령을 사용하여 환경 변수를 New-AksHciNetworkSetting 만듭니다. 이 변수는 나중에 고정 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 명령을 사용하여 AKS 호스트에 대한 구성 설정을 지정합니다. , , cloudServiceCidr및 cloudConfigLocationclusterRoleName 매개 변수를 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>"

6단계: 새 배포 시작

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

Install-AksHci

경고

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

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

다음 단계