Kompose (Kubernetes + Compose)
kompose is a tool to help users who are familiar with
docker-compose move to Kubernetes.
kompose takes a Docker Compose file and translates it into Kubernetes resources.
kompose is a convenience tool to go from local Docker development to managing your application with Kubernetes. Transformation of the Docker Compose format to Kubernetes resources manifest may not be exact, but it helps tremendously when first deploying an application on Kubernetes.
$ kompose --bundle docker-compose-bundle.dab convert WARN Unsupported key networks - ignoring file "redis-svc.yaml" created file "web-svc.yaml" created file "web-deployment.yaml" created file "redis-deployment.yaml" created $ kompose -f docker-compose.yml convert WARN Unsupported key networks - ignoring file "redis-svc.yaml" created file "web-svc.yaml" created file "web-deployment.yaml" created file "redis-deployment.yaml" created
Other examples are provided in the examples directory.
kompose, you can either
go get or install the binary from a new release.
go get github.com/kubernetes-incubator/kompose
Grabbing the latest release from the GitHub release page for your OS.
# Linux curl -L https://github.com/kubernetes-incubator/kompose/releases/download/v0.3.0/kompose-linux-amd64 -o kompose # macOS curl -L https://github.com/kubernetes-incubator/kompose/releases/download/v0.3.0/kompose-darwin-amd64 -o kompose # Windows curl -L https://github.com/kubernetes-incubator/kompose/releases/download/v0.3.0/kompose-windows-amd64.exe -o kompose.exe
chmod +x kompose sudo mv ./kompose /usr/local/bin/kompose
If you have EPEL enabled in your system, you can install Kompose like any other package.
sudo yum -y install kompose
Kompose is in Fedora 24 and 25 repositories. You can install it just like any other package.
sudo dnf -y install kompose
We support both
zsh for autocompletion.
source <(kompose completion bash)
source <(kompose completion zsh)
- You need
- You need
gov1.6 or later.
- If your working copy is not in your
GOPATH, you need to set it accordingly.
You can either build via the Makefile:
$ make bin
$ go build -o kompose main.go
If you have
go v1.5, it's still good to build
kompose with the following settings:
$ CGO_ENABLED=0 GO15VENDOREXPERIMENT=1 go build -o kompose main.go
To create a multi-platform binary, use the
cross command via
$ make cross
Contributing and Issues
kompose is a work in progress, we will see how far it takes us. We welcome any pull request to make it even better.
If you find any issues, please file it.
Community, Discussion, Contribution, and Support
As part of the Kubernetes ecosystem, we follow the Kubernetes community principles. More information can be found on the community page.
You can reach the maintainers of this project on Slack in channel #kompose
An up-to-date roadmap of upcoming releases is located at ROADMAP.md.
Code of Conduct
Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.