Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.21

Documentation for other releases can be found by using the version selector in the top right of any doc page.

docker_image

Manage Docker images.

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
name	true	string		Image name with optional tag (e.g., nginx:latest).
tag		string		Tag for the image (appended to name).
state		string	present absent	Desired state of the image.
source		string	build load pull local	Source of the image (build, load, pull, local).
build		object		Build options when source=build.
push		boolean		Push the image to a registry.
repository		string		Repository to push to (full name including registry).
load_path		string		Path to load image from (for source=load).
force_source		boolean		Force rebuild/repull even if image exists.
force		boolean		Force removal of the image.

Example

- name: Pull an image
  docker_image:
    name: nginx:latest
    source: pull

- name: Build and push image
  docker_image:
    name: myapp
    tag: v1.0
    source: build
    build:
      path: /app
      dockerfile: Dockerfile
    push: true

- name: Build with build args
  docker_image:
    name: myapp
    tag: latest
    source: build
    build:
      path: .
      args:
        VERSION: "1.0"
        DEBUG: "false"

- name: Tag and push to multiple registries
  docker_image:
    name: myapp:v1.0
    source: local
    push: true
    repository: registry.example.com/myapp:v1.0

- name: Remove an image
  docker_image:
    name: myapp:old
    state: absent

- name: Load image from tar file
  docker_image:
    name: myapp:loaded
    source: load
    load_path: /tmp/myapp.tar

- name: Force rebuild
  docker_image:
    name: myapp:latest
    source: build
    force_source: true
    build:
      path: /app