Kubernetes Tutorial : Learn how to use Kompose

kompose is basically deployment accelerator tool to help users who are familiar with docker-compose format and move to Kubernetes.In this post, we are going take Docker compose file and convert it using kompose utility.

This quickstart assumes a basic understanding of Kubernetes concepts, please refer earlier posts for understanding on Kubernetes & how to create,deploy & rollout updates to the cluster.kubernetes logo

What is Docker Compose ?

With Compose tool,you can define and start running multi-container Docker applications. There would be YAML file to configure your application’s services. Then, with a single command, you create and start all the services from your configuration.

Here are the steps involved :

  1. Define Dockerfile for your app’s environment.
  2. Define docker-compose.yml for the services that make up your app services.
  3. Run docker-compose up and Compose starts and runs your entire app.

docker-compose.yml looks like this:

version: "2" services: redis-master: image: redis:latest ports: - "6379" redis-slave: image: gcr.io/google_samples/gb-redisslave:v1 ports: - "6379" environment: - GET_HOSTS_FROM=dns frontend: image: gcr.io/google-samples/gb-frontend:v3 ports: - "80:80" environment: - GET_HOSTS_FROM=dns

Key Features of Docker Compose

  • When you define Compose file,you can use project name to isolate environments from each other. This could be useful in cases like creating multiple copies of a single environment or segregate the builds by unique build number.
  • Compose caches the configuration used to create a container. When you restart a service that has not changed, Compose re-uses the existing containers.It means that you can make changes to your environment very quickly.
  • Compose preserves all volumes used by your services. When docker-compose up runs, if it finds any containers from previous runs, it copies the volumes from the old container to the new container. This process ensures that any data you’ve created in volumes isn’t lost.
  • Compose supports variables in the Compose file. You can use these variables to customize your composition for different environments, or different users.

For more information on Docker Compose,check out here.You can also refer previous posts on Docker here & here.

In the next sections,we can look at how to Install Kompose & use existing Compose files and generate the related Kubernetes Manifest files.

Install Kompose

There are multiple ways to install Kompose. Best option is to install by downloading the binary from the latest GitHub release page.

Kompose Installation
Image – Kompose Installation

For other platforms,check out here.

Convert Docker Compose file to Kubernetes using Kompose

There are 2 ways you can do the conversion of the Docker Compose format to Kubernetes resources manifest.

#1.Run kompose convert in the same directory where you have docker-compose.yaml file,for this example we are going to use below sample compose file.

version: "2"
services:
redis-master:
image: redis:latest
ports:
- "6379"
redis-slave:
image: gcr.io/google_samples/gb-redisslave:v1
ports:
- "6379"
environment:
- GET_HOSTS_FROM=dns
frontend:
image: gcr.io/google-samples/gb-frontend:v3
ports:
- "80:80"
environment:
- GET_HOSTS_FROM=dns

Use Kompose convert command to convert docker compose files
Image – Use Kompose convert command to convert docker compose files

#2.Alternatively you can use command kompose up  to bring up the Images to be deployed using a single command.

You can convert and deploy directly to Kubernetes with kompose up.
Image – You can convert and deploy directly to Kubernetes with kompose up.

Post Kompose command,you can use Kubectl command to see the deployments.

Run kubectl to check the deployments
Image – Run kubectl to check the deployments

By default, Kompose generates YAML files. It’s possible to generate JSON based files by specifying the -j parameter.

Kompose generated YAML files
Image – Kompose generated YAML files

Kompose currently supports 2 providers: OpenShift and Kubernetes. You can choose a targeted provider using global option --provider. If no provider is specified, Kubernetes is set by default.

Congrats! today we have learnt how to use Kompose utility to convert Docker compose file to Kubernetes artifacts.

Like this post? Don’t forget to share it!

Additional Resources :

Summary
Kubernetes Tutorial : Learn how to use Kompose
Article Name
Kubernetes Tutorial : Learn how to use Kompose
Description
kompose is basically deployment accelerator tool to help users who are familiar with docker-compose format and move to Kubernetes.In this post, we are going take Docker compose file and convert it using kompose utility.
Author
Publisher Name
Upnxtblog
Publisher Logo