- 프로젝트 디렉토리 구조 분석
kubernetes-sigs/sig-windows-tools/
├── CONTRIBUTING.md
├── LICENSE
├── OWNERS
├── README.md
├── SECURITY_CONTACTS
├── code-of-conduct.md
├── containerd-builds.md
├── go.mod
├── go.sum
├── hack/
├── hostprocess/
├── guides/
└── tools/
각 디렉토리 역할
- CONTRIBUTING.md: 프로젝트 참여 가이드라인 문서입니다.
- LICENSE: Apache-2.0 라이선스가 적용된 오픈소스 프로젝트입니다.
- OWNERS: 프로젝트 유지보수 담당자 목록을 포함합니다.
- README.md: 프로젝트 기본 정보와 사용법이 기술된 메인 문서입니다.
- SECURITY_CONTACTS: 보안 취약점 신고용 연락처 정보입니다.
- code-of-conduct.md: 커뮤니티 행동 강령을 규정합니다.
- containerd-builds.md: containerd 빌드 관련 문서입니다.
- go.mod 및 go.sum: Go 프로젝트 의존성 관리 파일입니다.
- hack/: 개발 및 테스트용 유틸리티 스크립트가 위치합니다.
- hostprocess/: Windows HostProcess 컨테이너 관련 도구 모음입니다.
- guides/: 활용 가이드 및 튜토리얼 문서입니다.
- tools/: kubeadm 및 wincat 등 핵심 도구 실행을 지원하는 스크립트입니다.
- 프로젝트 실행 방법
이 프로젝트는 단일 실행 파일 형태가 아닌 도구 모음으로 구성되어 있습니다. 다음 절차를 따라 활용할 수 있습니다:
1단계: 저장소 복제
git clone https://github.com/kubernetes-sigs/sig-windows-tools.git
cd sig-windows-tools
2단계: 문서 확인
README.md 파일을 먼저 검토하여 프로젝트 개요와 사용법을 파악합니다.
3단계: 스크립트 실행
필요에 따라 hack/ 또는 tools/ 디렉토리 내 스크립트를 실행합니다:
./hack/initialize-env.sh
또는 특정 도구를 사용하는 경우:
./tools/kubeadm-init.sh --config cluster-config.yaml
- 프로젝트 설정 방식
프로젝트에는 전용 설정 파일이 별도로 존재하지 않으며, 다음과 같은 방법을 통해 동작을 제어합니다:
환경 변수 기반 설정
일부 스크립트는 환경 변수에 의존합니다. 실행 전 필요한 환경変수를 사전 정의해야 합니다:
export KUBE_VERSION="v1.28.0"
export WINDOWS_BUILD=true
./hack/setup-script.sh
명령행 인자 활용
대부분의 스크립트는 CLI 인자를 통해 동작을定制합니다:
./tools/deploy-tool.sh --namespace kube-system --verbose
외부 설정 파일 참조
특정 설정 파일이 필요한 경우, README.md 또는 관련 문서에서 위치와 포맷을 확인해야 합니다.
上述 절차를 통해 Kubernetes SIG Windows Tools 프로젝트의 다양한 도구와 스크립트를 효과적으로 활용할 수 있습니다.