PowerShell을 사용하여 AKS(Azure Kubernetes Service) 클러스터에 Windows Server 컨테이너 배포

AKS(Azure Kubernetes Service)는 클러스터를 빠르게 배포하고 관리할 수 있는 관리형 Kubernetes 서비스입니다. 이 문서에서는 Azure PowerShell 사용하여 Windows Server 컨테이너를 실행하는 AKS 클러스터를 배포합니다. 또한 Windows Server 컨테이너의 ASP.NET 샘플 애플리케이션을 클러스터에 배포합니다.

시작하기 전에

이 빠른 시작에서는 Kubernetes 기본 개념을 이해하고 있다고 가정합니다. 자세한 내용은 AKS(Azure Kubernetes Service)의 Kubernetes 핵심 개념을 참조하세요.

• 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 PowerShell을 사용하여 Azure 구독 관리를 참조하세요.

• osSku Windows2025를 사용하는 경우 aks-preview 확장을 설치하고 미리 보기 플래그를 등록해야 합니다.

• OsSKU 매개 변수를 지정하려면 PowerShell Az 모듈 버전 9.2.0 이상이 필요합니다.

aks-preview 확장 설치

1. aks-preview 명령을 사용하여 Azure CLI 확장을 설치합니다az extension add.

az extension add --name aks-preview

1. az extension update 명령을 사용하여 확장의 최신 버전으로 업데이트합니다. Windows Server 2025에는 최소 18.0.0b40이 필요합니다.

az extension update --name aks-preview

AksWindows2025Preview 기능 플래그 등록

1. AksWindows2025Preview[az feature register][az-feature-register] 명령을 사용하여 기능 플래그를 등록합니다.

az feature register --name AksWindows2025Preview --namespace Microsoft.ContainerService

1. [][az feature showaz-feature-show] 명령을 사용하여 등록 상태를 확인합니다. 상태가 Registered로 표시되는 데 몇 분 정도 걸립니다.

az feature show --name AksWindows2025Preview --namespace Microsoft.ContainerService

1. 상태가 등록됨으로 반영되면 [][az-provider-register] 명령을 사용하여 az provider register 리소스 공급자의 등록을 새로 고칩니다.

   az provider register --namespace Microsoft.ContainerService
   

리소스 그룹 만들기

Azure 리소스 그룹은 Azure 리소스가 배포되고 관리되는 논리 그룹입니다. 리소스 그룹을 만들 때 위치를 지정하라는 메시지가 나타납니다. 이 위치는 리소스 그룹 메타데이터가 저장되는 위치이며 리소스를 만드는 동안 다른 지역을 지정하지 않으면 리소스가 Azure에서 실행되는 위치입니다.

• New-AzResourceGroup cmdlet을 사용하여 리소스 그룹을 만듭니다. 다음 예제에서는 미국 동부 지역에 myResourceGroup이라는 리소스 그룹을 만듭니다.

  New-AzResourceGroup -Name myResourceGroup -Location eastus
  

  다음 예제 출력은 리소스 그룹이 성공적으로 생성되었음을 보여줍니다.

  ResourceGroupName : myResourceGroup
  Location          : eastus
  ProvisioningState : Succeeded
  Tags              :
  ResourceId        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup
  

AKS 클러스터 만들기

이 섹션에서는 다음 구성을 사용하여 AKS 클러스터를 만듭니다.

• 클러스터는 안정적으로 작동할 수 있도록 두 개의 노드로 구성됩니다. 노드는 Kubernetes 노드 구성 요소 및 컨테이너 런타임을 실행하는 Azure 가상 머신(VM)입니다.
• -WindowsProfileAdminUserName 및 -WindowsProfileAdminUserPassword 매개 변수는 클러스터의 모든 Windows Server 노드에 대한 관리자 자격 증명을 설정하며 Windows Server 암호 요구 사항을 충족해야 합니다.
• 노드 풀은 VirtualMachineScaleSets를 사용합니다.

다음 단계를 사용하여 Azure PowerShell을 사용하여 AKS 클러스터를 만듭니다.

1. 다음 명령을 사용하여 Windows Server 컨테이너에 대한 관리자 자격 증명을 만듭니다. 이 명령은 WindowsProfileAdminUserName 및 WindowsProfileAdminUserPassword를 입력하라는 메시지를 표시합니다. 암호는 14자 이상이어야 하고 Windows Server 암호 복잡성 요구 사항을 충족해야 합니다.

   $AdminCreds = Get-Credential `
       -Message 'Please create the administrator credentials for your Windows Server containers'
   

2. 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 FAQ를 참조하세요.

   관리자 사용자 이름은 변경할 수 없지만 az aks update를 사용하여 AKS 클러스터가 Windows Server 노드에 사용하는 관리자 암호는 변경할 수 있습니다. 자세한 내용은 Windows Server FAQ를 참조하세요.

   Windows Server 컨테이너의 노드 풀을 지원하는 AKS 클러스터를 실행하려면 클러스터에서 Azure CNI(고급) 네트워크 플러그인을 사용하는 네트워크 정책을 사용해야 합니다. -NetworkPlugin azure 매개 변수는 Azure CNI를 지정합니다.

노드 풀 추가

기본적으로 AKS 클러스터는 Linux 컨테이너를 실행할 수 있는 노드 풀로 생성됩니다. Linux 노드 풀과 함께 Windows Server 컨테이너를 실행할 수 있는 다른 노드 풀을 추가해야 합니다.

Windows 노드 풀을 만들려면 지원되는 OsType 및 OsSku을(를) 지정해야 합니다. 다음 표의 정보를 사용하여 클러스터에 적합한 정보를 확인합니다.

Windows Server 2022는 Kubernetes 버전 1.25-1.35의 기본 운영 체제입니다. Windows Server 2019는 이전 버전의 기본 OS입니다. 특정 OS SKU를 지정하지 않으면 Azure는 클러스터가 사용하는 Kubernetes 버전의 기본 SKU를 사용하여 새 노드 풀을 만듭니다.

• cmdlet 명령을 사용하여 Windows Server 노드 풀을 New-AzAksNodePool 추가합니다. 다음 명령은 npwin이라는 새 노드 풀을 만들고 이를 myAKSCluster에 추가합니다. 또한 이 명령은 New-AzAksCluster를 실행할 때 만들어진 기본 가상 네트워크의 기본 서브넷을 사용합니다.

  New-AzAksNodePool -ResourceGroupName myResourceGroup `
      -ClusterName myAKSCluster `
      -VmSetType VirtualMachineScaleSets `
      -OsType Windows `
      -OsSKU Windows2022 `
      -Name npwin
  

클러스터에 연결

Kubernetes 명령줄 클라이언트인 kubectl을 사용하여 Kubernetes 클러스터를 관리합니다. Azure Cloud Shell을 사용하는 경우 kubectl이 이미 설치되어 있습니다. kubectl을 로컬로 설치하려면 Install-AzAzAksCliTool cmdlet를 사용할 수 있습니다.

1. kubectl cmdlet을 사용하여 Kubernetes 클러스터에 연결하도록 Import-AzAksCredential을 구성합니다. 이 명령은 자격 증명을 다운로드하고 Kubernetes CLI가 해당 자격 증명을 사용하도록 구성합니다.

   Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
   

2. 클러스터 노드 목록을 반환하는 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 클러스터에 지시하는 노드 선택기를 정의해야 합니다.

1. 다음 YAML 정의에서 명명된 sample.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: sample
   

   YAML 매니페스트 파일의 분석은 배포 및 YAML 매니페스트를 참조하세요.

   YAML 파일을 로컬에서 만들고 저장하는 경우 파일 업로드/다운로드 단추를 선택하고 로컬 파일 시스템에서 파일을 선택하여 매니페스트 파일을 CloudShell의 기본 디렉터리에 업로드할 수 있습니다.

2. kubectl apply 명령을 사용하여 애플리케이션을 배포하고 YAML 매니페스트의 이름을 지정합니다.

   kubectl apply -f sample.yaml
   

   다음 예제 출력은 성공적으로 생성된 배포 및 서비스를 보여줍니다.

   deployment.apps/sample created
   service/sample created
   

애플리케이션 테스트

애플리케이션이 실행되면 애플리케이션 프런트 엔드를 인터넷에 공개하는 Kubernetes 서비스가 만들어집니다. 이 프로세스를 완료하는 데 몇 분이 걸릴 수 있습니다. 경우에 따라 서비스를 프로비전하는 데 몇 분 이상 걸릴 수 있습니다. 프로비전하는 데 최대 10분이 걸립니다.

1. 배포된 Pod의 상태는 kubectl get pods 명령을 사용하여 확인합니다. 계속하기 전에 모든 Pod를 Running으로 만듭니다.

   kubectl get pods
   

2. kubectl get service 인수와 함께 --watch 명령을 사용하여 진행률을 모니터링합니다.

   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   6s
   

3. EXTERNAL-IP 주소가 보류 중에서 실제 공용 IP 주소로 변경되면 CTRL-C를 사용하여 kubectl 조사식 프로세스를 중지합니다.

   다음 예제 출력은 서비스에 할당된 유효한 공용 IP 주소를 보여줍니다.

   sample  LoadBalancer   10.0.37.27   52.179.23.131   80:30572/TCP   2m
   

4. 서비스의 외부 IP 주소로 웹 브라우저를 열어 실제 샘플 앱을 확인합니다.

   

리소스 삭제

AKS 자습서를 진행할 계획이 없다면 Azure 요금이 발생하지 않도록 클러스터를 삭제합니다.

• cmdlet을 사용하여 Remove-AzResourceGroup 리소스 그룹, 컨테이너 서비스 및 모든 관련 리소스를 제거합니다.

  Remove-AzResourceGroup -Name myResourceGroup
  

  참고

  AKS 클러스터는 시스템 할당 관리 ID(이 빠른 시작에서 사용된 기본 ID 옵션)를 사용하여 만들어졌습니다. Azure 플랫폼은 이 ID를 관리하므로 제거할 필요가 없습니다.

다음 단계

이 빠른 시작에서는 Kubernetes 클러스터를 배포하고 Windows Server 컨테이너에 ASP.NET 샘플 애플리케이션을 배포했습니다. 이 샘플 응용 프로그램은 데모 목적으로만 사용되며 Kubernetes 응용 프로그램에 대한 모든 모범 사례를 나타내지는 않습니다. 프로덕션용 AKS를 사용하여 전체 솔루션을 만드는 방법에 대한 지침은 AKS 솔루션 지침을 참조하세요.

AKS에 대해 자세히 알아보고 코드부터 배포까지 전체 예제를 연습해 보려면 Kubernetes 클러스터 자습서를 계속 진행합니다.