containers / containers.podman / 1.12.1 / module / podman_image Pull images for use by podman Authors: Sam Doran (@samdoran)containers.podman.podman_image (1.12.1) — module
Install with ansible-galaxy collection install containers.podman:==1.12.1
collections: - name: containers.podman version: 1.12.1
Build, pull, or push images using Podman.
- name: Pull an image containers.podman.podman_image: name: quay.io/bitnami/wildfly
- name: Remove an image containers.podman.podman_image: name: quay.io/bitnami/wildfly state: absent
- name: Remove an image with image id containers.podman.podman_image: name: 0e901e68141f state: absent
- name: Pull a specific version of an image containers.podman.podman_image: name: redis tag: 4
- name: Build a basic OCI image containers.podman.podman_image: name: nginx path: /path/to/build/dir
- name: Build a basic OCI image with advanced parameters containers.podman.podman_image: name: nginx path: /path/to/build/dir build: cache: no force_rm: true format: oci annotation: app: nginx function: proxy info: Load balancer for my cool app extra_args: "--build-arg KEY=value"
- name: Build a Docker formatted image containers.podman.podman_image: name: nginx path: /path/to/build/dir build: format: docker
- name: Build and push an image using existing credentials containers.podman.podman_image: name: nginx path: /path/to/build/dir push: true push_args: dest: quay.io/acme
- name: Build and push an image using an auth file containers.podman.podman_image: name: nginx push: true auth_file: /etc/containers/auth.json push_args: dest: quay.io/acme
- name: Build and push an image using username and password containers.podman.podman_image: name: nginx push: true username: bugs password: "{{ vault_registry_password }}" push_args: dest: quay.io/acme
- name: Build and push an image to multiple registries containers.podman.podman_image: name: "{{ item }}" path: /path/to/build/dir push: true auth_file: /etc/containers/auth.json loop: - quay.io/acme/nginx - docker.io/acme/nginx
- name: Build and push an image to multiple registries with separate parameters containers.podman.podman_image: name: "{{ item.name }}" tag: "{{ item.tag }}" path: /path/to/build/dir push: true auth_file: /etc/containers/auth.json push_args: dest: "{{ item.dest }}" loop: - name: nginx tag: 4 dest: docker.io/acme - name: nginx tag: 3 dest: docker.io/acme
- name: Pull an image for a specific CPU architecture containers.podman.podman_image: name: nginx arch: amd64
tag: default: latest description: - Tag of the image to pull, push, or delete. type: str arch: description: - CPU architecture for the container image type: str name: description: - Name of the image to pull, push, or delete. It may contain a tag using the format C(image:tag). required: true type: str path: description: Path to the build context directory. type: str pull: default: true description: Whether or not to pull the image. type: bool push: default: false description: Whether or not to push an image. type: bool build: aliases: - build_args - buildargs default: {} description: Arguments that control image build. suboptions: annotation: description: - Dictionary of key=value pairs to add to the image. Only works with OCI images. Ignored for Docker containers. type: dict cache: default: true description: - Whether or not to use cached layers when building an image type: bool extra_args: description: - Extra args to pass to build, if executed. Does not idempotently check for new build args. type: str file: description: - Path to the Containerfile if it is not in the build context directory. type: path force_rm: default: false description: - Always remove intermediate containers after a build, even if the build is unsuccessful. type: bool format: choices: - docker - oci default: oci description: - Format of the built image. type: str rm: default: true description: Remove intermediate containers after a successful build type: bool target: description: - Specify the target build stage to build. type: str volume: description: - Specify multiple volume / mount options to mount one or more mounts to a container. elements: str type: list type: dict force: default: false description: - Whether or not to force push or pull an image. - When building, force the build even if the image already exists. type: bool state: choices: - present - absent - build default: present description: - Whether an image should be present, absent, or built. type: str password: description: - Password to use when authenticating to remote registries. type: str username: description: - username to use when authenticating to remote registries. type: str auth_file: aliases: - authfile description: - Path to file containing authorization credentials to the remote registry. type: path push_args: default: {} description: Arguments that control pushing images. suboptions: compress: description: - Compress tarball image layers when pushing to a directory using the 'dir' transport. type: bool dest: aliases: - destination description: Path or URL where image will be pushed. type: str format: choices: - oci - v2s1 - v2s2 description: - Manifest type to use when pushing an image using the 'dir' transport (default is manifest type of source). type: str remove_signatures: description: Discard any pre-existing signatures in the image type: bool sign_by: description: - Path to a key file to use to sign the image. type: str transport: choices: - dir - docker-archive - docker-daemon - oci-archive - ostree description: - Transport to use when pushing in image. If no transport is set, will attempt to push to a remote registry. type: str type: dict executable: default: podman description: - Path to C(podman) executable if it is not in the C($PATH) on the machine running C(podman). type: str ca_cert_dir: description: - Path to directory containing TLS certificates and keys to use. type: path validate_certs: aliases: - tlsverify - tls_verify description: - Require HTTPS and validate certificates when pulling or pushing. Also used during build if a pull or push is necessary. type: bool
image: description: - Image inspection results for the image that was pulled, pushed, or built. returned: success sample: - Annotations: {} Architecture: amd64 Author: '' Comment: from Bitnami with love ContainerConfig: Cmd: - /run.sh Entrypoint: - /app-entrypoint.sh Env: - PATH=/opt/bitnami/java/bin:/opt/bitnami/wildfly/bin:/opt/bitnami/nami/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin - IMAGE_OS=debian-9 - NAMI_VERSION=1.0.0-1 - GPG_KEY_SERVERS_LIST=ha.pool.sks-keyservers.net - TINI_VERSION=v0.13.2 - TINI_GPG_KEY=595E85A6B1B4779EA4DAAEC70B588DFF0527A9B7 - GOSU_VERSION=1.10 - GOSU_GPG_KEY=B42F6819007F00F88E364FD4036A9C25BF357DD4 - BITNAMI_IMAGE_VERSION=16.0.0-debian-9-r27 - BITNAMI_PKG_CHMOD=-R g+rwX - BITNAMI_PKG_EXTRA_DIRS=/home/wildfly - HOME=/ - BITNAMI_APP_NAME=wildfly - NAMI_PREFIX=/.nami - WILDFLY_HOME=/home/wildfly - WILDFLY_JAVA_HOME= - WILDFLY_JAVA_OPTS= - WILDFLY_MANAGEMENT_HTTP_PORT_NUMBER=9990 - WILDFLY_PASSWORD=bitnami - WILDFLY_PUBLIC_CONSOLE=true - WILDFLY_SERVER_AJP_PORT_NUMBER=8009 - WILDFLY_SERVER_HTTP_PORT_NUMBER=8080 - WILDFLY_SERVER_INTERFACE=0.0.0.0 - WILDFLY_USERNAME=user - WILDFLY_WILDFLY_HOME=/home/wildfly - WILDFLY_WILDFLY_OPTS=-Dwildfly.as.deployment.ondemand=false ExposedPorts: 8080/tcp: {} 9990/tcp: {} Labels: maintainer: Bitnami <containers@bitnami.com> User: '1001' Created: '2019-04-10T05:48:03.553887623Z' Digest: sha256:5a8ab28e314c2222de3feaf6dac94a0436a37fc08979d2722c99d2bef2619a9b GraphDriver: Data: LowerDir: /var/lib/containers/storage/overlay/142c1beadf1bb09fbd929465ec98c9dca3256638220450efb4214727d0d0680e/diff:/var/lib/containers/s MergedDir: /var/lib/containers/storage/overlay/9aa10191f5bddb59e28508e721fdeb43505e5b395845fa99723ed787878dbfea/merged UpperDir: /var/lib/containers/storage/overlay/9aa10191f5bddb59e28508e721fdeb43505e5b395845fa99723ed787878dbfea/diff WorkDir: /var/lib/containers/storage/overlay/9aa10191f5bddb59e28508e721fdeb43505e5b395845fa99723ed787878dbfea/work Name: overlay History: - comment: from Bitnami with love created: '2019-04-09T22:27:40.659377677Z' - created: '2019-04-09T22:38:53.86336555Z' created_by: '/bin/sh -c #(nop) LABEL maintainer=Bitnami <containers@bitnami.com>' empty_layer: true - created: '2019-04-09T22:38:54.022778765Z' created_by: '/bin/sh -c #(nop) ENV IMAGE_OS=debian-9' empty_layer: true Id: ace34da54e4af2145e1ad277005adb235a214e4dfe1114c2db9ab460b840f785 Labels: maintainer: Bitnami <containers@bitnami.com> ManifestType: application/vnd.docker.distribution.manifest.v1+prettyjws Os: linux Parent: '' RepoDigests: - quay.io/bitnami/wildfly@sha256:5a8ab28e314c2222de3feaf6dac94a0436a37fc08979d2722c99d2bef2619a9b RepoTags: - quay.io/bitnami/wildfly:latest RootFS: Layers: - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' Type: layers Size: 466180019 User: '1001' Version: 18.09.3 VirtualSize: 466180019 type: dict