빠른 시작: Azure CLI를 사용한 AKS 클러스터용 Azure Linux 컨테이너 호스트 배포

Azure CLI를 사용하여 AKS 클러스터용 Azure Linux 컨테이너 호스트를 배포하여 Azure Linux 컨테이너 호스트를 시작합니다. 필수 구성 요소를 설치한 후 리소스 그룹을 만들고, AKS 클러스터를 만들고, 클러스터에 연결하고, 클러스터에서 샘플 다중 컨테이너 애플리케이션을 실행합니다.

필수 조건

• 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 리소스 그룹은 Azure 리소스가 배포되고 관리되는 논리 그룹입니다. 리소스 그룹을 만들 때는 위치를 지정해야 합니다. 이 위치는 다음과 같습니다.

• 리소스 그룹 메타데이터의 스토리지 위치입니다.
• 리소스를 만드는 동안 다른 지역을 지정하지 않은 경우 리소스가 Azure에서 실행되는 위치입니다.

이름이 testAzureLinuxResourceGroup인 리소스 그룹을 eastus 지역에 만들려면 다음 단계를 수행합니다.

az group create 명령을 사용하여 리소스 그룹을 만듭니다.

az group create --name testAzureLinuxReourceGroup --location eastus

다음 출력은 리소스 그룹이 성공적으로 만들어졌을 경우와 비슷합니다.

{
  "id": "/subscriptions/<guid>/resourceGroups/testAzureLinuxResourceGroup",
  "location": "eastus",
  "managedBy": null,
  "name": "testAzureLinuxResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

참고 항목

위 예제에서는 eastus를 사용했지만 Azure Linux 컨테이너 호스트 클러스터는 모든 지역에서 사용할 수 있습니다.

Azure Linux 컨테이너 호스트 클러스터 만들기

AKS 클러스터를 Azure Linux 이미지로 프로비전하기 위해 az aks create 명령과 --os-sku 매개 변수를 사용하여 AKS 클러스터를 만듭니다. 다음 예제에서는 노드가 하나인 testAzureLinuxCluster라는 Azure Linux 클러스터를 만듭니다.

az aks create --name testAzureLinuxCluster --resource-group testAzureLinuxResourceGroup --os-sku AzureLinux

몇 분 후 명령이 완료되면 클러스터에 대한 JSON 형식 정보가 반환됩니다.

클러스터에 연결

Kubernetes 클러스터를 관리하려면 Kubernetes 명령줄 클라이언트인 kubectl을 사용합니다.

1. az aks get-credentials 명령을 사용하여 Kubernetes 클러스터에 연결하도록 kubectl을 구성합니다.

az aks get-credentials --resource-group testAzureLinuxResourceGroup --name testAzureLinuxCluster

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

  kubectl get pods --all-namespaces

애플리케이션 배포

Kubernetes 매니페스트 파일은 실행할 컨테이너 이미지와 같은 클러스터에 대해 원하는 상태를 정의합니다.

이 빠른 시작에서는 매니페스트를 사용하여 Azure Vote 애플리케이션을 실행하는 데 필요한 모든 개체를 만듭니다. 이 매니페스트에는 다음과 같은 두 개의 Kubernetes 배포가 포함됩니다.

• 샘플 Azure Vote Python 애플리케이션.
• Redis 인스턴스.

다음과 같은 두 개의 Kubernetes 서비스도 생성됩니다.

• Redis 인스턴스에 대한 내부 서비스.
• 인터넷에서 Azure Vote 애플리케이션에 액세스하기 위한 외부 서비스.

1. 파일 azure-vote.yaml을 만들고 다음 매니페스트에 복사합니다.

   • Azure Cloud Shell을 사용하는 경우 이 파일은 가상 또는 실제 시스템에서 작업하고 있는 것처럼 code, vi 또는 nano를 사용하여 만들 수 있습니다.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: azure-vote-back
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: azure-vote-back
     template:
       metadata:
         labels:
           app: azure-vote-back
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
         - name: azure-vote-back
           image: mcr.microsoft.com/oss/bitnami/redis:6.0.8
           env:
           - name: ALLOW_EMPTY_PASSWORD
             value: "yes"
           resources:
             requests:
               cpu: 100m
               memory: 128Mi
             limits:
               cpu: 250m
               memory: 256Mi
           ports:
           - containerPort: 6379
             name: redis
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: azure-vote-back
   spec:
     ports:
     - port: 6379
     selector:
       app: azure-vote-back
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: azure-vote-front
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: azure-vote-front
     template:
       metadata:
         labels:
           app: azure-vote-front
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
         - name: azure-vote-front
           image: mcr.microsoft.com/azuredocs/azure-vote-front:v1
           resources:
             requests:
               cpu: 100m
               memory: 128Mi
             limits:
               cpu: 250m
               memory: 256Mi
           ports:
           - containerPort: 80
           env:
           - name: REDIS
             value: "azure-vote-back"
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: azure-vote-front
   spec:
     type: LoadBalancer
     ports:
     - port: 80
     selector:
       app: azure-vote-front
   

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

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

   kubectl apply -f azure-vote.yaml
   

   다음 예는 성공적으로 만들어진 배포 및 서비스를 보여 주는 출력과 유사합니다.

   deployment "azure-vote-back" created
   service "azure-vote-back" created
   deployment "azure-vote-front" created
   service "azure-vote-front" created
   

애플리케이션 테스트

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

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

kubectl get service azure-vote-front --watch

azure-vote-front 서비스의 EXTERNAL-IP 출력은 처음에 보류 중으로 표시됩니다.

NAME               TYPE           CLUSTER-IP   EXTERNAL-IP   PORT(S)        AGE
azure-vote-front   LoadBalancer   10.0.37.27   <pending>     80:30572/TCP   6s

EXTERNAL-IP 주소가 보류 중에서 실제 공용 IP 주소로 변경되면 CTRL-C를 사용하여 kubectl 조사식 프로세스를 중지합니다. 다음 예제 출력은 서비스에 할당된 유효한 공용 IP 주소를 보여줍니다.

azure-vote-front   LoadBalancer   10.0.37.27   52.179.23.131   80:30572/TCP   2m

Azure Vote 앱이 실제로 작동하는 모습을 보려면 웹 브라우저를 서비스의 외부 IP 주소로 엽니다.

클러스터 삭제

다음 자습서를 계속 진행하지 않으려면 Azure 요금이 불필요한 리소스를 정리하지 않도록 합니다. az group delete 명령을 사용하여 리소스 그룹 및 모든 관련 리소스를 제거합니다.

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

다음 단계

이 빠른 시작에서는 Azure Linux 컨테이너 호스트 클러스터를 배포했습니다. Azure Linux 컨테이너 호스트에 대해 자세히 알아보고 전체 클러스터 배포 및 관리 예제를 살펴보려면 Azure Linux 컨테이너 호스트 자습서를 이어 진행하세요.

Azure Linux 컨테이너 호스트 자습서