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

아티클
03/10/2024

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

참고 항목

AKS 클러스터 프로비전을 빠르게 시작하기 위해 이 문서에는 평가 목적으로만 기본 설정으로 클러스터를 배포하는 단계가 포함되어 있습니다. 프로덕션에 즉시 사용 가능한 클러스터를 배포하기 전에 기본 참조 아키텍처를 숙지하여 비즈니스 요구 사항에 어떻게 부합하는지 고려하는 것이 좋습니다.

시작하기 전에

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

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
- 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.
- 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.
- az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

이 문서에는 Azure CLI 버전 2.0.64 이상이 필요합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
클러스터를 만드는 데 사용하는 ID에 적절한 최소 권한이 있는지 확인합니다. AKS의 액세스 및 ID에 대한 자세한 내용은 AKS(Azure Kubernetes Service)에 대한 액세스 및 ID 옵션을 참조하세요.
Azure 구독이 여러 개인 경우 az account set 명령을 사용하여 리소스가 청구되어야 하는 적절한 구독 ID를 선택합니다.

리소스 그룹 만들기

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

az group create 명령을 사용하여 리소스 그룹을 만듭니다. 다음 예제에서는 eastus 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다. 이 명령과 이 문서의 다른 명령을 BASH 셸에 입력합니다.
```
az group create --name myResourceGroup --location eastus
```
다음 샘플 출력은 성공적으로 만들어진 리소스 그룹을 보여 줍니다.
```
{
  "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
  "location": "eastus",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": null
}
```

AKS 클러스터 만들기

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

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

Azure CLI를 사용하여 AKS 클러스터를 만들려면 다음 단계를 수행합니다.

클러스터에서 Windows Server 노드의 관리자 자격 증명으로 사용할 사용자 이름을 만듭니다. 다음 명령은 사용자 이름을 입력하라는 메시지를 표시하며 WINDOWS_USERNAME으로 설정한 후 이후 명령에서 사용합니다.
```
echo "Please enter the username to use as administrator credentials for Windows Server nodes on your cluster: " && read WINDOWS_USERNAME
```
이전 단계에서 만든 관리자 사용자 이름에 대한 암호를 만듭니다. 암호는 14자 이상이어야 하고 Windows Server 암호 복잡성 요구 사항을 충족해야 합니다.
```
echo "Please enter the password to use as administrator credentials for Windows Server nodes on your cluster: " && read WINDOWS_PASSWORD
```
az aks create 명령을 사용하여 클러스터를 만들고 --windows-admin-username 및 --windows-admin-password 매개 변수를 지정합니다. 다음 예제 명령은 이전 명령에서 설정한 WINDOWS_USERNAME의 값을 사용하여 클러스터를 만듭니다. 또는 WINDOWS_USERNAME을 사용하는 대신 매개 변수에 다른 사용자 이름을 직접 제공할 수 있습니다.
```
az aks create \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --node-count 2 \
    --enable-addons monitoring \
    --generate-ssh-keys \
    --windows-admin-username $WINDOWS_USERNAME \
    --windows-admin-password $WINDOWS_PASSWORD \
    --vm-set-type VirtualMachineScaleSets \
    --network-plugin azure
```
몇 분 후 명령이 완료되면 클러스터에 대한 JSON 형식 정보가 반환됩니다. 경우에 따라 클러스터를 프로비전하는 데 몇 분 이상 걸릴 수 있습니다. 프로비전하는 데 최대 10분이 소요됩니다.

암호 유효성 검사 오류가 표시되고 설정한 암호가 길이 및 복잡성 요구 사항을 충족하는 경우 다른 지역에 리소스 그룹을 만들어 보세요. 그런 다음 새 리소스 그룹을 사용하여 클러스터를 만들어 봅니다.

노드 풀을 만들 때 관리자 사용자 이름 및 암호를 지정하지 않으면 사용자 이름은 azureuser로 설정되고 암호는 임의의 값으로 설정됩니다. 자세한 내용은 내 클러스터에서 Windows Server 노드의 관리자 암호를 어떻게 변경하나요?를 참조하세요.

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

Windows Server 컨테이너의 노드 풀을 지원하는 AKS 클러스터를 실행하려면 클러스터에서 Azure CNI(고급) 네트워크 플러그인을 사용하는 네트워크 정책을 사용해야 합니다. --network-plugin 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 버전을 기반으로 기본 운영 체제로 설정됩니다.

az aks nodepool add 명령을 사용하여 Windows 노드 풀을 추가합니다. 다음 명령은 npwin이라는 새 노드 풀을 만들고 이를 myAKSCluster에 추가합니다. 또한 이 명령은 az aks create를 실행할 때 만들어진 기본 가상 네트워크의 기본 서브넷을 사용합니다. OS SKU가 지정되지 않았으므로 노드 풀은 클러스터의 Kubernetes 버전을 기반으로 기본 운영 체제로 설정됩니다.

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --os-type Windows \
    --name npwin \
    --node-count 1

Windows Server 2022를 사용하려면 다음 매개 변수를 지정합니다.

Windows로 설정된 os-type
Windows2022로 설정된 os-sku

참고 항목

Windows Server 2022에는 Kubernetes 버전 1.23.0 이상이 필요합니다. Windows Server 2022는 Kubernetes 버전 1.34가 EOL(수명 종료)에 도달하면 사용 중지될 예정입니다. 이 사용 중지에 대한 자세한 내용은 AKS 릴리스 정보를 참조하세요.

az aks nodepool add 명령을 사용하여 Windows Server 2022 노드 풀을 추가합니다.

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --os-type Windows \
    --os-sku Windows2022 \
    --name npwin \
    --node-count 1

Windows Server 2019를 사용하려면 다음 매개 변수를 지정합니다.

Windows로 설정된 os-type
Windows2019로 설정된 os-sku

참고 항목

Windows Server 2019는 Kubernetes 버전 1.32가 EOL(수명 종료)에 도달한 후 사용 중지되며 향후 릴리스에서 지원되지 않습니다. 이 사용 중지에 대한 자세한 내용은 AKS 릴리스 정보를 참조하세요.

az aks nodepool add 명령을 사용하여 Windows Server 2019 노드 풀을 추가합니다.

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --os-type Windows \
    --os-sku Windows2019 \
    --name npwin \
    --node-count 1

클러스터에 연결

Kubernetes 명령줄 클라이언트인 kubectl을 사용하여 Kubernetes 클러스터를 관리합니다. Azure Cloud Shell을 사용하는 경우 kubectl이 이미 설치되어 있습니다. kubectl을 로컬로 설치하고 실행하려면 az aks install-cli 명령을 호출합니다.

az aks get-credentials 명령을 사용하여 Kubernetes 클러스터에 연결하도록 kubectl을 구성합니다. 이 명령은 자격 증명을 다운로드하고 Kubernetes CLI가 해당 자격 증명을 사용하도록 구성합니다.
```
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
```

클러스터 노드 목록을 반환하는 kubectl get 명령을 사용하여 클러스터에 대한 연결을 확인합니다.

kubectl get nodes -o wide

다음 샘플 출력은 클러스터의 모든 노드를 보여 줍니다. 모든 노드의 상태가 준비인지 확인합니다.

NAME                                STATUS   ROLES   AGE   VERSION   INTERNAL-IP   EXTERNAL-IP   OS-IMAGE                         KERNEL-VERSION      CONTAINER-RUNTIME
aks-nodepool1-20786768-vmss000000   Ready    agent   22h   v1.27.7   10.224.0.4    <none>        Ubuntu 22.04.3 LTS               5.15.0-1052-azure   containerd://1.7.5-1
aks-nodepool1-20786768-vmss000001   Ready    agent   22h   v1.27.7   10.224.0.33   <none>        Ubuntu 22.04.3 LTS               5.15.0-1052-azure   containerd://1.7.5-1
aksnpwin000000                      Ready    agent   20h   v1.27.7   10.224.0.62   <none>        Windows Server 2022 Datacenter   10.0.20348.2159     containerd://1.6.21+azure

참고 항목

각 노드 풀에 대한 컨테이너 런타임은 CONTAINER-RUNTIME 아래에 표시됩니다. 컨테이너 런타임 값은 containerd://로 시작합니다. 이는 각각 컨테이너 런타임에 containerd를 사용한다는 의미입니다.

애플리케이션 배포

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: sample

YAML 매니페스트 파일의 분석은 배포 및 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   6s
```
EXTERNAL-IP 주소가 보류 중에서 실제 공용 IP 주소로 변경되면 CTRL-C를 사용하여 kubectl 조사식 프로세스를 중지합니다. 다음 샘플 출력은 서비스에 할당된 유효한 공용 IP 주소를 보여 줍니다.
```
sample  LoadBalancer   10.0.37.27   52.179.23.131   80:30572/TCP   2m
```
서비스의 외부 IP 주소로 웹 브라우저를 열어 실제 샘플 앱을 확인합니다.

리소스 삭제

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

az group delete 명령을 사용하여 리소스 그룹, 컨테이너 서비스 및 모든 관련 리소스를 삭제합니다.

az group delete --name myResourceGroup --yes --no-wait

참고 항목

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

다음 단계

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

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

AKS 자습서

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

시작하기 전에

리소스 그룹 만들기

AKS 클러스터 만들기

노드 풀 추가

클러스터에 연결

애플리케이션 배포

애플리케이션 테스트

리소스 삭제

다음 단계

추가 리소스