KSail

KSail CLI

Getting Started

Prerequisites

[!NOTE] On MacOS, you need to “Allow the default Docker socket to be used (requires password)” in Docker Desktop settings.

Show me how
![Enable Docker Socket in Docker Desktop](/ksail/docs/images/enable-docker-socket-in-docker-desktop.png)

KSail supports the following operating systems:

MacOS (x64 and arm64)
Linux (x64 and arm64)

Installation

With Homebrew:

brew tap devantler/formulas
brew install ksail

Manually:

Download the latest release for your OS from the releases page.
Make the binary executable: chmod +x ksail.
Move the binary to a directory in your $PATH: mv ksail /usr/local/bin/ksail.

Usage

Getting started with KSail is easy. First, you need a Kubernetes Cluster configuration for your project.

> ksail init - To initialize a new cluster configuration with default configurations.

From there, you probably want to ensure that your distribution and ksail is configured to your liking.

ksail-config.yaml - The configuration file for KSail.
kind-config.yaml - The configuration file for Kind.

When you are ready to provision your cluster, you can run:

> ksail up - To provision your new cluster.

From there, you can make some changes to your manifest files,, and when you are ready to apply them, you can run:

> ksail update - To update your cluster.

And for more advanced debugging, you can run:

> ksail debug - To debug your cluster with the K9s tool.

Finally, when you are done working with your cluster, you can run:

> ksail stop - To stop your cluster, so you can continue working on it later.

Or if you really want to get rid of it for now, you can run:

> ksail down - To dismantle your cluster and remove its resources.

Documentation

Sub-projects

KSail is part of a larger ecosystem of projects that I maintain. These projects are designed to provide important functionality to KSail with high confidence, and without bloating the main repository. Most the projects provide extensible frameworks, so you can build your own tools on top of them, or make contributions to make KSail even more powerful.

devantler/dotnet-cli-runner - An implementation atop CLI Wrap to support running different binaries from C# code.
devantler/dotnet-container-engine-provisioner - Provisioners to provision resources in container engines like Docker or Podman.
devantler/dotnet-key-manager - A key manager to guard your local Age keys.
devantler/dotnet-keys - A library with key models, like the Age key model.
devantler/dotnet-kubernetes-generator - Generators to create Kubernetes resources with ksail init and ksail gen.
devantler/dotnet-kubernetes-provisioner - Provisioners to provision Kubernetes clusters and resources.
devantler/dotnet-kubernetes-validator - A library that validates Kubernetes resources client-side or at runtime.
devantler/dotnet-template-engine - A template engine to support code generation of non-serializable content.

CLI Wrappers

These projects are CLI wrappers that provide a C# API for the respective CLI tools. They are used in KSail to embed and interact with CLI tools in a type-safe manner.

devantler/dotnet-age-cli - A library that embeds and provides an API for the Age CLI.
devantler/dotnet-flux-cli - A library that embeds and provides an API for the Flux CLI.
devantler/dotnet-k3d-cli - A library that embeds and provides an API for the K3d CLI.
devantler/dotnet-k9s-cli - A library that embeds and provides an API for the K9s CLI.
devantler/dotnet-kind-cli - A library that embeds and provides an API for the Kind CLI.
devantler/dotnet-kubeconform-cli - A library that embeds and provides an API for the Kubeconform CLI.
devantler/dotnet-kustomize-cli - A library that embeds and provides an API for the Kustomize CLI.
devantler/dotnet-sops-cli - A library that embeds and provides an API for the SOPS CLI.

[!NOTE] If you use KSail in your project, feel free to open a PR to add it to the list, so others can see how you use KSail.

KSail is a powerful tool that can be used in many different ways. Here are some projects that use KSail in their setup:

devantler/homelab - My personal homelab setup, including an example of how I use KSail.

Presentations

KSail - a Kubernetes SDK for local GitOps development and CI - A presentation on KSail at KCD2024. Link missing.