🚀 Azure Kubernetes Service(AKS) 설치 방법 가이드
🔹 AKS(Azure Kubernetes Service)란?
AKS(Azure Kubernetes Service)는 Azure에서 제공하는 관리형 Kubernetes 서비스입니다.
AKS를 사용하면 마스터 노드는 Azure에서 관리하고, 사용자는 워커 노드만 운영하면 됩니다.
즉, Kubernetes 클러스터를 빠르고 쉽게 구축할 수 있도록 도와주는 서비스입니다.
✅ AKS 설치 방법
AKS는 Azure CLI, Azure Portal, Terraform, Bicep 등 다양한 방법으로 설치할 수 있습니다.
이 문서에서는 Azure CLI를 사용한 설치 방법을 설명합니다.
✔ 설치 방식:
1. Azure CLI를 사용하여 AKS 클러스터 생성
2. 필요한 네트워크 및 리소스 그룹 설정
3. kubectl을 사용하여 Kubernetes 클러스터 접속 및 확인
✅ 1. Azure CLI를 사용한 AKS 설치 (기본 설정)
📌 (1) Azure 로그인
먼저, Azure에 로그인합니다.
az login
✔ 브라우저가 열리면 Azure 계정 정보를 입력하여 로그인 완료
✔ CLI에서 로그인된 계정 및 구독 정보 출력 확인 가능
📌 (2) Azure 구독 확인 및 설정 (필요한 경우)
여러 개의 구독이 있는 경우, AKS를 생성할 구독을 선택합니다.
az account list --output table
az account set --subscription "<SUBSCRIPTION_ID>"
✔ 올바른 구독이 선택되었는지 확인하려면:
az account show --output table
📌 (3) 리소스 그룹 생성
AKS 클러스터를 배포할 리소스 그룹을 생성합니다.
az group create --name MyResourceGroup --location eastus
✔ MyResourceGroup → 원하는 리소스 그룹 이름
✔ eastus → 원하는 Azure 리전 선택 (ex. koreacentral, westus2 등)
📌 (4) AKS 클러스터 생성
AKS 클러스터를 생성합니다.
az aks create \
--resource-group MyResourceGroup \
--name MyAKSCluster \
--node-count 3 \
--enable-addons monitoring \
--enable-managed-identity \
--generate-ssh-keys
✔ 설명:
- --resource-group → AKS를 설치할 리소스 그룹 지정
- --name → 클러스터 이름 지정 (MyAKSCluster)
- --node-count 3 → 기본 워커 노드 개수(3개)
- --enable-addons monitoring → Azure Monitor(로그 분석) 활성화
- --enable-managed-identity → AKS에 Azure Managed Identity 설정
- --generate-ssh-keys → 기본 SSH 키 생성
✔ AKS 설치에는 몇 분 정도 소요됨.
📌 (5) AKS 클러스터 연결 (kubectl 설정)
AKS 설치가 완료되면, kubectl을 사용하여 클러스터에 연결합니다.
az aks get-credentials --resource-group MyResourceGroup --name MyAKSCluster
✔ 설명:
- AKS 클러스터의 kubeconfig를 자동으로 가져와서 kubectl과 연결
✔ 정상 연결 확인:
kubectl get nodes
✔ 출력 예시:
NAME STATUS ROLES AGE VERSION
aks-nodepool1-12345678-0 Ready agent 10m v1.28.0
aks-nodepool1-12345678-1 Ready agent 10m v1.28.0
aks-nodepool1-12345678-2 Ready agent 10m v1.28.0
✅ AKS 클러스터가 정상적으로 설치되었고, 워커 노드가 정상적으로 동작 중!
✅ 2. 추가 옵션을 포함한 AKS 설치 (고급 설정)
기본적인 AKS 클러스터 설치 외에도, 추가 설정이 필요한 경우 아래 옵션을 참고하세요.
📌 (1) 특정 Kubernetes 버전 지정하여 설치
az aks create \
--resource-group MyResourceGroup \
--name MyAKSCluster \
--node-count 3 \
--kubernetes-version 1.27.3 \
--generate-ssh-keys
✅ 설명:
- --kubernetes-version 옵션을 사용하여 특정 버전의 Kubernetes 설치 가능
- az aks get-versions --location eastus --output table 명령어로 사용 가능한 Kubernetes 버전 조회 가능
📌 (2) 특정 VM 크기(노드 타입) 설정
기본적으로 AKS의 노드 VM 크기는 Standard_D2s_v3입니다.
다른 VM 크기를 사용하려면 아래처럼 설정하면 됩니다.
az aks create \
--resource-group MyResourceGroup \
--name MyAKSCluster \
--node-vm-size Standard_D4s_v3 \
--node-count 3
✅ 설명:
- Standard_D4s_v3 → 4 vCPU, 16GB RAM의 Azure VM 크기를 지정
- az vm list-sizes --location eastus --output table 명령어로 사용 가능한 VM 크기 확인 가능
📌 (3) 특정 가용 영역(Azure Availability Zones) 설정
az aks create \
--resource-group MyResourceGroup \
--name MyAKSCluster \
--node-count 3 \
--zones 1 2 3
✅ 설명:
- --zones 1 2 3 옵션을 사용하면 AKS 노드가 3개의 가용 영역에 분산 배치됨
- Azure 리전별로 지원되는 가용 영역 확인 필요
📌 (4) AKS 클러스터 삭제
az aks delete --resource-group MyResourceGroup --name MyAKSCluster --yes --no-wait
✅ 설명:
- --yes → 삭제 확인을 묻지 않고 진행
- --no-wait → 비동기 삭제 진행 (즉시 CLI 반환)
🚀 결론: AKS 설치 방법 정리
설치 단계명령어
Azure CLI 로그인 | az login |
구독 확인 및 설정 | az account set --subscription "<SUBSCRIPTION_ID>" |
리소스 그룹 생성 | az group create --name MyResourceGroup --location eastus |
기본 AKS 클러스터 설치 | az aks create --resource-group MyResourceGroup --name MyAKSCluster --node-count 3 --generate-ssh-keys |
AKS 클러스터 연결 | az aks get-credentials --resource-group MyResourceGroup --name MyAKSCluster |
클러스터 확인 | kubectl get nodes |
AKS 클러스터 삭제 | az aks delete --resource-group MyResourceGroup --name MyAKSCluster --yes |
✅ Azure CLI를 사용하여 손쉽게 AKS 클러스터를 설치하고 Kubernetes를 운영할 수 있음
✅ 추가적인 설정(노드 크기 변경, 가용 영역 배포, 특정 버전 설치)도 가능
📌 이제 Azure AKS 클러스터를 빠르게 생성하고 Kubernetes 환경을 구축하세요! 🚀