Bookinfo 샘플 애플리케이션 배포

이 문서에서는 AKS 클러스터에 Istio 서비스 메시 추가 기능을 설치하고 Bookinfo 샘플 애플리케이션을 배포하는 방법을 설명합니다.

사전 요구 사항

AKS 클러스터가 생성되어 있어야 합니다 (클러스터 구성 참조)
Azure CLI 버전 2.57.0 이상
kubectl CLI 도구
AKS 클러스터 버전 1.23 이상

Istio 환경 구성

1. aks-preview 확장 설치

# aks-preview 확장 설치 및 업데이트
az extension add --name aks-preview
az extension update --name aks-preview

2. 사용 가능한 Istio 수정 버전 확인

# 지역별 사용 가능한 Istio 수정 버전 확인
az aks mesh get-revisions --location $LOCATION -o table

출력 예시:

MeshRevision    Upgrades           CompatibleWith
--------------  -----------------  ----------------
asm-1-24        -                  1.29, 1.30, 1.31
asm-1-23        asm-1-24           1.28, 1.29, 1.30
asm-1-22        asm-1-23, asm-1-24 1.27, 1.28, 1.29

정보

수정 버전(Revision)은 Istio의 특정 버전을 나타냅니다. AKS는 여러 Istio 버전을 지원하며, 클러스터의 Kubernetes 버전과 호환되는 수정 버전을 선택할 수 있습니다.

3. 기존 Istio 리소스 정리 (필요한 경우)

기존에 자체 관리형 Istio를 설치한 경우, CRD 및 관련 리소스를 정리합니다:

# 기존 Istio CRD 삭제
kubectl delete crd $(kubectl get crd -A | grep "istio.io" | awk '{print $1}')

# Istio 관련 ClusterRole, Webhook 등 정리
kubectl delete clusterroles,mutatingwebhookconfigurations,validatingwebhookconfigurations -l app.kubernetes.io/part-of=istio

경고

이 단계는 기존에 자체 관리형 Istio가 설치되어 있는 경우에만 실행하세요.

4. Istio Service Mesh 활성화

기존 클러스터에 Istio 추가 기능을 활성화합니다:

# Service Mesh 활성화 [약 3-5분 소요]
az aks mesh enable --resource-group $RESOURCE_GROUP --name $CLUSTER

# 특정 수정 버전을 지정하려면:
# az aks mesh enable --resource-group $RESOURCE_GROUP --name $CLUSTER --revision asm-1-24

팁

새 클러스터를 생성하면서 Istio를 함께 설치하려면:

az aks create \
  --resource-group $RESOURCE_GROUP \
  --name $CLUSTER \
  --enable-asm \
  --generate-ssh-keys

5. 설치 확인

# Istio가 활성화되었는지 확인 - "Istio" 출력 확인
az aks show --resource-group $RESOURCE_GROUP --name $CLUSTER --query 'serviceMeshProfile.mode'

# 설치된 Istio 수정 버전 확인
az aks show --resource-group $RESOURCE_GROUP --name $CLUSTER --query 'serviceMeshProfile.istio.revisions'

# aks-istio-system 네임스페이스의 파드 확인
kubectl get pods -n aks-istio-system

출력 예시:

NAME                               READY   STATUS    RESTARTS   AGE
istiod-asm-1-24-74f7f7c46c-xfdtl   1/1     Running   0          2m
istiod-asm-1-24-74f7f7c46c-4nt2v   1/1     Running   0          2m

모든 istiod Pod의 상태가 Running이어야 합니다.

6. Sidecar 주입 활성화

Istio는 사이드카 패턴을 사용하여 각 Pod에 Envoy 프록시를 주입합니다. 네임스페이스에 레이블을 추가하여 자동 사이드카 주입을 활성화합니다:

# bookinfo 네임스페이스 생성
kubectl create ns bookinfo

# 설치된 수정 버전 확인 (위에서 확인한 버전 사용)
ISTIO_REVISION=$(az aks show --resource-group $RESOURCE_GROUP --name $CLUSTER --query 'serviceMeshProfile.istio.revisions[0]' -o tsv)
echo $ISTIO_REVISION

# 네임스페이스에 레이블 설정 (예: asm-1-24)
kubectl label namespace bookinfo istio.io/rev=$ISTIO_REVISION

important

반드시 istio.io/rev=asm-X-Y 형식의 명시적 수정 버전을 사용해야 합니다
기본 istio-injection=enabled 레이블은 AKS Istio 추가 기능에서 작동하지 않습니다

7. istioctl CLI 설치

# 설치된 Istio 버전 확인
ISTIO_VERSION=$(kubectl get deploy -n aks-istio-system -o yaml | grep 'image:' | head -1 | sed -E 's/.*:(.*)/\1/' | cut -d'-' -f1)
echo "Istio Version: $ISTIO_VERSION"

# istioctl 다운로드 및 설치
curl -L https://istio.io/downloadIstio | ISTIO_VERSION=$ISTIO_VERSION TARGET_ARCH=x86_64 sh -
sudo cp "istio-${ISTIO_VERSION}/bin/istioctl" /usr/local/bin/
chmod +x /usr/local/bin/istioctl
rm -rf "./istio-${ISTIO_VERSION}/"

# 버전 확인
istioctl version -i aks-istio-system

출력 예시:

client version: 1.24.0
control plane version: 1.24.0
data plane version: none

노트

data plane version: none이 표시되는 이유는 아직 사이드카가 주입된 Pod가 배포되지 않았기 때문입니다.

8. 외부 Ingress Gateway 활성화

외부에서 Istio 메시 내부의 서비스에 접근하려면 Ingress Gateway를 활성화해야 합니다:

# 외부 Ingress Gateway 활성화 [약 3-4분 소요]
az aks mesh enable-ingress-gateway \
  --resource-group $RESOURCE_GROUP \
  --name $CLUSTER \
  --ingress-gateway-type external

# Gateway 서비스 확인
kubectl get svc aks-istio-ingressgateway-external -n aks-istio-ingress

# External IP 확인 (EXTERNAL-IP가 할당될 때까지 대기)
kubectl get svc aks-istio-ingressgateway-external -n aks-istio-ingress -w

출력 예시:

NAME                                TYPE           CLUSTER-IP     EXTERNAL-IP      PORT(S)
aks-istio-ingressgateway-external   LoadBalancer   10.0.123.45    20.200.100.50    15021:30123/TCP,80:31380/TCP,443:31390/TCP

9. Istiod Dashboard (선택 사항)

ISTIOD_NAME=$(kubectl get deploy -n aks-istio-system | awk 'NR>1 {print $1}')

# istiod dashboard 실행 (로컬에서 포트 포워딩)
istioctl dashboard controlz deployment/$ISTIOD_NAME -n aks-istio-system

브라우저에서 http://localhost:9876로 접속하여 Istiod 컨트롤 플레인 설정을 확인할 수 있습니다.