kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
website/docs/tools/kompose/index.md

44 lines
1.5 KiB
Markdown
Raw Normal View History

Add extra Kompose documentation Create additional files for Kompose documentation including architecture, development, a more extensive index and a user guide. This also bumps Kompose up to the top on tools page to be symmetrical to the what's listed on the side navbar. I have assigned myself to each doc in order to get updates / any questions regarding the updating of documentation.
2017-01-05 13:57:27 +00:00
---
assignees:
- cdrage
title: Kompose Overview
---
`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.
## Use Case
If you have a Docker Compose `docker-compose.yml` or a Docker Distributed Application Bundle `docker-compose-bundle.dab` file, you can convert it into Kubernetes deployments and services like this:
```console
$ kompose --bundle docker-compose-bundle.dab convert
WARN[0000]: Unsupported key networks - ignoring
update_kompose_docs
2017-01-09 15:29:15 +00:00
file "redis-svc.yaml" created
file "web-svc.yaml" created
file "web-deployment.yaml" created
file "redis-deployment.yaml" created
Add extra Kompose documentation Create additional files for Kompose documentation including architecture, development, a more extensive index and a user guide. This also bumps Kompose up to the top on tools page to be symmetrical to the what's listed on the side navbar. I have assigned myself to each doc in order to get updates / any questions regarding the updating of documentation.
2017-01-05 13:57:27 +00:00
$ kompose -f docker-compose.yml convert
WARN[0000]: Unsupported key networks - ignoring
update_kompose_docs
2017-01-09 15:29:15 +00:00
file "redis-svc.yaml" created
file "web-svc.yaml" created
file "web-deployment.yaml" created
file "redis-deployment.yaml" created
Add extra Kompose documentation Create additional files for Kompose documentation including architecture, development, a more extensive index and a user guide. This also bumps Kompose up to the top on tools page to be symmetrical to the what's listed on the side navbar. I have assigned myself to each doc in order to get updates / any questions regarding the updating of documentation.
2017-01-05 13:57:27 +00:00
```
## Installation
Grab the latest [release](https://github.com/kubernetes-incubator/kompose/releases) for your OS, untar and extract the binary.
### Linux
```sh
wget https://github.com/kubernetes-incubator/kompose/releases/download/v0.1.2/kompose_linux-amd64.tar.gz
tar -xvf kompose_linux-amd64.tar.gz --strip 1
sudo mv kompose /usr/local/bin
```