An Ansible role for creating a systemd service unit that runs an ACI
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
meta
tasks
templates
LICENSE
README.md

README.md

rkt-runner

An Ansible role for creating a systemd service unit that runs an ACI using rkt.

Requirements

Assumes that rkt is already installed on the target system and is available at /usr/bin/rkt.

Requires systemd. The Wikipedia article for systemd lists the Linux distributions and corresponding versions that come with systemd out of the box.

Role Variables

This role has two required variables:

  • image_path: the path to the ACI (eg. /images/cool-thing.aci or http://www.example.com/cool-thing.aci or example.com/cool-thing:v1.2.3)
  • service_name: the name of the service (eg. cool-thing)

There are also two optional variables:

  • extra_args: arguments to pass through to the container's executable (eg. setting extra_args to --do-stuff will result in the rkt run command being /usr/bin/rkt run /path/to/image.aci -- --do-stuff)
  • rkt_opts: rkt options (eg. https://coreos.com/rkt/docs/latest/subcommands/run.html)

Dependencies

This role does not have any dependencies.

Example Playbook

- hosts: servers
  roles:
     - { role: rkt-runner, image_path: "/images/cool-thing.aci", service_name: "cool-thing" }

License

MIT

Author Information

Created by Charles Korn (me@charleskorn.com).

Contributing

Submit issues and pull requests on GitHub at https://github.com/charleskorn/rkt-runner.