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 withansible-galaxy role install -r requirements.yml
(changeversion
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:
molecule verify
To clean up run
molecule destroy
License
GNU GENERAL PUBLIC LICENSE Version 3
Author Information
Ansible role to install runc
ansible-galaxy install githubixx/ansible-role-runc