ksail

# KSail KSail объединяет типовые инструменты Kubernetes в одном бинарном файле. Запускайте локальные кластеры, разворачивайте рабочие нагрузки и управляйте cloud-native стеками для различных дистрибутивов и провайдеров через CLI, расширение VS Code, 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 ``` ## Плагины для ИИ-ассистентов Установите плагин ksail из [маркетплейса плагинов агентов devantler-tech](https://github.com/devantler-tech/agent-plugins) для [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) или [Claude Code](https://code.claude.com/docs/en/discover-plugins), чтобы автоматически зарегистрировать MCP-сервер ksail и навык экспертизы по 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 ``` Требуется наличие `ksail` в `PATH`. ## Быстрый старт ```bash ksail project init --name my-app # создать каркас проекта + нативные конфигурации ksail cluster create # запустить кластер (только Docker) ksail cluster connect # открыть K9s ``` ## Что включает KSail | Категория | Встроенные возможности | |--------------------------|----------------------------------------------------------------------| | Провisioning кластеров | Kind, K3d, Talos, VCluster (Vind), KWOK (kwokctl), EKS | | Оркестрация контейнеров | kubectl, Helm, Kustomize | | Движки GitOps | Flux, ArgoCD | | Управление секретами | SOPS с шифрованием Age | | Валидация манифестов | Kubeconform | | Операции с кластером | K9s, резервное копирование и восстановление, мультитенантность (`ksail tenant`) | | Интеграция с ИИ | Чат-ассистент (Copilot SDK), MCP-сервер, расширение VS Code | | Инфраструктурные провайдеры | Docker (локально), Kubernetes (вложенный), Hetzner Cloud, Sidero Omni, AWS | ## Поддерживаемые платформы | ОС | Архитектура | |-----------------------------------------------|--------------| | 🐧 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)** — вопросы, идеи и сообщество - 🐛 **[Issue Tracker](https://github.com/devantler-tech/ksail/issues)** — ошибки и запросы функций - 📖 **[Документация](https://ksail.devantler.tech)** — руководства, справочник CLI, архитектура - 🎓 **[Ресурсы](https://ksail.devantler.tech/resources/)** — презентации, посты в блогах, руководства - ⭐ **[Поставьте звезду репозиторию](https://github.com/devantler-tech/ksail)** — помогите другим узнать о KSail ## Участие в разработке Мы приветствуем вклад! См. [CONTRIBUTING.md](CONTRIBUTING.md) для описания процесса разработки, стандартов кодирования и правил для PR. Начните с задач с меткой [`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). Ответы на частые вопросы см. в [Licensing FAQ](https://ksail.devantler.tech/faq/#licensing).