containers.podman.podman_network_info module – Gather info about podman networks

Note

This module is part of the containers.podman collection (version 1.12.1).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install containers.podman. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: containers.podman.podman_network_info.

New in containers.podman 1.0.0

Synopsis

  • Gather info about podman networks with podman inspect command.

Requirements

The below requirements are needed on the host that executes this module.

  • Podman installed on host

Parameters

Parameter

Comments

executable

string

Path to podman executable if it is not in the $PATH on the machine running podman

Default: "podman"

name

string

Name of the network

Examples

- name: Gather info about all present networks
  containers.podman.podman_network_info:

- name: Gather info about specific network
  containers.podman.podman_network_info:
    name: podman

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

networks

list / elements=string

Facts from all or specified networks

Returned: always

Sample: [{"cniVersion": "0.4.0", "name": "podman", "plugins": [{"bridge": "cni-podman0", "ipMasq": true, "ipam": {"ranges": [[{"gateway": "10.88.0.1", "subnet": "10.88.0.0/16"}]], "routes": [{"dst": "0.0.0.0/0"}], "type": "host-local"}, "isGateway": true, "type": "bridge"}, {"capabilities": {"portMappings": true}, "type": "portmap"}, {"backend": "iptables", "type": "firewall"}]}]

Authors

  • Sagi Shnaidman (@sshnaidm)