feat: Integrate KIND cluster management with docker-compose

KIND 클러스터를 docker-compose로 관리할 수 있도록 개선했습니다.

Changes:
- docker-compose.kubernetes.yml: KIND CLI 통합 관리 서비스
  - kind-cli: kind, kubectl, docker 모두 포함된 통합 CLI 컨테이너
  - monitor: 실시간 클러스터 모니터링 서비스
  - Alpine 기반으로 자동 도구 설치

- KUBERNETES.md: docker-compose 사용법 우선으로 재구성
  - 방법 1 (권장): docker-compose 명령어
  - 방법 2: 로컬 스크립트
  - 방법 3: 수동 설정

- KIND_README.md: 빠른 시작 가이드 신규 작성
  - docker-compose 기반 간편한 사용법
  - 일상적인 작업 예시
  - 별칭(alias) 설정 제안
  - 문제 해결 가이드

Benefits:
- 간편한 관리: docker-compose 한 줄로 환경 시작
- 통합 도구: kind, kubectl, docker 모두 한 컨테이너에서 사용
- 실시간 모니터링: docker-compose logs -f monitor
- 일관된 환경: 로컬에 kind/kubectl 설치 불필요

Usage:
  docker-compose -f docker-compose.kubernetes.yml up -d
  docker-compose -f docker-compose.kubernetes.yml exec kind-cli /scripts/kind-setup.sh setup
  docker-compose -f docker-compose.kubernetes.yml logs -f monitor

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
jungwoo choi
2025-10-28 18:35:41 +09:00
parent e008f17457
commit fde852b797
3 changed files with 286 additions and 75 deletions

View File

@ -26,7 +26,23 @@ brew install kubectl
## 빠른 시작
### 방법 1: 스크립트 사용 (권장)
### 방법 1: docker-compose 사용 (권장)
```bash
# 1. 관리 컨테이너 시작
docker-compose -f docker-compose.kubernetes.yml up -d
# 2. KIND 클러스터 생성 및 배포
docker-compose -f docker-compose.kubernetes.yml exec kind-cli /scripts/kind-setup.sh setup
# 3. 상태 확인
docker-compose -f docker-compose.kubernetes.yml exec kind-cli /scripts/kind-setup.sh status
# 4. 실시간 모니터링
docker-compose -f docker-compose.kubernetes.yml logs -f monitor
```
### 방법 2: 로컬 스크립트 사용
```bash
# 전체 환경 한번에 설정 (클러스터 생성 + 서비스 배포)
@ -39,21 +55,6 @@ brew install kubectl
./scripts/kind-setup.sh access
```
### 방법 2: docker-compose 사용
```bash
# 헬퍼 컨테이너 시작 (모니터링 포함)
docker-compose -f docker-compose.kubernetes.yml up -d
# 모니터링 로그 확인
docker-compose -f docker-compose.kubernetes.yml logs -f kind-monitor
# 헬퍼 컨테이너 중지
docker-compose -f docker-compose.kubernetes.yml down
```
**참고**: KIND 클러스터 자체는 여전히 `kind` CLI 또는 스크립트로 관리해야 합니다. docker-compose는 모니터링 및 관리 헬퍼만 제공합니다.
### 방법 3: 수동 설정
```bash
@ -79,7 +80,38 @@ kubectl get pods -n site11-console
## 관리 방법
### 스크립트 명령어
### docker-compose 명령어 (권장)
```bash
# 관리 컨테이너 시작
docker-compose -f docker-compose.kubernetes.yml up -d
# 클러스터 생성
docker-compose -f docker-compose.kubernetes.yml exec kind-cli /scripts/kind-setup.sh create
# 클러스터 삭제
docker-compose -f docker-compose.kubernetes.yml exec kind-cli /scripts/kind-setup.sh delete
# 전체 설정 (생성 + 배포)
docker-compose -f docker-compose.kubernetes.yml exec kind-cli /scripts/kind-setup.sh setup
# 상태 확인
docker-compose -f docker-compose.kubernetes.yml exec kind-cli /scripts/kind-setup.sh status
# 실시간 모니터링
docker-compose -f docker-compose.kubernetes.yml logs -f monitor
# kubectl 직접 사용
docker-compose -f docker-compose.kubernetes.yml exec kind-cli kubectl get pods -A
# Shell 접속
docker-compose -f docker-compose.kubernetes.yml exec kind-cli bash
# 관리 컨테이너 중지
docker-compose -f docker-compose.kubernetes.yml down
```
### 로컬 스크립트 명령어
```bash
# 클러스터 생성