Kompose 1.17.0!

Here's what's new in Kompose:

• Added support for config, endpoint_mode and 3.3 of Docker Compose (https://github.com/kubernetes/kompose/pull/994)
• You are now able to read data from stdin (https://github.com/kubernetes/kompose/pull/1061)
• Use the host-specified tmp directory (https://github.com/kubernetes/kompose/pull/1068)
• Dots are now propagated into valid service names (https://github.com/kubernetes/kompose/pull/1063)

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.17.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.17.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

Kompose 1.16.0!

Here's what's new in Kompose:

• Bug fixes with env_file (https://github.com/kubernetes/kompose/pull/1020)
• Added installation instructions for OpenSUSE (https://github.com/kubernetes/kompose/pull/1050)
• We now support placement constraints under the deploy label (https://github.com/kubernetes/kompose/pull/1041)

Deploy label constraint:

For example, the below (from Docker Compose) will be successfully converted to Kubernetes

    deploy:
      placement:
        constraints:
        - node.labels.something == anything

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.16.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.16.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

Kompose 1.15.0!

Here's what's new!

• Kompose can now read input from stdin / be piped in (https://github.com/kubernetes/kompose/pull/871)

Many thanks to those who've contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.15.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.15.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

Kompose 1.14.0!

Minor release this month that consists of some typo / test updates.

Thanks to all who've contributed in this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.14.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.14.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

Kompose 1.13.0

Here's what's new:

• Improved support when converting multiple Docker Compose files (https://github.com/kubernetes/kompose/pull/990)
• Support global deploy mode when using DaemonSet (https://github.com/kubernetes/kompose/pull/999)
• A new label! kompose.controller.type has been added (https://github.com/kubernetes/kompose/pull/1001)

New labels:

You can now specify between: deployment, daemonset or replicationcontroller for kompose.controller.type. Controlling what artifact type Kubernetes will generate.

For example:

db:
  image: mysql:5.7
  environment:
    MYSQL_ROOT_PASSWORD: password
  restart: always
  labels:
    project.logs: /var/log/mysql
    kompose.controller.type: daemonset

Many thanks to those who've contributed to this month's release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.13.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.13.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.12.0 of Kompose!

Lot's of changes happening in this month's release!

• You'll now be able to use kompose.service.type: headless as an option when deploying a headless service with Kompose (https://github.com/kubernetes/kompose/pull/979)
• Both domainname and hostname is now supported as a convertable key (https://github.com/kubernetes/kompose/pull/976)

Headless service:

You can deploy a headless service by specifying it within your docker-compose.yaml file:

version: "3"
services: 
 nginx:
  image: nginx
  labels: 
   kompose.service.type: headless

This will deploy to Kubernetes as a headless service.

Domain name and hostname keys:

You may now specify domainname as well as hostname keys within your docker-compose.yaml file.

version: "3"
services: 
 nginx:
  image: nginx
  domainname: foo.com
  hostname: foo

Thanks to everyone who've contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.12.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.12.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.11.0 of Kompose!

A lot of new features this release of Kompose:

• Services are now usable with the same port on different protocols (https://github.com/kubernetes/kompose/pull/907)
• Support of older restart policies is now available in Docker Compose Version 3 (https://github.com/kubernetes/kompose/pull/950)
• Bug fixes (fixing deploy resources parse error https://github.com/kubernetes/kompose/pull/960)
• Support of hostPath volumes (https://github.com/kubernetes/kompose/pull/957)
• We now support Docker Compose version 3.1 and 3.2 (https://github.com/kubernetes/kompose/pull/954)
• Debian and RPM packaging will now be available in each release (https://github.com/kubernetes/kompose/pull/955)

I'd also like to welcome Hang Yan as one of our new core maintainers! (https://github.com/kubernetes/kompose/pull/963)

Thanks to everyone whose contributed in this month's release.

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.11.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.11.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.10.0 of Kompose!

Here is what's new in this release:

• Fixed a bug regarding building images (https://github.com/kubernetes/kompose/pull/946/files)
• Refactor of label names to const strings (https://github.com/kubernetes/kompose/pull/948)
• Charts will now be correctly generated (https://github.com/kubernetes/kompose/pull/938)

Many thanks for those who've contributed to this months release and a big thanks to @hangyan for a lot of bug fixes.

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.10.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.10.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.9.0 of Kompose!

What's new in this release?

• Images will now try to push without authentication before attempting authentication look-up (https://github.com/kubernetes/kompose/pull/913)
• Multiple updates to documentation (thank you @adolphlwq and @hangyan)
• Bug fix regarding setting a PVC volume size in Docker Compose V2 (https://github.com/kubernetes/kompose/pull/929)
• Bug fix on unset variables in Docker Compose V3 (https://github.com/kubernetes/kompose/pull/926)

Thanks to everyone who've contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.9.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.9.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.8.0 of Kompose!

Only minor documentation updates in this month's release, but download away!

Changes in this release:

• Updated documentation (https://github.com/kubernetes/kompose/pull/908 and https://github.com/kubernetes/kompose/pull/903)

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.8.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.8.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.7.0 of Kompose!

Changes to this release:

• You can now push to a private repository when using build (https://github.com/kubernetes/kompose/pull/895)
• ConfigMap is now correctly deleted when using kompose down (https://github.com/kubernetes/kompose/pull/900)
• kompose.service.expose.tls-secret has been added to the list of supported labels (https://github.com/kubernetes/kompose/pull/896) for more information, see: http://kompose.io/user-guide/#labels

Thanks to all who've contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.7.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.7.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.6.0 of Kompose!

Here's what's new in this release:

• Specifying --controller in kompose up and kompose down (https://github.com/kubernetes/kompose/pull/837)
• Docker build bug fix (https://github.com/kubernetes/kompose/pull/837)
• Documentation updates

--controller paramater added to up/down:

In an effort to make commands between kompose convert and kompose up/down even, we've added the ability to specify a controller when running the up/down command.

$ kompose up --controller=daemonset

Many thanks to those who've contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.6.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.6.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.5.0 of Kompose!

Here's what's new in this release:

• New label! You can now manually define what size PersistentVolumeClaim's are created. (https://github.com/kubernetes/kompose/pull/867)
• Ignore links if specified to a non-existent container (https://github.com/kubernetes/kompose/pull/862)
• Multiple documentation updates / website updates (Terms of Contents added)

Manually define a PersistentVolumeClaim size:_

By default Kompose will create a 100Mi Volume Claim. We've added another label in order manually specify a default volume size.

version: '3'
services:
  nginx:
    image: nginx
    labels:
      kompose.volume.size: 500Mi
    volumes:
      - /foo:/bar

Thanks to everyone who have contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.5.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.5.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.4.0 of Kompose

A small (minor) release this month!

Changes:

• Updates to documentation with regards to third-party integrations such as Maven
• Updated --help page for kompose up to reflect differences in CLI paramters between OpenShift and Kubernetes
• Added documentation for developer testing suites (Semaphore, TravisCI, Converalls)

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.4.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.4.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.3.0 of Kompose!

What's new in 1.3.0?

New keys:

• Environment File: env_file key is now supported. A ConfigMap will automatically be generated alongside your other Kubernetes artifacts
• Placement: placement: contraints is now supported

New CLI paramaters:

• --controller parameter has been added, deprecating --daemon-set, --deployment, and --replication-controller
• --build-branch and --build-repo has also been added to kompose up to coincidence with the same parameters in kompose convert

Other:

• Documentation updates
• Volume validations
• tmpfs bug fix

env_file:

The env_file key will now correctly convert to it's Kubernetes equivilant. A ConfigMap will be generated.

For example:

version: '3'

services:
  redis:
    image: 'bitnami/redis:latest'
    environment:
      - ALLOW_EMPTY_PASSWORD=no
    # Env file will override environment / warn!
    env_file:
      - "foo.env"
      - bar.env
    labels:
      kompose.service.type: nodeport
    ports:
      - '6379:6379'

To:

apiVersion: v1
data:
  ALLOW_EMPTY_PASSWORD: "yes"
kind: ConfigMap
metadata:
  creationTimestamp: null
  name: foo-env

placement:

Placement key will now convert to it's Kubernetes equivilant (with constraints).

This only works for specifying a node as well as an operating system.

For example:

version: '3'
services:
  db:
   image: postgres
   deploy:
     placement:
       constraints:
         - node.hostname == machine
         - engine.labels.operatingsystem == ubuntu 14.04

Thanks again to all whom contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.3.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.3.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

1.2.0 of Kompose!

What's new in 1.2.0?

• --volumes has been added as a new CLI parameter
• Minor refactoring

Thanks to all who've contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.2.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.2.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

Our first release since 1.0.0 and a lot has happened.

So what's new in 1.1.0?

New keys:

• Group Add: group_add will now be converted to it's Kubernetes equivalant within Docker Compose Version 2.
• Deploy Resources and Mode: More deploy keys! You may now set CPU and Memory resources as well as the global parameter.
• Health Check: Health check will also be converted to it's Kubernetes equivalant with livenessProbe.

In this example, both deploy keys and health check will be converted:

version: "3"

services:

  redis-master:
    image: gcr.io/google_containers/redis:e2e 
    ports:
      - "6379"

  redis-slave:
    image: gcr.io/google_samples/gb-redisslave:v1
    healthcheck:
      test: ["CMD", "echo", "helloworld"]
      interval: 1m30s
      timeout: 10s
      retries: 3
    deploy:
      replicas: 6
      resources:
        limits:
          cpus: '0.001'
          memory: 50M
        reservations:
          cpus: '0.0001'
          memory: 20M
    ports:
      - "6379"
    environment:
      - GET_HOSTS_FROM=dns

  frontend:
    image: gcr.io/google-samples/gb-frontend:v4
    ports:
      - "80:80"
    environment:
      - GET_HOSTS_FROM=dns
    labels:
      kompose.service.type: LoadBalancer

For more information and what keys can now be converted, check out our conversion table for a full list.

Updates:

• Nightly binaries: 'Nightlies' are now available as they're generated on each merge to master.
• Volumes: Volumes will now be converted and detected before anything else, ensuring that Kompose fails prematurely rather than later.
• Documentation updates: We've updated our docs to reflect better formatting for our conversion matrix as well as alternative installation methods such as Windows support.
• Cluster tests: You can now test Kompose against a Kubernetes cluster by running make test-k8s

Thanks again to all whom contributed to this months release!

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.1.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.1.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

Happy 1.0.0!

With the release of 1.0.0, we also graduate from the Kubernetes Incubator!. Our new repository is now at github.com/kubernetes/kompose.

Thank you everyone for using as well as contributing to Kompose in order to achieve this amazing milestone!

So what’s new with Kompose 1.0.0?

• Docker Compose Version 3: Kompose now supports Docker Compose Version 3. New keys such as ‘deploy’ will now convert to their Kubernetes equivalent.
• Docker Push and Build Support: When you supply a ‘build’ key within your docker-compose.yaml file, Kompose will automatically build and push the image to the respective Docker repository for Kubernetes to consume.
• New Keys: With the addition of version 3 support, new keys such as pid and deploy are supported. For full details on what Kompose supports, view our conversion document.
• Bug Fixes: Every release we fix any shortcomings or bug fixes related to edge-cases when converting. This release fixes issues relating to converting volumes with ‘./’ in the target name.

Docker Compose Version 3:

Converting Version 3 Docker Compose files is now possible with Kompose. It’s as simple as running kompose up against an example version 3 file.

$ head -1 docker-compose.yaml 
version: "3"

$ kompose up
INFO We are going to create Kubernetes Deployments, Services and PersistentVolumeClaims for your Dockerized application. If you need different kind of resources, use the 'kompose convert' and 'kubectl create -f' commands instead. 

INFO Deploying application in "default" namespace 
INFO Successfully created Service: frontend       
INFO Successfully created Service: redis-master   
INFO Successfully created Service: redis-slave    
INFO Successfully created Deployment: frontend    
INFO Successfully created Deployment: redis-master 
INFO Successfully created Deployment: redis-slave 

Your application has been deployed to Kubernetes. You can run 'kubectl get deployment,svc,pods,pvc' for details.

Docker Push and Build Support:

Kompose supports both building and pushing Docker images. When using the build key within your Docker Compose file, your image will:

• Automatically be built with Docker using the image key specified within your file
• Be pushed to the correct Docker repository using local credentials (located at .docker/config)

Using an example Docker Compose file:

version: "2"

services:
    foo:
        build: "./build"
        image: docker.io/foo/bar

Using kompose up with a build key:

$ kompose up
INFO Build key detected. Attempting to build and push image 'docker.io/foo/bar' 
INFO Building image 'docker.io/foo/bar' from directory 'build' 
INFO Image 'docker.io/foo/bar' from directory 'build' built successfully 
INFO Pushing image 'foo/bar:latest' to registry 'docker.io' 
INFO Attempting authentication credentials 'https://index.docker.io/v1/ 
INFO Successfully pushed image 'foo/bar:latest' to registry 'docker.io' 
INFO We are going to create Kubernetes Deployments, Services and PersistentVolumeClaims for your Dockerized application. If you need different kind of resources, use the 'kompose convert' and 'kubectl create -f' commands instead. 
 
INFO Deploying application in "default" namespace 
INFO Successfully created Service: foo            
INFO Successfully created Deployment: foo         

Your application has been deployed to Kubernetes. You can run 'kubectl get deployment,svc,pods,pvc' for details.

Installation

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.0.0/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.0.0/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose

Windows:

Download from GitHub and add the binary to your PATH.

Checksums:

0.7.0 release of Kompose!

In this release we (generally) fix bugs, add more tests, as well as make documentation changes.

We've also added args support to build in Docker Compose.

version: "2"

services:
    foobar:
        build:
          context: "./build"
          args:
            - NAME=web
            - foo

Major changes:

• Minor fix to ImageStream tag on OpenShift conversion #613
• Replace underscores with dashes while rendering container names #606
• io.kompose.service label added to every object for conversion #578
• build_args support in BuildConfig #424

A more detailed changelog can be found at CHANGELOG.md.

Many thanks for those who've contributed to this month's release!

Another release of Kompose! This time it's 0.6.0 and we've got a lot of changes.

We've added a new CLI parameter called --insecure-repository. By passing a true value, you can now build an OpenShift ImageStream object with an insecure repository.

kompose up --provider=openshift --insecure-repository true

You can also now specify what namespace you'd like to use with the new --namespace CLI parameter,

kompose up --namespace foobar

New keys have been added! Special thanks to @gitlawr. Both cap_add and cap_drop will now be successfully converted to their Kubernetes/OpenShift equivalents.

New features:

• Kompose will now continue to retry doing it's job when kompose down is used #536
• Insecure repository paramter added #547
• cap_add and cap_drop key support #580
• We now have an updated ROADMAP with our future plans #549
• Namespace CLI parameter added #517
• driver:local bug fixed #557
• More updates to documentation!
• Tarballs are now included in every release