Welcome to Katenary documentation

🚀 Unleash Productivity with Katenary! 🚀

Tired of manual conversions? Katenary harnesses the labels from your "compose" file to craft complete Helm Charts effortlessly, saving you time and energy.

🛠️ Simple autmated CLI: Katenary handles the grunt work, generating everything needed for seamless service binding and Helm Chart creation.

💡 Effortless Efficiency: You only need to add labels when it's necessary to precise things. Then call katenary convert and let the magic happen.

What is it?

Katenary is a tool made to help you to transform "compose" files (compose.yaml, docker-compose.yml, podman-compose.yml...) to complete and production ready Helm Chart.

You'll be able to deploy your project in Kubernetes in a few seconds (of course, more if you need to tweak with labels).

It uses your current file and optionnaly labels to configure the result.

It's an opensource project, under MIT licence, originally partially developped at Smile.

Today, it's partially developped in collaboration with Klee Group. Note that Katenary is and will stay an opensource and free (as freedom) project. We are convinced that the best way to make it better is to share it with the community.

The main developer is Patrice FERLET.

The project source code is hosted on the Katenary GitHub Repository.

Install Katenary

Katenary is developped using the Go language. The binary is statically linked, so you can simply download it from the release page of the project in GutHub.

You need to select the right binary for your operating system and architecture, and copy the binary in a directory that is in your PATH.

If you are a Linux user, you can use the "one line installation command" which will download the binary in your $HOME/.local/bin directory if it exists.

sh <(curl -sSL https://raw.githubusercontent.com/metal3d/katenary/master/install.sh)

Upgrading is integrated to the katenary command

Katenary propose a upgrade subcommand to update the current binary to the latest stable release.

Of course, you need to install Katenary once

You prefer to compile it, no need to install Go

You can also build and install it yourself, the provided Makefile has got a build command that uses podman or docker to build the binary.

So, you don't need to install Go compiler .

But, note that the "master" branch is not the "stable" version. It's preferable to switch to a tag, or to use the releases.

To compile it, you can use the following commands:

git clone https://github.com/metal3d/katenary.git
cd katenary
make build
make install

make install copies ./katenary binary to your user binary path (~/.local/bin)

You can install it in other directory by changing the PREFIX variable. E.g.:

make build
sudo make install PREFIX=/usr/local

Check if everything is OK using katenary version and / or katenary help

Install completion

Katenary uses the very nice project named cobra to manage flags, argument and auto-completion.

You can activate it with:

# replace "bash" by "zsh" if needed
source <(katenary completion bash)

Add this line in you ~/.profile, ~/.bash_aliases or ~/.bashrc file to have completion at startup.

What a name...

A catenary is the curve that a hanging chain or cable assumes under its own weight when supported only at its ends. I, the maintainer, decided to name "Katenary" this project because it's like a chain that links a boat to a dock. Making the link between the "compose" world and the "Kubernetes" world is the main goal of this project.

Anyway, it's too late to change the name now

But I like this name!

I spent time to find it

Special thanks to...

I really want to thank all the contributors, testers, and of course, the authors of the packages and tools that are used in this project. There is too many to list here. Katenary can works because of all these people. Open source is a great thing!

Special thanks

Katenary is built with:

Go is an open source programming language that makes it easy to build simple, reliable, and efficient software. Because Docker, Podman, Kubernetes, and Helm are written in Go, Katenary is also written in Go and borrows packages from these projects to make it as efficient as possible.

Thanks to Kubernetes to provide Kind that is used to test Katenary locally.

Thanks to everyone who contributes to all these projects.

Katenary can progress because of all these people. All contributions, as comments, issues, pull requests and feedbacks are welcome.

Everything was also possible because of:

• Helm that is the main toppic of Katenary, Kubernetes is easier to use with it.
• Cobra that makes command, subcommand and completion possible for Katenary with ease.
• Podman, Docker, Kubernetes that are the main tools that Katenary is made for.

Documentation is built with:

MkDocs using Material for MkDocs theme template.

License

Katenary is an open source project under the MIT license. You can use it, modify it, and distribute it as you want.