시스템 개발 및 관리/이커머스 효율화: NLP 모델 적용

[Kubernetes 배포 환경 구축] Kubernetes 생성 및 실행

Data Jun 2025. 3. 2. 10:42

GCP의 GKE(Google Kubernetes Engine)에서 Helm을 활용하여 FastAPI 애플리케이션을 배포하는 과정을 정리합니다. 이 글에서는 쿠버네티스 클러스터 생성부터 네임스페이스 설정, Helm 차트 배포, 서비스 실행 확인까지의 흐름을 설명합니다.

GKE 클러스터 설정

먼저, GCP 콘솔에서 GKE 클러스터를 생성합니다. 이 예제에서는 mlops-cluster라는 이름의 클러스터를 asia-northeast3-a 지역에 생성했습니다.

 

터미널에서 아래 명령어를 실행하여 GKE 클러스터의 인증 정보를 가져옵니다. 이제 kubectl 명령어를 사용하여 클러스터를 관리할 수 있습니다.

 

 

Kubernetes에서는 네임스페이스를 사용하여 리소스를 분리할 수 있습니다.이번 배포에서는 api라는 네임스페이스를 생성하여 FastAPI 관련 리소스를 관리합니다.

 

Helm 차트 설치

Helm은 쿠버네티스에서 패키지 관리 역할을 수행하는 도구로, 차트를 이용해 애플리케이션을 쉽게 배포할 수 있습니다.

OCI 저장소에서 Helm 차트를 가져와서 배포합니다.

 

 

kubectl port-forward svc/nlp-service-chart 8080:80 -n api -> FastAPI 애플리케이션이 정상적으로 동작하는지 확인하기 위해, 포트 포워딩을 사용하여 로컬에서 접근해봅니다.

 

결론

이제 GKE에서 Helm을 이용해 FastAPI 애플리케이션을 배포하는 방법을 정리해 보았습니다.
GKE 클러스터 생성
네임스페이스(api) 설정
Helm을 사용한 FastAPI 배포
서비스 확인 및 포트 포워딩을 통한 테스트

이 과정을 따르면 Kubernetes에서 FastAPI 애플리케이션을 쉽게 배포할 수 있습니다.