runc

ansible-role-runc

Ansible role to install runc. runc is a CLI tool for spawning and running containers on Linux according to the OCI specification.

Changelog

Change history:

See full CHANGELOG

Recent changes:

0.5.3+1.1.13

UPDATE

update runc to 1.1.13

OTHER

add support for Ubuntu 24.04

0.5.2+1.1.12

UPDATE

update runc to 1.1.12

0.5.1+1.1.11

UPDATE

update runc to 1.1.11

OTHER CHANGES

adjust Github action because of Ansible Galaxy changes

MOLECULE

Change IP addresses

0.5.0+1.1.10

BREAKING

change default value of runc_bin_directory from /usr/local/bin to /usr/local/sbin

Installation

Directly download from Github (Change into Ansible roles directory before cloning. You can figure out the role path by using ansible-config dump | grep DEFAULT_ROLES_PATH command): git clone https://github.com/githubixx/ansible-role-runc.git githubixx.runc
Via ansible-galaxy command and download directly from Ansible Galaxy: ansible-galaxy install role githubixx.runc
Create a requirements.yml file with the following content (this will download the role from Github) and install with ansible-galaxy role install -r requirements.yml (change version if needed):

---
roles:
  - name: githubixx.runc
    src: https://github.com/githubixx/ansible-role-runc.git
    version: 0.5.3+1.1.13

Role Variables

# runc version to install
runc_version: "1.1.13"

# Where to install "runc" binaries.
runc_bin_directory: "/usr/local/sbin"

# Owner/group of "runc" binary. If the variables are not set
# the resulting binary will be owned by the current user.
runc_owner: "root"
runc_group: "root"

# Specifies the permissions of the "runc" binary
runc_binary_mode: "0755"

# Processor architecture "runc" should run on.
# Currently only "amd64" is available.
runc_arch: "amd64"

# Name of the binary filename to download
runc_archive: "runc.{{ runc_arch }}"

# The runc download URL (normally no need to change it)
runc_url: "https://github.com/opencontainers/runc/releases/download/v{{ runc_version }}/{{ runc_archive }}"

# SHA256 checksum (normally no need to change it / see: https://github.com/opencontainers/runc/releases)
runc_checksum: "sha256:https://github.com/opencontainers/runc/releases/download/v{{ runc_version }}/runc.sha256sum"

Example Playbook

- hosts: runc
  roles:
    - githubixx.runc

Testing

This role has a small test setup that is created using Molecule, libvirt (vagrant-libvirt) and QEMU/KVM. Please see my blog post Testing Ansible roles with Molecule, libvirt (vagrant-libvirt) and QEMU/KVM how to setup. The test configuration is here.

Afterwards molecule can be executed:

molecule converge

This will setup a few virtual machines (VM) with different supported Linux operating systems and installs runc. A small verification step is also included: