ansible.builtin.atomic_container (v2.9.27) — module

Manage the containers on the atomic host platform

| "added in version" 2.4 of ansible.builtin"

Authors: Giuseppe Scrivano (@giuseppe)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Manage the containers on the atomic host platform

Allows to manage the lifecycle of a container on the atomic host platform


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.

# Install the etcd system container
- atomic_container:
    name: etcd
    image: rhel/etcd
    backend: ostree
    state: latest
    mode: system
    values:
        - ETCD_NAME=etcd.server
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Uninstall the etcd system container
- atomic_container:
    name: etcd
    image: rhel/etcd
    backend: ostree
    state: absent
    mode: system

Inputs

    
mode:
    choices:
    - user
    - system
    description:
    - Define if it is an user or a system container
    required: true

name:
    description:
    - Name of the container
    required: true

image:
    description:
    - The image to use to install the container
    required: true

state:
    choices:
    - latest
    - present
    - absent
    - rollback
    default: latest
    description:
    - State of the container
    required: true

rootfs:
    description:
    - Define the rootfs of the image

values:
    description:
    - Values for the installation of the container.  This option is permitted only with
      mode 'user' or 'system'. The values specified here will be used at installation
      time as --set arguments for atomic install.

backend:
    choices:
    - docker
    - ostree
    description:
    - Define the backend to use for the container
    required: true

Outputs

msg:
  description: The command standard output
  returned: always
  sample:
  - u'Using default tag: latest ...'
  type: str