Download and unarchive the latest kompose release asset for your OS
Switch branches/tags
Nothing to show
Clone or download
Latest commit 3704e8a Nov 16, 2016
Failed to load latest commit information.
defaults Initial Nov 16, 2016
handlers Initial Nov 16, 2016
meta Add meta data Nov 16, 2016
tasks Initial Nov 16, 2016
tests Initial Nov 16, 2016
vars Initial Nov 16, 2016
.gitignore Initial Nov 16, 2016
.travis.yml Initial Nov 16, 2016 Update intro Nov 16, 2016


Build Status

Use to download and unarchive the latest kompose release asset for your OS.

If you're unfamiliar with Kompose, it's a CLI tool to help users familiar with docker-compose move to Kubernetes. It will take a Docker Compose file and translate it into Kubernetes resources. Use it to generate the configuration files, or to launch the application directly on your Kubernetes cluster.


  • Accesses the GitHub API to find the release and it's assets, so you'll need internet access.
  • Run with gather_facts: yes, if you want it to determine which asset to download based on the host's OS family. Or, you can set kompose_asset_name to the name of the desired asset.

Role Variables

kompose_github_user: kubernetes-incubator

Name of GitHub user that owns the kompose repo. Presumably it won't always be in the incubator.

kompose_github_name: kompose

Name of the kompose repo. This likely won't change, but you never know.


The GitHub API URL.

kompose_asset_name: defaults based on OS

The specific asset you want to download. When ansible_os_family is Darwin (applies to OSX) will download kompose_darwin-amd64.tar.gz. When Debian or RedHat will download *kompose_linux-amd64.tar.gz * kompose_release_id: Provide the id of a specific release, otherwise the latest release will be downloaded.


Provide a specific release tag name, otherwise the latest release will be downloaded.

kompose_dest: /usr/bin/kompose

Destination directory where the binary should be placed.

Example Playbook

- hosts: localhost
  connection: local
  gather_facts: yes
    - role: chouseknecht.kompose-install-role
      kompose_dest: "{{ lookup('env', 'HOME') }}/kompose"


Apache v2