ksail

# KSail KSail은 일반적인 Kubernetes 도구들을 하나의 바이너리로 묶습니다. CLI, VS Code 확장, AI 채팅 TUI 또는 MCP 서버를 통해 로컬 클러스터를 띄우고, 워크로드를 배포하며, 다양한 배포판과 제공자에 걸쳐 클라우드 네이티브 스택을 운영하세요 — **Docker 또는 클라우드 제공자에 대한 접근만 필요합니다**. ## 빠른 설치 ```bash # Linux / macOS (체크섬 검증 릴리스) curl -fsSL https://github.com/devantler-tech/ksail/releases/latest/download/install.sh | sh # macOS (Homebrew) brew install --cask devantler-tech/tap/ksail ``` ## AI 어시스턴트 플러그인 [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) 또는 [Claude Code](https://code.claude.com/docs/en/discover-plugins)를 위해 [devantler-tech 에이전트 플러그인 마켓플레이스](https://github.com/devantler-tech/agent-plugins)에서 ksail 플러그인을 설치하면 ksail의 MCP 서버와 ksail 전문성 스킬이 자동으로 등록됩니다. **Copilot CLI:** ```bash copilot plugin marketplace add devantler-tech/agent-plugins copilot plugin install ksail@devantler-plugins ``` **Claude Code:** ```text /plugin marketplace add devantler-tech/agent-plugins /plugin install ksail@devantler-plugins ``` `PATH`에 `ksail`이 필요합니다. ## 빠른 시작 ```bash ksail project init --name my-app # 프로젝트 + 네이티브 구성 스캐폴딩 ksail cluster create # 클러스터 생성 (Docker만 필요) ksail cluster connect # K9s 열기 ``` ## KSail이 묶는 것들 | 카테고리 | 내장 기능 | |--------------------------|----------------------------------------------------------------------| | 클러스터 프로비저닝 | Kind, K3d, Talos, VCluster (Vind), KWOK (kwokctl), EKS | | 컨테이너 오케스트레이션 | kubectl, Helm, Kustomize | | GitOps 엔진 | Flux, ArgoCD | | 시크릿 관리 | Age 암호화를 사용하는 SOPS | | 매니페스트 검증 | Kubeconform | | 클러스터 운영 | K9s, 백업 및 복원, 멀티테넌시 (`ksail tenant`) | | AI 통합 | 채팅 어시스턴트 (Copilot SDK), MCP 서버, VS Code 확장 | | 인프라 제공자 | Docker (로컬), Kubernetes (중첩), Hetzner Cloud, Sidero Omni, AWS | ## 지원 플랫폼 | OS | 아키텍처 | |-----------------------------------------------|--------------| | 🐧 Linux | amd64, arm64 | | 🍎 macOS | arm64 | | ⊞ Windows (네이티브 미검증; WSL2 권장) | amd64, arm64 | | 제공자 | Vanilla | K3s | Talos | VCluster | KWOK | EKS | |------------|----------|---------|-------|----------|-------------|-----| | Docker | ✅ (Kind) | ✅ (K3d) | ✅ | ✅ (Vind) | ✅ (kwokctl) | — | | Kubernetes | ✅ | ✅ | ✅ | ✅ | ✅ | — | | Hetzner | — | — | ✅ | — | — | — | | Omni | — | — | ✅ | — | — | — | | AWS | — | — | — | — | — | 🚧 | ## 커뮤니티 및 지원 - 💬 **[GitHub Discussions](https://github.com/devantler-tech/ksail/discussions)** — 질문, 아이디어, 커뮤니티 - 🐛 **[이슈 트래커](https://github.com/devantler-tech/ksail/issues)** — 버그 및 기능 요청 - 📖 **[문서](https://ksail.devantler.tech)** — 가이드, CLI 레퍼런스, 아키텍처 - 🎓 **[리소스](https://ksail.devantler.tech/resources/)** — 프레젠테이션, 블로그 글, 튜토리얼 - ⭐ **[저장소에 스타 주기](https://github.com/devantler-tech/ksail)** — 다른 사람들이 KSail을 발견하도록 돕기 ## 기여 기여를 환영합니다! 개발 프로세스, 코딩 표준, PR 가이드라인은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요. [`good first issue`](https://github.com/devantler-tech/ksail/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 라벨이 붙은 이슈부터 시작하세요. ## 관련 프로젝트 | 프로젝트 | 설명 | 유형 | |-----------------------------------------------------------------------|-----------------------------------------------|----------| | [devantler-tech/platform](https://github.com/devantler-tech/platform) | 메인테이너의 개인 kubernetes 플랫폼 | 플랫폼 | ## 라이선스 KSail은 **[PolyForm Shield License 1.0.0](LICENSE)**에 따라 라이선스가 부여됩니다. KSail과 경쟁하는 제품을 제공하는 경우를 제외하고, 어떤 목적으로든 KSail을 사용, 수정, 배포할 수 있습니다. 재배포 시에는 [라이선스 조건](LICENSE)과 필수 저작권 고지를 포함해야 합니다. **실제로 이것이 의미하는 바:** - ✅ 어떤 프로젝트(오픈소스 또는 독점)에서든 KSail을 CLI 도구로 사용 - ✅ 자체 소프트웨어에 KSail을 라이브러리로 임베드하거나 링크 - ✅ 내부 또는 비경쟁 용도로 KSail을 포크하고 수정 - ✅ 자체 프로젝트에 어떤 라이선스든 사용 — copyleft 요구 없음 - ❌ KSail과 경쟁하는 제품을 빌드하고 배포 고지 및 비경쟁 세부사항을 포함한 전체 라이선스 텍스트는 [LICENSE](LICENSE)를 참고하세요. 일반적인 질문은 [라이선스 FAQ](https://ksail.devantler.tech/faq/#licensing)를 참고하세요.