다음을 통해 공유


자습서: Azure Kubernetes Service와 함께 사용할 Azure 컨테이너 스토리지 설치

Azure Container Storage는 기본적으로 컨테이너용으로 구축된 클라우드 기반 볼륨 관리, 배포 및 오케스트레이션 서비스입니다. 이 자습서를 사용하여 새 클러스터를 만들거나 기존 배포에서 서비스를 사용하도록 설정하든 관계없이 AKS(Azure Kubernetes Service) 클러스터에 최신 프로덕션 버전의 Azure Container Storage를 설치합니다.

Azure Container Storage의 오픈 소스 버전을 선호하는 경우 대체 설치 지침 은 local-csi-driver 리포지토리를 방문하세요.

중요합니다

이 문서는 Azure Container Storage(버전 2.x.x)에 적용됩니다. 이전 버전의 경우 Azure Container Storage(버전 1.x.x) 설명서를 참조하세요. AKS 클러스터에 Azure Container Storage(버전 1.x.x)가 이미 설치된 경우 다음 단계에 따라 제거합니다.

  • Azure CLI 환경 준비
  • 클러스터에 대한 리소스 그룹 만들기 또는 선택
  • 노드 풀 가상 머신 유형이 설치 조건을 충족하는지 확인
  • 새 AKS 클러스터를 만들거나 기존 클러스터에서 사용하도록 설정하여 Azure Container Storage 설치

필수 조건

  • Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.

  • 이 문서에는 Azure CLI의 최신 버전(2.77.0 이상)이 필요합니다. Azure CLI를 설치하는 방법을 참조하세요. Cloud Shell에서 사용할 수 없으므로 az upgrade Azure Cloud Shell을 사용하지 마세요. 이 문서의 명령을 관리자 권한으로 실행해야 합니다. 같은 aks-preview일부 Azure CLI 확장은 필요한 명령 플래그와 충돌할 수 있습니다. 문제가 발생하는 경우 사용하지 않도록 설정합니다.

  • Kubernetes 명령줄 클라이언트가 kubectl필요합니다. 명령어 az aks install-cli을(를) 실행하여 로컬에 설치할 수 있습니다.

  • 대상 지역이 Azure 컨테이너 스토리지 지역에서 지원되는지 확인합니다.

  • az login 명령을 사용하여 Azure에 로그인합니다.

필요한 확장 설치

다음 명령을 실행하여 최신 버전의 k8s-extension을 추가하거나 업그레이드합니다.

az extension add --upgrade --name k8s-extension

구독 컨텍스트 설정

az account set 명령을 사용하여 Azure 구독 컨텍스트를 설정합니다. az account list --output table 명령을 실행하여 액세스할 수 있는 모든 구독에 대한 구독 ID를 볼 수 있습니다. <subscription-id>를 구독 ID로 바꿉니다.

az account set --subscription <subscription-id>

리소스 그룹 만들기

Azure 리소스 그룹은 그룹으로 관리하려는 Azure 리소스를 보유하는 논리 그룹입니다. 리소스 그룹을 만들 때 위치를 지정하라는 메시지가 표시됩니다. 이 위치는 다음과 같습니다.

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

az group create 명령을 사용하여 리소스 그룹을 만듭니다. <resource-group-name>을 만들려는 리소스 그룹의 이름으로 바꾸고 <___location>eastus, westus2, westus3 또는 westeurope과 같은 Azure 지역으로 바꿉니다. 기존 AKS 클러스터에서 Azure Container Storage를 사용하도록 설정하는 경우 클러스터를 이미 호스트하는 리소스 그룹을 사용합니다.

az group create --name <resource-group-name> --___location <___location>

리소스 그룹을 성공적으로 만든 경우 다음 예제와 유사한 출력이 표시됩니다.

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

클러스터의 VM 유형이 설치 조건을 충족하는지 확인합니다.

클러스터 노드에 대한 가상 머신 유형을 선택할 때 다음 지침을 따릅니다.

  • 로컬 NVMe 데이터 디스크를 지원하는 가상 머신 SKU(예: 스토리지 최적화 VM 또는 GPU 가속 VM)를 선택합니다.
  • 노드 풀의 VM에 대한 OS 유형을 Linux OS로 선택합니다. Windows OS는 현재 지원되지 않습니다.
  • 기존 클러스터의 경우 Azure Container Storage를 사용하도록 설정하기 전에 노드 풀이 이미 지원되는 VM SKU를 사용하고 있는지 확인합니다.

AKS 클러스터에 Azure Container Storage 설치

사용자 환경과 일치하는 시나리오를 선택합니다.

옵션 1: Azure Container Storage를 사용하도록 설정된 새 AKS 클러스터 만들기

다음 명령을 실행하여 새 AKS 클러스터를 만들고 Azure Container Storage를 설치합니다. <cluster-name><resource-group>을 고유한 값으로 바꾸고 사용할 VM 유형을 지정합니다.

az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_L8s_v3 --enable-azure-container-storage --generate-ssh-keys

배포에는 5-10분이 걸립니다. 완료되면 Azure Container Storage가 설치된 AKS 클러스터와 로컬 NVMe 스토리지 유형의 구성 요소가 배포됩니다.

옵션 2: 기존 AKS 클러스터에서 Azure Container Storage 사용

다음 명령을 실행하여 기존 AKS 클러스터에서 Azure Container Storage를 사용하도록 설정합니다. <cluster-name><resource-group>를 사용자 고유의 값으로 바꿉니다.

az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage

배포에는 5-10분이 걸립니다. 완료되면 대상 AKS 클러스터에 Azure Container Storage가 설치되고 로컬 NVMe 스토리지 유형의 구성 요소가 배포됩니다.

클러스터에 연결하고 상태 확인

설치 후 클러스터에 연결하고 노드가 준비되었는지 확인하도록 구성 kubectl 합니다.

  1. 클러스터 자격 증명을 다운로드하고 이를 사용하도록 Kubernetes CLI를 구성합니다. 기본적으로 자격 증명은 .에 ~/.kube/config저장됩니다. 필요한 경우 인수를 --file 사용하여 다른 경로를 제공합니다.

    az aks get-credentials --resource-group <resource-group> --name <cluster-name>
    
  2. 클러스터 노드를 나열하여 연결을 확인합니다.

    kubectl get nodes
    
  3. 모든 노드가 다음 출력과 유사한 상태를 Ready보고하는지 확인합니다.

    NAME                                STATUS   ROLES   AGE   VERSION
    aks-nodepool1-34832848-vmss000000   Ready    agent   80m   v1.32.6
    aks-nodepool1-34832848-vmss000001   Ready    agent   80m   v1.32.6
    aks-nodepool1-34832848-vmss000002   Ready    agent   80m   v1.32.6
    

다음 단계