개발/Kubernetes

MacOS Docker.desktop Kubernetes 활성화 및 테스트 배포

피터JK 2025. 2. 21. 19:00
728x90

Docker Desktop에서 Kubernetes를 활성화했다면, 이제 Kubernetes 클러스터를 사용하여 애플리케이션을 배포하고 관리할 준비가 된 것입니다. 다음 단계는 원하는 워크플로우에 따라 다르지만, 기본적인 환경 설정 및 테스트를 위해 아래의 작업을 수행하면 됩니다.


✅ 1. kubectl이 정상적으로 동작하는지 확인

Docker Desktop은 기본적으로 kubectl을 함께 설치합니다. 터미널에서 다음 명령어를 실행하여 Kubernetes 클러스터 상태를 확인하세요.

kubectl version --client
kubectl cluster-info

예상 결과

  • kubectl version 명령어는 클라이언트와 서버의 버전을 출력합니다.
  • kubectl cluster-info는 Kubernetes 클러스터의 API 서버 및 DNS 서비스 정보를 출력합니다.

✅ 2. 기본적인 노드 및 상태 확인

kubectl get nodes

예상 결과

  • Ready 상태의 노드가 표시되어야 합니다.
  • Docker Desktop에서는 단일 노드 클러스터가 설정됩니다.
kubectl get pods --all-namespaces

예상 결과

  • kube-system 네임스페이스에 몇 개의 기본 Pod(CoreDNS 등)이 실행 중이어야 합니다.

✅ 3. 테스트 애플리케이션 배포

쿠버네티스가 정상적으로 작동하는지 확인하기 위해 간단한 Nginx Pod를 배포해보세요.

kubectl create deployment nginx --image=nginx
kubectl get pods

배포된 Pod를 확인한 후, 서비스로 노출할 수도 있습니다.

kubectl expose deployment nginx --type=LoadBalancer --port=80
kubectl get services

이제 웹 브라우저에서 http://localhost로 접근할 수 있습니다.

 


✅ 4. Kubernetes 대시보드 활성화 (선택)

Docker Desktop에서는 기본적으로 Kubernetes 대시보드를 포함하고 있지 않지만, 직접 설치할 수 있습니다.

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml

이후 대시보드를 실행하려면:

kubectl proxy

웹 브라우저에서 다음 URL로 접속하세요.

http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/

 

2025.02.21 - [개발/Kubernetes] - 쿠버네티스 대시보드(Kubernetes Dashboard) 로그인 방법

 

쿠버네티스 대시보드(Kubernetes Dashboard) 로그인 방법

* 로그인 urlhttp://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/쿠버네티스 대시보드(Kubernetes Dashboard)를 활성화한 후 로그인 방식을 선택할 수 있습니다.토큰(Token) 방

piterjk.tistory.com

 


✅ 5. Helm 설치 및 활용 (선택)

Kubernetes에서 Helm(패키지 매니저)을 사용하면 애플리케이션을 쉽게 배포할 수 있습니다.
Helm을 설치한 후, 간단한 애플리케이션을 배포할 수도 있습니다.

brew install helm  # macOS의 경우
helm repo add bitnami https://charts.bitnami.com/bitnami
helm install my-nginx bitnami/nginx

이제 kubectl get pods를 실행하면 Helm을 통해 배포한 Nginx Pod가 실행 중인 것을 볼 수 있습니다.


🚀 다음 단계

이제 Kubernetes 클러스터가 정상적으로 동작하는 것을 확인했으므로, 아래 작업을 고려해볼 수 있습니다.

  1. 자신만의 애플리케이션 배포
    • Spring Boot, Node.js, React 등을 컨테이너화하여 Kubernetes에 배포
    • YAML을 활용하여 Deployment, Service, ConfigMap, Secret 등을 관리
  2. CI/CD 환경 구축
    • GitLab CI/CD, Jenkins 등을 활용한 자동 배포 파이프라인 구축
  3. 로깅 및 모니터링
    • Prometheus + Grafana 또는 ELK 스택 구성
  4. Ingress Controller 설정
    • 트래픽을 효율적으로 관리하기 위해 Ingress Nginx 또는 Traefik 설정

🔥 결론:
쿠버네티스를 활성화한 후 기본적인 동작을 확인하고, 애플리케이션 배포 및 관리로 확장해 나가는 것이 중요합니다. 처음에는 kubectl 명령어와 간단한 배포부터 시작한 후 Helm, Ingress, CI/CD, 모니터링 등을 추가하며 점진적으로 환경을 구성하면 됩니다. 🚀

728x90