PowerShell을 사용하여 AKS(Azure Kubernetes Service) 클러스터에 Windows Server 컨테이너 배포
AKS(Azure Kubernetes Service)는 클러스터를 빠르게 배포하고 관리할 수 있는 관리형 Kubernetes 서비스입니다. 이 문서에서는 Azure PowerShell 사용하여 Windows Server 컨테이너를 실행하는 AKS 클러스터를 배포합니다. 또한 Windows Server 컨테이너의 ASP.NET 샘플 애플리케이션을 클러스터에 배포합니다.
참고 항목
AKS 클러스터 프로비전을 빠르게 시작하기 위해 이 문서에는 평가 목적으로만 기본 설정으로 클러스터를 배포하는 단계가 포함되어 있습니다. 프로덕션에 즉시 사용 가능한 클러스터를 배포하기 전에 기본 참조 아키텍처를 숙지하여 비즈니스 요구 사항에 어떻게 부합하는지 고려하는 것이 좋습니다.
시작하기 전에
이 빠른 시작에서는 Kubernetes 기본 개념을 이해하고 있다고 가정합니다. 자세한 내용은 AKS(Azure Kubernetes Service)의 Kubernetes 핵심 개념을 참조하세요.
-
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
사용 편의성을 위해 Azure Cloud Shell에서 PowerShell 환경을 사용해 보세요. 자세한 내용은 Azure Cloud Shell에 대한 빠른 시작을 참조하세요.
PowerShell을 로컬에서 사용하려면 Az PowerShell 모듈을 설치하고 Connect-AzAccount cmdlet을 사용하여 Azure 계정에 연결합니다. 관리자 권한으로 명령을 실행해야 합니다. 자세한 내용은 Azure PowerShell 설치를 참조하세요.
클러스터를 만드는 데 사용하는 ID에 적절한 최소 권한이 있는지 확인합니다. AKS의 액세스 및 ID에 대한 자세한 내용은 AKS(Azure Kubernetes Service)에 대한 액세스 및 ID 옵션을 참조하세요.
Azure 구독이 두 개 이상인 경우 Set-AzContext cmdlet을 호출하여 빠른 시작에 사용할 구독을 설정합니다.
리소스 그룹 만들기
Azure 리소스 그룹은 Azure 리소스가 배포되고 관리되는 논리 그룹입니다. 리소스 그룹을 만들 때 위치를 지정하라는 메시지가 나타납니다. 이 위치는 리소스 그룹 메타데이터가 저장되는 위치이며 리소스를 만드는 동안 다른 지역을 지정하지 않으면 리소스가 Azure에서 실행되는 위치입니다.
리소스 그룹을 만들려면 New-AzResourceGroup cmdlet을 사용합니다. 다음 예제에서는 미국 동부 지역에 myResourceGroup이라는 리소스 그룹을 만듭니다.
New-AzResourceGroup -Name myResourceGroup -Location eastus
다음 예제 출력에서는 리소스 그룹이 성공적으로 생성된 것을 보여 줍니다.
ResourceGroupName : myResourceGroup
Location : eastus
ProvisioningState : Succeeded
Tags :
ResourceId : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup
AKS 클러스터 만들기
이 섹션에서는 다음 구성을 사용하여 AKS 클러스터를 만듭니다.
- 클러스터는 안정적으로 작동할 수 있도록 두 개의 노드로 구성됩니다. 노드는 Kubernetes 노드 구성 요소 및 컨테이너 런타임을 실행하는 Azure 가상 머신(VM)입니다.
-WindowsProfileAdminUserName및-WindowsProfileAdminUserPassword매개 변수는 클러스터의 모든 Windows Server 노드에 대한 관리자 자격 증명을 설정하며 Windows Server 암호 요구 사항을 충족해야 합니다.- 노드 풀은
VirtualMachineScaleSets를 사용합니다.
Azure PowerShell을 사용하여 AKS 클러스터를 만들려면 다음 단계를 수행합니다.
다음 명령을 사용하여 Windows Server 컨테이너에 대한 관리자 자격 증명을 만듭니다. 이 명령은
WindowsProfileAdminUserName및WindowsProfileAdminUserPassword을(를) 입력하라는 메시지를 표시합니다. 암호는 14자 이상이어야 하고 Windows Server 암호 복잡성 요구 사항을 충족해야 합니다.$AdminCreds = Get-Credential ` -Message 'Please create the administrator credentials for your Windows Server containers'New-AzAksCluster cmdlet을 사용하여 클러스터를 만들고
WindowsProfileAdminUserName및WindowsProfileAdminUserPassword매개 변수를 지정합니다.New-AzAksCluster -ResourceGroupName myResourceGroup ` -Name myAKSCluster ` -NodeCount 2 ` -NetworkPlugin azure ` -NodeVmSetType VirtualMachineScaleSets ` -WindowsProfileAdminUserName $AdminCreds.UserName ` -WindowsProfileAdminUserPassword $secureString ` -GenerateSshKey몇 분 후 명령이 완료되면 클러스터에 대한 JSON 형식 정보가 반환됩니다. 경우에 따라 클러스터를 프로비전하는 데 몇 분 이상 걸릴 수 있습니다. 프로비전하는 데 최대 10분이 소요됩니다.
암호 유효성 검사 오류가 표시되고 설정한 암호가 길이 및 복잡성 요구 사항을 충족하는 경우 다른 지역에 리소스 그룹을 만들어 보세요. 그런 다음 새 리소스 그룹을 사용하여 클러스터를 만들어 봅니다.
노드 풀을 만들 때 관리자 사용자 이름 및 암호를 지정하지 않으면 사용자 이름은 azureuser로 설정되고 암호는 임의의 값으로 설정됩니다. 자세한 내용은 내 클러스터에서 Windows Server 노드의 관리자 암호를 어떻게 변경하나요?를 참조하세요.
관리자 사용자 이름은 변경할 수 없지만
az aks update를 사용하여 AKS 클러스터가 Windows Server 노드에 사용하는 관리자 암호는 변경할 수 있습니다. 자세한 내용은 Windows Server 노드 풀 FAQ를 참조하세요.Windows Server 컨테이너의 노드 풀을 지원하는 AKS 클러스터를 실행하려면 클러스터에서 [Azure CNI(고급)][azure-cni] 네트워크 플러그인을 사용하는 네트워크 정책을 사용해야 합니다.
-NetworkPlugin azure매개 변수는 Azure CNI를 지정합니다.
노드 풀 추가
기본적으로 AKS 클러스터는 Linux 컨테이너를 실행할 수 있는 노드 풀로 생성됩니다. Linux 노드 풀과 함께 Windows Server 컨테이너를 실행할 수 있는 다른 노드 풀을 추가해야 합니다.
Windows Server 2022는 Kubernetes 버전 1.25.0 이상의 기본 운영 체제입니다. Windows Server 2019는 이전 버전의 기본 OS입니다. 특정 OS SKU를 지정하지 않으면 Azure는 클러스터가 사용하는 Kubernetes 버전의 기본 SKU를 사용하여 새 노드 풀을 만듭니다.
기본 OS SKU를 사용하려면 OS SKU를 지정하지 않고 노드 풀을 만듭니다. 노드 풀은 클러스터의 Kubernetes 버전을 기반으로 기본 운영 체제로 설정됩니다.
New-AzAksNodePool cmdlet을 사용하여 Windows Server 노드 풀을 추가합니다. 다음 명령은 npwin이라는 새 노드 풀을 만들고 이를 myAKSCluster에 추가합니다. 또한 이 명령은 New-AzAksCluster를 실행할 때 만들어진 기본 가상 네트워크의 기본 서브넷을 사용합니다.
New-AzAksNodePool -ResourceGroupName myResourceGroup `
-ClusterName myAKSCluster `
-VmSetType VirtualMachineScaleSets `
-OsType Windows `
-Name npwin
클러스터에 연결
Kubernetes 명령줄 클라이언트인 kubectl을 사용하여 Kubernetes 클러스터를 관리합니다. Azure Cloud Shell을 사용하는 경우 kubectl이 이미 설치되어 있습니다. kubectl을 로컬로 설치하려면 Install-AzAzAksCliTool cmdlet를 사용할 수 있습니다.
Import-AzAksCredential cmdlet을 사용하여 Kubernetes 클러스터에 연결하도록
kubectl을 구성합니다. 이 명령은 자격 증명을 다운로드하고 Kubernetes CLI가 해당 자격 증명을 사용하도록 구성합니다.Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster클러스터 노드 목록을 반환하는 kubectl get 명령을 사용하여 클러스터에 대한 연결을 확인합니다.
kubectl get nodes다음 샘플 출력은 클러스터의 모든 노드를 보여 줍니다. 모든 노드의 상태가 준비인지 확인합니다.
NAME STATUS ROLES AGE VERSION aks-nodepool1-20786768-vmss000000 Ready agent 22h v1.27.7 aks-nodepool1-20786768-vmss000001 Ready agent 22h v1.27.7 aksnpwin000000 Ready agent 21h v1.27.7
애플리케이션 배포
Kubernetes 매니페스트 파일은 어떤 컨테이너 이미지가 실행되는지 등과 같은 클러스터에 대해 원하는 상태를 정의합니다. 이 문서에서는 매니페스트를 사용하여 Windows Server 컨테이너에서 ASP.NET 샘플 애플리케이션을 실행하는 데 필요한 모든 개체를 만듭니다. 이 매니페스트에는 ASP.NET 샘플 응용 프로그램에 대한 Kubernetes 배포 및 인터넷에서 응용 프로그램에 액세스하는 외부 Kubernetes 서비스가 포함되어 있습니다.
ASP.NET 샘플 응용 프로그램은 .NET Framework 샘플의 일부로 제공되며 Windows Server 컨테이너에서 실행됩니다. AKS를 사용하려면 Windows Server 컨테이너가 Windows Server 2019 이상의 이미지를 기반으로 해야 합니다. 또한 Kubernetes 매니페스트 파일은 Windows Server 컨테이너를 실행할 수 있는 노드에서 ASP.NET 샘플 응용 프로그램의 Pod를 실행하도록 AKS 클러스터에 지시하는 노드 선택기를 정의해야 합니다.
sample.yaml이라는 파일을 만들고 다음 YAML 정의에 복사합니다.apiVersion: apps/v1 kind: Deployment metadata: name: sample labels: app: sample spec: replicas: 1 template: metadata: name: sample labels: app: sample spec: nodeSelector: "kubernetes.io/os": windows containers: - name: sample image: mcr.microsoft.com/dotnet/framework/samples:aspnetapp resources: limits: cpu: 1 memory: 800M ports: - containerPort: 80 selector: matchLabels: app: sample --- apiVersion: v1 kind: Service metadata: name: sample spec: type: LoadBalancer ports: - protocol: TCP port: 80 selector: app: sampleYAML 매니페스트 파일의 분석은 배포 및 YAML 매니페스트를 참조하세요.
YAML 파일을 로컬에서 만들고 저장하는 경우 파일 업로드/다운로드 단추를 선택하고 로컬 파일 시스템에서 파일을 선택하여 매니페스트 파일을 CloudShell의 기본 디렉터리에 업로드할 수 있습니다.
kubectl apply 명령을 사용하여 애플리케이션을 배포하고 YAML 매니페스트의 이름을 지정합니다.
kubectl apply -f sample.yaml다음 샘플 출력은 성공적으로 생성된 배포 및 서비스를 보여 줍니다.
deployment.apps/sample created service/sample created
애플리케이션 테스트
애플리케이션이 실행되면 애플리케이션 프런트 엔드를 인터넷에 공개하는 Kubernetes 서비스가 만들어집니다. 이 프로세스를 완료하는 데 몇 분이 걸릴 수 있습니다. 경우에 따라 서비스를 프로비전하는 데 몇 분 이상 걸릴 수 있습니다. 프로비전하는 데 최대 10분이 소요됩니다.
배포된 Pod의 상태는 kubectl get pods 명령을 사용하여 확인합니다. 계속하기 전에 모든 Pod를
Running으로 만듭니다.kubectl get pods--watch인수와 함께 kubectl get service 명령을 사용하여 진행 상황을 모니터링합니다.kubectl get service sample --watch처음에는 출력에 샘플 서비스의 EXTERNAL-IP가 보류 중으로 표시됩니다.
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE sample LoadBalancer 10.0.37.27 <pending> 80:30572/TCP 6sEXTERNAL-IP 주소가 보류 중에서 실제 공용 IP 주소로 변경되면
CTRL-C를 사용하여kubectl조사식 프로세스를 중지합니다. 다음 샘플 출력은 서비스에 할당된 유효한 공용 IP 주소를 보여 줍니다.sample LoadBalancer 10.0.37.27 52.179.23.131 80:30572/TCP 2m서비스의 외부 IP 주소로 웹 브라우저를 열어 실제 샘플 앱을 확인합니다.
리소스 삭제
AKS 자습서를 진행할 계획이 없다면 Azure 요금이 발생하지 않도록 클러스터를 삭제합니다. Remove-AzResourceGroup cmdlet을 사용하여 리소스 그룹, 컨테이너 서비스 및 모든 관련 리소스를 제거합니다.
Remove-AzResourceGroup -Name myResourceGroup
참고 항목
AKS 클러스터는 시스템 할당 관리 ID(이 빠른 시작에서 사용된 기본 ID 옵션)를 사용하여 만들어졌습니다. Azure 플랫폼은 이 ID를 관리하므로 제거할 필요가 없습니다.
다음 단계
이 빠른 시작에서는 Kubernetes 클러스터를 배포하고 Windows Server 컨테이너에 ASP.NET 샘플 애플리케이션을 배포했습니다. 이 샘플 응용 프로그램은 데모 목적으로만 사용되며 Kubernetes 응용 프로그램에 대한 모든 모범 사례를 나타내지는 않습니다. 프로덕션용 AKS를 사용하여 전체 솔루션을 만드는 방법에 대한 지침은 AKS 솔루션 지침을 참조하세요.
AKS에 대해 자세히 알아보고 코드부터 배포까지 전체 예제를 연습해 보려면 Kubernetes 클러스터 자습서를 계속 진행합니다.