githubixx.runc

ansible-role-runc

This is an Ansible role to install runc. runc is a command-line tool used to create and run containers on Linux, following the OCI standards.

Changelog

Change history:

For complete details, check the full CHANGELOG.

Recent changes:

0.5.3+1.1.13

UPDATE

Updated runc to version 1.1.13.

OTHER

Added support for Ubuntu 24.04.

0.5.2+1.1.12

UPDATE

Updated runc to version 1.1.12.

0.5.1+1.1.11

UPDATE

Updated runc to version 1.1.11.

OTHER CHANGES

Modified GitHub actions due to changes in Ansible Galaxy.

MOLECULE

Changed IP addresses.

0.5.0+1.1.10

BREAKING

Changed the default location for runc binaries from /usr/local/bin to /usr/local/sbin.

Installation

You can download it directly from GitHub. Make sure to change to the Ansible roles directory before cloning. Use the command ansible-config dump | grep DEFAULT_ROLES_PATH to find the role path.

git clone https://github.com/githubixx/ansible-role-runc.git githubixx.runc

Or, use the ansible-galaxy command to directly download from Ansible Galaxy:

ansible-galaxy install role githubixx.runc

Create a requirements.yml file with this content to download the role from GitHub and install it using:

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. Defaults to current user if not set.
runc_owner: "root"
runc_group: "root"

# Permissions for the "runc" binary.
runc_binary_mode: "0755"

# Processor architecture for "runc".
# Currently, only "amd64" is available.
runc_arch: "amd64"

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

# The runc download URL (normally does not need to be changed)
runc_url: "https://github.com/opencontainers/runc/releases/download/v{{ runc_version }}/{{ runc_archive }}"

# SHA256 checksum (normally does not need to be changed)
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 includes a small test setup created using Molecule, libvirt (vagrant-libvirt), and QEMU/KVM. For instructions on how to set it up, please refer to my blog post Testing Ansible roles with Molecule, libvirt (vagrant-libvirt), and QEMU/KVM. The test configuration can be found here.

After setup, you can run:

molecule converge

This command will create a few virtual machines (VMs) with different supported Linux operating systems and install runc. It includes a verification step: