ansible.builtin.atomic_image (v2.4.4.0-1) — module

Install Ansible via pip

Install with pip install ansible==2.4.4.0.post1

Description

Manage the container images on the atomic host platform

Allows to execute the commands specified by the RUN label in the container image when present

Requirements

• atomic
• python >= 2.6

Usage examples

Scanned by Steampunk Spotter

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

# Execute the run command on rsyslog container image (atomic run rhel7/rsyslog)
- atomic_image:
    name: rhel7/rsyslog
    state: latest

Scanned by Steampunk Spotter

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

# Pull busybox to the OSTree backend
- atomic_image:
    name: busybox
    state: latest
    backend: ostree

Inputs

    
name:
    default: null
    description:
    - Name of the container image
    required: true

state:
    choices:
    - present
    - absent
    - latest
    default: latest
    description:
    - The state of the container image.
    - The state C(latest) will ensure container image is upgraded to the latest version
      and forcefully restart container, if running.
    required: false

backend:
    choices:
    - docker
    - ostree
    default: None
    description:
    - Define the backend where the image is pulled.
    required: false
    version_added: '2.4'
    version_added_collection: ansible.builtin

started:
    choices:
    - 'yes'
    - 'no'
    default: true
    description:
    - Start or Stop the container
    required: false

Outputs

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