[Istio 가이드 ep.3] 1부 개념과 기본 설정 #3 | Kubernetes에 Istio 설치하기: Helm vs Istioctl

 

🔹 개요

이번 글에서는 Kubernetes 클러스터에 Istio를 설치하는 방법을 다룹니다.
Istio는 Helm 또는 Istioctl을 사용하여 설치할 수 있으며, 각각의 방식은 장단점이 있습니다.
이 글에서는 Helm과 Istioctl을 비교하고, 각 설치 방법의 특징과 절차를 설명한 후, 실제 Kubernetes 환경에서 Istio를 설치하는 방법을 살펴봅니다.

---

🔹 1. Istio 설치 방법 비교

✅ 1.1 Istio 설치 방식 개요

Istio를 Kubernetes에 설치하는 방법에는 두 가지가 있습니다.

1. Helm Chart를 사용하여 설치
2. Istioctl을 사용하여 설치

각 방법은 설정의 유연성, 설치 속도, 관리 편의성 등의 측면에서 차이가 있습니다.

  

설치 방법	장점	단점
Helm	- 커스텀 설정 가능- Helm 관리 기능 활용 가능	- 추가적인 Helm 설치 필요- Istio 공식 문서에서 권장하는 기본 방법이 아님
Istioctl	- Istio 공식 설치 방식- 간단한 명령어로 설치 가능	- 설치 과정에서 설정 변경이 제한적- Helm에 비해 유지보수 시 불편

---

🔹 2. Helm을 사용한 Istio 설치

✅ 2.1 Helm 설치 확인

Helm을 사용하여 Istio를 설치하려면 Helm이 사전 설치되어 있어야 합니다.
Helm이 설치되지 않은 경우 아래 명령어를 실행하여 Helm을 설치합니다.

curl -fsSL https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

 

Helm 설치가 완료되었는지 확인하려면 다음 명령어를 실행합니다.

helm version

 

출력 예시

version.BuildInfo{Version:"v3.10.0", GitCommit:"xxxxx", GitTreeState:"clean"}

---

✅ 2.2 Istio Helm Chart 저장소 추가

Helm을 사용하여 Istio를 설치하려면 Istio Helm Chart 저장소를 추가해야 합니다.

helm repo add istio https://istio-release.storage.googleapis.com/charts
helm repo update

 

설명:

• helm repo add istio ...: Istio의 Helm Chart 저장소를 추가
• helm repo update: 최신 버전의 Chart 목록을 업데이트

---

✅ 2.3 Istio 기본 설치 (Helm 사용)

Istio를 Helm으로 설치하려면, 먼저 istio-system 네임스페이스를 생성한 후 설치를 진행합니다.

kubectl create namespace istio-system
helm install istio-base istio/base -n istio-system
helm install istiod istio/istiod -n istio-system

설명:

• kubectl create namespace istio-system: Istio의 리소스를 배포할 네임스페이스 생성
• helm install istio-base ...: Istio의 기본 컴포넌트(CRD 등) 설치
• helm install istiod ...: Istio의 컨트롤 플레인(Pilot, Citadel 등) 설치

---

✅ 2.4 Istio Ingress Gateway 추가 설치 (옵션)

Ingress Gateway도 함께 설치하려면 다음 명령어를 실행합니다.

helm install istio-ingress istio/gateway -n istio-system

 

설치가 완료되었는지 확인하려면 다음 명령어를 실행합니다.

kubectl get pods -n istio-system

---

🔹 3. Istioctl을 사용한 Istio 설치

✅ 3.1 Istioctl 설치

Istioctl은 Istio의 공식 CLI 도구이며, 간편한 명령어로 Istio를 설치할 수 있습니다.

curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.18.0 sh -
cd istio-1.18.0
export PATH=$PWD/bin:$PATH

 

Istioctl이 정상적으로 설치되었는지 확인하려면 다음 명령어를 실행합니다.

istioctl version

 

출력 예시

client version: 1.18.0
control plane version: 1.18.0

---

✅ 3.2 Istio 기본 설치 (Istioctl 사용)

Istioctl을 사용하여 Istio를 설치하려면 아래 명령어를 실행합니다.

istioctl install --set profile=default -y

설명:

• istioctl install --set profile=default: 기본 설정으로 Istio를 설치
• -y: 사용자 입력 없이 자동으로 진행

설치가 완료되었는지 확인하려면 다음 명령어를 실행합니다.

kubectl get pods -n istio-system

---

✅ 3.3 Istio Ingress Gateway 추가 설치 (옵션)

Istio Ingress Gateway를 추가로 설치하려면 다음 명령어를 실행합니다.

istioctl install --set profile=default --set components.ingressGateways.enabled=true -y

 

설치가 완료되었는지 확인하려면 다음 명령어를 실행합니다.

kubectl get svc -n istio-system

---

🔹 4. 설치 후 검증 및 테스트

✅ 4.1 Istio 네임스페이스 확인

Istio가 올바르게 설치되었는지 확인하려면, Istio가 배포된 네임스페이스(istio-system)를 조회합니다.

kubectl get namespaces

 

출력 예시

NAME              STATUS   AGE
default           Active   10h
istio-system      Active   5m

---

✅ 4.2 Istio 서비스 확인

Istio의 주요 서비스가 정상적으로 동작하는지 확인하려면 다음 명령어를 실행합니다.

kubectl get svc -n istio-system

 

출력 예시

NAME                   TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)                                      AGE
istiod                 ClusterIP      10.96.0.1        <none>        15010/TCP,15012/TCP,443/TCP,15014/TCP        5m
istio-ingressgateway   LoadBalancer   10.96.0.2        34.68.12.34   80:31380/TCP,443:31390/TCP                   5m

설명:

• istiod: Istio 컨트롤 플레인의 핵심 서비스
• istio-ingressgateway: Istio의 Ingress Gateway 서비스

---

📌 결론

• Istio는 Helm 또는 Istioctl을 사용하여 설치할 수 있으며, 각각의 방식에는 장단점이 있습니다.
• Helm은 설정의 유연성이 높아 커스텀 구성이 필요할 때 유리하며, Istioctl은 간편하게 설치할 수 있는 공식 방식입니다.
• 설치 후 Istio 네임스페이스 및 서비스 상태를 확인하여 정상적으로 동작하는지 검증하는 것이 중요합니다.