forked from LaconicNetwork/kompose
51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
# Kubernetes + Compose = Kompose
|
|
## A conversion tool to go from Docker Compose to Kubernetes
|
|
|
|
### What's Kompose?
|
|
|
|
Kompose is a conversion tool for Docker Compose to container orchestrators such as Kubernetes (or OpenShift).
|
|
|
|
Why do developers love it?
|
|
|
|
- Simplify your development process with Docker Compose and then deploy your containers to a production cluster
|
|
- Convert your `docker-compose.yaml` with one simple command `kompose convert`
|
|
|
|
### It's as simple as 1-2-3
|
|
|
|
1. [Use an example docker-compose.yaml file](https://raw.githubusercontent.com/kubernetes/kompose/master/examples/docker-compose-v3.yaml) or your own
|
|
2. Run `kompose convert`
|
|
3. Run `kubectl apply` and check your Kubernetes cluster for your newly deployed containers!
|
|
|
|
```sh
|
|
$ wget https://raw.githubusercontent.com/kubernetes/kompose/master/examples/docker-compose-v3.yaml -O docker-compose.yaml
|
|
|
|
$ kompose convert
|
|
|
|
$ kubectl apply -f .
|
|
|
|
$ kubectl get po
|
|
NAME READY STATUS RESTARTS AGE
|
|
frontend-591253677-5t038 1/1 Running 0 10s
|
|
redis-master-2410703502-9hshf 1/1 Running 0 10s
|
|
redis-slave-4049176185-hr1lr 1/1 Running 0 10s
|
|
```
|
|
|
|
A more detailed guide is available in our [getting started guide](/docs/getting-started.md).
|
|
|
|
### Install Kompose on Linux, macOS or Windows
|
|
|
|
Grab the Kompose binary!
|
|
|
|
```sh
|
|
# Linux
|
|
curl -L https://github.com/kubernetes/kompose/releases/download/v1.24.0/kompose-linux-amd64 -o kompose
|
|
|
|
# macOS
|
|
curl -L https://github.com/kubernetes/kompose/releases/download/v1.24.0/kompose-darwin-amd64 -o kompose
|
|
|
|
chmod +x kompose
|
|
sudo mv ./kompose /usr/local/bin/kompose
|
|
```
|
|
|
|
_Windows:_ Download from [GitHub](https://github.com/kubernetes/kompose/releases/download/v1.24.0/kompose-windows-amd64.exe) and add the binary to your PATH.
|