Ansible Role: Containerd

This is an Ansible Role that helps you install containerd on Linux systems.

Requirements

No special requirements are needed.

Role Variables

Below are the available settings along with their default values (check defaults/main.yml):

• containerd_package: Name of the package. Default is containerd.io.
• containerd_package_state: Controls the package state. Default is present.

Controls for the service:

• containerd_service_state: Controls if the service should be running. Default is started.
• containerd_service_enabled: Determines if the service should start on boot. Default is true.

Configuration options:

• containerd_config_default_write: If set to true, writes default settings to the containerd config.toml file.
• containerd_config_cgroup_driver_systemd: If set to true, uses systemd as the cgroup driver in the config.toml. Only works if containerd_config_default_write is true.

Apt installation settings, useful for changing from stable releases or using a different CPU type (e.g., arm64):

• docker_apt_release_channel: The release channel. Default is stable.
• docker_apt_arch: Automatically sets to arm64 if architecture is aarch64, else it is amd64.
• docker_apt_repository: Repository URL format for Apt installations.
• docker_apt_ignore_key_error: Default is true.
• docker_apt_gpg_key: URL for the GPG key used in Apt.

Yum/DNF installation settings, useful for changing from the stable repository:

• docker_yum_repo_url: The repository URL for Yum/DNF.
• docker_yum_repo_enable_nightly: Set to '0' to disable nightly builds.
• docker_yum_gpg_key: URL for the GPG key used in Yum.

Dependencies

No dependencies required.

Example Playbook

Here’s a simple example of how to use this role:

- hosts: all
  roles:
    - geerlingguy.containerd

License

The role is licensed under MIT / BSD.

Author Information

This role was created in 2021 by Jeff Geerling, who is the author of Ansible for DevOps.