mirror of
https://github.com/containers/ansible-podman-collections.git
synced 2026-02-04 07:11:49 +00:00
Add podman system info module (#922)
Add podman system info module Signed-off-by: johnsonlien <johnsonlien95@gmail.com> Signed-off-by: Sagi Shnaidman <sshnaidm@redhat.com> Co-authored-by: Sagi Shnaidman <sshnaidm@redhat.com>
This commit is contained in:
parent
f6bd81e820
commit
aa20ede71e
4 changed files with 388 additions and 0 deletions
107
.github/workflows/podman_system_info.yml
vendored
Normal file
107
.github/workflows/podman_system_info.yml
vendored
Normal file
|
|
@ -0,0 +1,107 @@
|
|||
name: Podman system info
|
||||
|
||||
on:
|
||||
push:
|
||||
paths:
|
||||
- '.github/workflows/podman_system_info.yml'
|
||||
- 'ci/*.yml'
|
||||
- 'ci/run_containers_tests.sh'
|
||||
- 'ci/playbooks/containers/podman_system_info.yml'
|
||||
- 'plugins/modules/podman_system_info.py'
|
||||
- 'tests/integration/targets/podman_system_info/**'
|
||||
branches:
|
||||
- main
|
||||
pull_request:
|
||||
paths:
|
||||
- '.github/workflows/podman_system_info.yml'
|
||||
- 'ci/*.yml'
|
||||
- 'ci/run_containers_tests.sh'
|
||||
- 'ci/playbooks/containers/podman_system_info.yml'
|
||||
- 'plugins/modules/podman_system_info.py'
|
||||
- 'tests/integration/targets/podman_system_info/**'
|
||||
schedule:
|
||||
- cron: 4 0 * * * # Run daily at 0:03 UTC
|
||||
|
||||
jobs:
|
||||
|
||||
test_podman_system_info:
|
||||
name: Podman system info ${{ matrix.ansible-version }}-${{ matrix.os || 'ubuntu-22.04' }}
|
||||
runs-on: ${{ matrix.os || 'ubuntu-22.04' }}
|
||||
defaults:
|
||||
run:
|
||||
shell: bash
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
ansible-version:
|
||||
- git+https://github.com/ansible/ansible.git@stable-2.17
|
||||
- git+https://github.com/ansible/ansible.git@devel
|
||||
os:
|
||||
- ubuntu-22.04
|
||||
python-version:
|
||||
- "3.11"
|
||||
|
||||
steps:
|
||||
|
||||
- name: Check out repository
|
||||
uses: actions/checkout@v4
|
||||
|
||||
- name: Set up Python ${{ matrix.python-version }}
|
||||
uses: actions/setup-python@v5
|
||||
with:
|
||||
python-version: ${{ matrix.python-version }}
|
||||
|
||||
- name: Upgrade pip and display Python and PIP versions
|
||||
run: |
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y python*-wheel python*-yaml
|
||||
python -m pip install --upgrade pip
|
||||
python -V
|
||||
pip --version
|
||||
|
||||
- name: Set up pip cache
|
||||
uses: actions/cache@v4
|
||||
with:
|
||||
path: ~/.cache/pip
|
||||
key: ${{ runner.os }}-pip-${{ github.ref }}-units-VMs
|
||||
restore-keys: |
|
||||
${{ runner.os }}-pip-
|
||||
${{ runner.os }}-
|
||||
|
||||
- name: Install Ansible ${{ matrix.ansible-version }}
|
||||
run: python3 -m pip install --user --force-reinstall --upgrade '${{ matrix.ansible-version }}'
|
||||
|
||||
- name: Build and install the collection tarball
|
||||
run: |
|
||||
export PATH=~/.local/bin:$PATH
|
||||
|
||||
echo "Run ansible version"
|
||||
command -v ansible
|
||||
ansible --version
|
||||
rm -rf /tmp/just_new_collection
|
||||
~/.local/bin/ansible-galaxy collection build --output-path /tmp/just_new_collection --force
|
||||
~/.local/bin/ansible-galaxy collection install -vvv --force /tmp/just_new_collection/*.tar.gz
|
||||
|
||||
- name: Run collection tests for podman system info
|
||||
run: |
|
||||
export PATH=~/.local/bin:$PATH
|
||||
|
||||
export ANSIBLE_CONFIG=$(pwd)/ci/ansible-dev.cfg
|
||||
if [[ '${{ matrix.ansible-version }}' == 'ansible<2.10' ]]; then
|
||||
export ANSIBLE_CONFIG=$(pwd)/ci/ansible-2.9.cfg
|
||||
fi
|
||||
|
||||
echo $ANSIBLE_CONFIG
|
||||
command -v ansible-playbook
|
||||
pip --version
|
||||
python --version
|
||||
ansible-playbook --version
|
||||
|
||||
ansible-playbook -vv ci/playbooks/pre.yml \
|
||||
-e host=localhost \
|
||||
-i localhost, \
|
||||
-e ansible_connection=local \
|
||||
-e setup_python=false
|
||||
|
||||
TEST2RUN=podman_system_info ./ci/run_containers_tests.sh
|
||||
shell: bash
|
||||
8
ci/playbooks/containers/podman_system_info.yml
Normal file
8
ci/playbooks/containers/podman_system_info.yml
Normal file
|
|
@ -0,0 +1,8 @@
|
|||
---
|
||||
- hosts: all
|
||||
gather_facts: true
|
||||
tasks:
|
||||
- include_role:
|
||||
name: podman_system_info
|
||||
vars:
|
||||
ansible_python_interpreter: "{{ _ansible_python_interpreter }}"
|
||||
264
plugins/modules/podman_system_info.py
Normal file
264
plugins/modules/podman_system_info.py
Normal file
|
|
@ -0,0 +1,264 @@
|
|||
#!/usr/bin/python
|
||||
# Copyright (c) 2025 Ansible Project
|
||||
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||
|
||||
from __future__ import absolute_import, division, print_function
|
||||
|
||||
__metaclass__ = type
|
||||
|
||||
DOCUMENTATION = r"""
|
||||
module: podman_system_info
|
||||
author:
|
||||
- Johnson Lien (@johnsonlien)
|
||||
short_description: Get podman system information from host machine
|
||||
description: Runs "podman system info" on host machine
|
||||
requirements:
|
||||
- "Podman installed on host"
|
||||
options:
|
||||
executable:
|
||||
description:
|
||||
- Path to C(podman) executable if it is not in the C($PATH) on the
|
||||
machine running C(podman)
|
||||
default: 'podman'
|
||||
type: str
|
||||
"""
|
||||
|
||||
EXAMPLES = r"""
|
||||
- name: Get Podman system information
|
||||
containers.podman.podman_system_info:
|
||||
|
||||
- name: Get Podman system information into a variable
|
||||
containers.podman.podman_system_info:
|
||||
register: podman_info
|
||||
- name: Printing Podman System info
|
||||
debug:
|
||||
msg: "{{ podman_info['podman_system_info'] }}"
|
||||
"""
|
||||
|
||||
RETURN = r"""
|
||||
podman_system_info:
|
||||
description: System information from podman
|
||||
returned: always
|
||||
type: dict
|
||||
sample:
|
||||
{
|
||||
"host": {
|
||||
"arch": "amd64",
|
||||
"buildahVersion": "1.40.1",
|
||||
"cgroupManager": "systemd",
|
||||
"cgroupVersion": "v2",
|
||||
"cgroupControllers": [
|
||||
"cpu",
|
||||
"io",
|
||||
"memory",
|
||||
"pids"
|
||||
],
|
||||
"conmon": {
|
||||
"package": "conmon-2.1.13-1.fc41.x86_64",
|
||||
"path": "/usr/bin/conmon",
|
||||
"version": "conmon version 2.1.13, commit "
|
||||
},
|
||||
"cpus": 12,
|
||||
"cpuUtilization": {
|
||||
"userPercent": 5.73,
|
||||
"systemPercent": 2.15,
|
||||
"idlePercent": 92.12
|
||||
},
|
||||
"databaseBackend": "boltdb",
|
||||
"distribution": {
|
||||
"distribution": "fedora",
|
||||
"variant": "workstation",
|
||||
"version": "41"
|
||||
},
|
||||
"eventLogger": "journald",
|
||||
"freeLocks": 897,
|
||||
"hostname": "user.remote",
|
||||
"idMappings": {
|
||||
"gidmap": [
|
||||
{
|
||||
"container_id": 0,
|
||||
"host_id": 1000,
|
||||
"size": 1
|
||||
},
|
||||
{
|
||||
"container_id": 1,
|
||||
"host_id": 100000,
|
||||
"size": 65536
|
||||
}
|
||||
],
|
||||
"uidmap": [
|
||||
{
|
||||
"container_id": 0,
|
||||
"host_id": 1000,
|
||||
"size": 1
|
||||
},
|
||||
{
|
||||
"container_id": 1,
|
||||
"host_id": 100000,
|
||||
"size": 65536
|
||||
}
|
||||
]
|
||||
},
|
||||
"kernel": "6.14.9-200.fc41.x86_64",
|
||||
"logDriver": "journald",
|
||||
"memFree": 3055095808,
|
||||
"memTotal": 67157032960,
|
||||
"networkBackend": "netavark",
|
||||
"networkBackendInfo": {
|
||||
"backend": "netavark",
|
||||
"version": "netavark 1.15.2",
|
||||
"package": "netavark-1.15.2-1.fc41.x86_64",
|
||||
"path": "/usr/libexec/podman/netavark",
|
||||
"dns": {
|
||||
"version": "aardvark-dns 1.15.0",
|
||||
"package": "aardvark-dns-1.15.0-1.fc41.x86_64",
|
||||
"path": "/usr/libexec/podman/aardvark-dns"
|
||||
}
|
||||
},
|
||||
"ociRuntime": {
|
||||
"name": "crun",
|
||||
"package": "crun-1.21-1.fc41.x86_64",
|
||||
"path": "/usr/bin/crun",
|
||||
"version": "crun version 1.21..."
|
||||
},
|
||||
"os": "linux",
|
||||
"remoteSocket": {
|
||||
"path": "/run/user/1000/podman/podman.sock",
|
||||
"exists": true
|
||||
},
|
||||
"rootlessNetworkCmd": "pasta",
|
||||
"serviceIsRemote": false,
|
||||
"security": {
|
||||
"apparmorEnabled": false,
|
||||
"capabilities": "CAP_CHOWN,CAP_DAC_OVERRIDE,CAP_FOWNER,CAP_FSETID,CAP_KILL,...",
|
||||
"rootless": true,
|
||||
"seccompEnabled": true,
|
||||
"seccompProfilePath": "/usr/share/containers/seccomp.json",
|
||||
"selinuxEnabled": true
|
||||
},
|
||||
"slirp4netns": {
|
||||
"executable": "/usr/bin/slirp4netns",
|
||||
"package": "slirp4netns-1.3.1-1.fc41.x86_64",
|
||||
"version": "slirp4netns version 1.3.1\ncommit..."
|
||||
},
|
||||
"pasta": {
|
||||
"executable": "/usr/bin/pasta",
|
||||
"package": "passt-0^20250611.g0293c6f-1.fc41.x86_64",
|
||||
"version": "pasta 0^20250611.g0293c6f-1.fc41.x86_64\nCopyright Red Hat\n..."
|
||||
},
|
||||
"swapFree": 1911504896,
|
||||
"swapTotal": 8589930496,
|
||||
"uptime": "115h 11m 51.00s (Approximately 3.88 days)",
|
||||
"variant": "",
|
||||
"linkmode": "dynamic"
|
||||
},
|
||||
"store": {
|
||||
"configFile": "/home/user/.config/containers/storage.conf",
|
||||
"containerStore": {
|
||||
"number": 6,
|
||||
"paused": 0,
|
||||
"running": 1,
|
||||
"stopped": 5
|
||||
},
|
||||
"graphDriverName": "overlay",
|
||||
"graphOptions": {
|
||||
"overlay.mountopt": "nodev"
|
||||
},
|
||||
"graphRoot": "/home/user/.local/share/containers/storage",
|
||||
"graphRootAllocated": 502921060352,
|
||||
"graphRootUsed": 457285541888,
|
||||
"graphStatus": {
|
||||
"Backing Filesystem": "extfs",
|
||||
"Native Overlay Diff": "false",
|
||||
"Supports d_type": "true",
|
||||
"Supports shifting": "true",
|
||||
"Supports volatile": "true",
|
||||
"Using metacopy": "false"
|
||||
},
|
||||
"imageCopyTmpDir": "/var/tmp",
|
||||
"imageStore": {
|
||||
"number": 859
|
||||
},
|
||||
"runRoot": "/run/user/1000/containers",
|
||||
"volumePath": "/storage/containers/storage/volumes",
|
||||
"transientStore": false
|
||||
},
|
||||
"registries": {
|
||||
"search": [
|
||||
"registry.fedoraproject.org",
|
||||
"registry.access.redhat.com",
|
||||
"docker.io"
|
||||
]
|
||||
},
|
||||
"plugins": {
|
||||
"volume": [
|
||||
"local"
|
||||
],
|
||||
"network": [
|
||||
"bridge",
|
||||
"macvlan",
|
||||
"ipvlan"
|
||||
],
|
||||
"log": [
|
||||
"k8s-file",
|
||||
"none",
|
||||
"passthrough",
|
||||
"journald"
|
||||
],
|
||||
"authorization": null
|
||||
},
|
||||
"version": {
|
||||
"APIVersion": "5.5.1",
|
||||
"Version": "5.5.1",
|
||||
"GoVersion": "go1.23.9",
|
||||
"GitCommit": "850db76dd78a0641eddb9ee19ee6f60d2c59bcfa",
|
||||
"BuiltTime": "Thu Jun 5 03:00:00 2025",
|
||||
"Built": 1749081600,
|
||||
"BuildOrigin": "Fedora Project",
|
||||
"OsArch": "linux/amd64",
|
||||
"Os": "linux"
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
import json
|
||||
|
||||
from ansible.module_utils.basic import AnsibleModule
|
||||
|
||||
|
||||
def get_podman_system_info(module, executable):
|
||||
command = [executable, "system", "info", "--format", "json"]
|
||||
rc, out, err = module.run_command(command)
|
||||
out = out.strip()
|
||||
if out:
|
||||
try:
|
||||
return json.loads(out)
|
||||
except Exception as e:
|
||||
module.fail_json(
|
||||
msg="Failed to parse podman system info output: error: %s, output: %s err: %s" % (e, out, err),
|
||||
exception=str(e),
|
||||
)
|
||||
|
||||
|
||||
def main():
|
||||
module = AnsibleModule(
|
||||
argument_spec=dict(
|
||||
executable=dict(type="str", default="podman"),
|
||||
),
|
||||
supports_check_mode=True,
|
||||
)
|
||||
|
||||
executable = module.get_bin_path(module.params["executable"], required=True)
|
||||
|
||||
results = get_podman_system_info(module, executable)
|
||||
|
||||
results = dict(
|
||||
changed=False,
|
||||
podman_system_info=results,
|
||||
)
|
||||
|
||||
module.exit_json(**results)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
- name: Get Podman system info
|
||||
containers.podman.podman_system_info:
|
||||
executable: "{{ test_executable | default('podman') }}"
|
||||
register: podman_info
|
||||
|
||||
- name: Check results
|
||||
assert:
|
||||
that:
|
||||
- podman_info.podman_system_info | length > 0
|
||||
Loading…
Add table
Add a link
Reference in a new issue