Skip to content

charleskorn/rkt-runner

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published