À propos du projet

# KSail KSail regroupe les outils Kubernetes courants dans un seul binaire. Créez des clusters locaux, déployez des charges de travail et gérez des piles cloud-natives sur plusieurs distributions et fournisseurs via une CLI, une extension VS Code, un TUI de chat IA ou un serveur MCP — avec **uniquement Docker ou un accès à un fournisseur cloud requis**. ## Installation rapide ```bash # Linux / macOS (version vérifiée par somme de contrôle) curl -fsSL https://github.com/devantler-tech/ksail/releases/latest/download/install.sh | sh # macOS (Homebrew) brew install --cask devantler-tech/tap/ksail ``` ## Plugins d'assistant IA Installez le plugin ksail depuis la [place de marché de plugins d'agent devantler-tech](https://github.com/devantler-tech/agent-plugins) pour [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) ou [Claude Code](https://code.claude.com/docs/en/discover-plugins) afin d'enregistrer automatiquement le serveur MCP de ksail et une compétence experte 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 ``` Nécessite `ksail` dans le `PATH`. ## Démarrage rapide ```bash ksail project init --name my-app # générer un projet + configurations natives ksail cluster create # démarrer le cluster (Docker uniquement) ksail cluster connect # ouvrir K9s ``` ## Ce que KSail regroupe | Catégorie | Capacités intégrées | |---------------------------|----------------------------------------------------------------------| | Provisionnement de clusters | Kind, K3d, Talos, VCluster (Vind), KWOK (kwokctl), EKS | | Orchestration de conteneurs | kubectl, Helm, Kustomize | | Moteurs GitOps | Flux, ArgoCD | | Gestion des secrets | SOPS avec chiffrement Age | | Validation de manifestes | Kubeconform | | Opérations de cluster | K9s, sauvegarde et restauration, multi-location (`ksail tenant`) | | Intégration IA | Assistant de chat (SDK Copilot), serveur MCP, extension VS Code | | Fournisseurs d'infrastructure | Docker (local), Kubernetes (imbriqué), Hetzner Cloud, Sidero Omni, AWS | ## Plateformes prises en charge | OS | Architecture | |-----------------------------------------------|--------------| | 🐧 Linux | amd64, arm64 | | 🍎 macOS | arm64 | | ⊞ Windows (natif non testé ; WSL2 recommandé) | amd64, arm64 | | Fournisseur | Vanilla | K3s | Talos | VCluster | KWOK | EKS | |-------------|----------|---------|-------|----------|-------------|-----| | Docker | ✅ (Kind) | ✅ (K3d) | ✅ | ✅ (Vind) | ✅ (kwokctl) | — | | Kubernetes | ✅ | ✅ | ✅ | ✅ | ✅ | — | | Hetzner | — | — | ✅ | — | — | — | | Omni | — | — | ✅ | — | — | — | | AWS | — | — | — | — | — | 🚧 | ## Communauté et support - 💬 **[Discussions GitHub](https://github.com/devantler-tech/ksail/discussions)** — questions, idées et communauté - 🐛 **[Suivi des problèmes](https://github.com/devantler-tech/ksail/issues)** — bugs et demandes de fonctionnalités - 📖 **[Documentation](https://ksail.devantler.tech)** — guides, référence CLI, architecture - 🎓 **[Ressources](https://ksail.devantler.tech/resources/)** — présentations, articles de blog, tutoriels - ⭐ **[Mettez une étoile au dépôt](https://github.com/devantler-tech/ksail)** — aidez les autres à découvrir KSail ## Contribution Les contributions sont les bienvenues ! Consultez [CONTRIBUTING.md](CONTRIBUTING.md) pour le processus de développement, les normes de codage et les directives de PR. Commencez par les problèmes étiquetés [`bon premier problème`](https://github.com/devantler-tech/ksail/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22). ## Projets associés | Projet | Description | Type | |-----------------------------------------------------------------------|-----------------------------------------------|----------| | [devantler-tech/platform](https://github.com/devantler-tech/platform) | La plateforme Kubernetes personnelle du mainteneur | Plateforme | ## Licence KSail est sous licence **[PolyForm Shield License 1.0.0](LICENSE)**. Vous pouvez utiliser, modifier et distribuer KSail à toute fin — sauf pour fournir un produit qui concurrence KSail. Lors de la redistribution, vous devez inclure les [conditions de licence](LICENSE) et l'avis de droit d'auteur requis. **Ce que cela signifie en pratique :** - ✅ Utiliser KSail comme outil CLI dans tout projet (open-source ou propriétaire) - ✅ Intégrer ou lier KSail comme bibliothèque dans votre propre logiciel - ✅ Forker et modifier KSail pour un usage interne ou non concurrent - ✅ Utiliser toute licence pour votre propre projet — aucune exigence de copyleft - ❌ Créer et distribuer un produit qui concurrence KSail Pour le texte complet de la licence, y compris l'avis et les détails de non-concurrence, voir [LICENSE](LICENSE). Pour les questions courantes, consultez la [FAQ sur les licences](https://ksail.devantler.tech/faq/#licensing).