mirror of
https://github.com/ansible-collections/community.docker.git
synced 2025-12-15 11:32:05 +00:00
123 lines
3.1 KiB
Python
123 lines
3.1 KiB
Python
#!/usr/bin/python
|
|
|
|
# Copyright (c) 2020 Jose Angel Munoz (@imjoseangel)
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
DOCUMENTATION = r"""
|
|
module: docker_stack_info
|
|
author: "Jose Angel Munoz (@imjoseangel)"
|
|
short_description: Return information on all docker stacks
|
|
description:
|
|
- Retrieve information on docker stacks using the C(docker stack) command on the target node (see examples).
|
|
requirements:
|
|
- Docker CLI tool C(docker)
|
|
extends_documentation_fragment:
|
|
- community.docker._docker.cli_documentation
|
|
- community.docker._attributes
|
|
- community.docker._attributes.actiongroup_docker
|
|
- community.docker._attributes.info_module
|
|
- community.docker._attributes.idempotent_not_modify_state
|
|
attributes:
|
|
action_group:
|
|
version_added: 3.6.0
|
|
options:
|
|
docker_cli:
|
|
version_added: 3.6.0
|
|
docker_host:
|
|
version_added: 3.6.0
|
|
tls_hostname:
|
|
version_added: 3.6.0
|
|
api_version:
|
|
version_added: 3.6.0
|
|
ca_path:
|
|
version_added: 3.6.0
|
|
client_cert:
|
|
version_added: 3.6.0
|
|
client_key:
|
|
version_added: 3.6.0
|
|
tls:
|
|
version_added: 3.6.0
|
|
validate_certs:
|
|
version_added: 3.6.0
|
|
cli_context:
|
|
version_added: 3.6.0
|
|
seealso:
|
|
- module: community.docker.docker_stack_task_info
|
|
description: >-
|
|
To retrieve detailed information about the services under a specific stack use the M(community.docker.docker_stack_task_info)
|
|
module.
|
|
"""
|
|
|
|
RETURN = r"""
|
|
results:
|
|
description:
|
|
- List of dictionaries containing the list of stacks on the target node.
|
|
sample:
|
|
- {"name": "grafana", "namespace": "default", "orchestrator": "Kubernetes", "services": "2"}
|
|
returned: always
|
|
type: list
|
|
elements: dict
|
|
"""
|
|
|
|
EXAMPLES = r"""
|
|
---
|
|
- name: Shows stack info
|
|
community.docker.docker_stack_info:
|
|
register: result
|
|
|
|
- name: Show results
|
|
ansible.builtin.debug:
|
|
var: result.results
|
|
"""
|
|
|
|
import json
|
|
import traceback
|
|
|
|
from ansible.module_utils.common.text.converters import to_native
|
|
|
|
from ansible_collections.community.docker.plugins.module_utils._common_cli import (
|
|
AnsibleModuleDockerClient,
|
|
DockerException,
|
|
)
|
|
|
|
|
|
def docker_stack_list(module):
|
|
docker_bin = module.get_bin_path("docker", required=True)
|
|
rc, out, err = module.run_command(
|
|
[docker_bin, "stack", "ls", "--format={{json .}}"]
|
|
)
|
|
|
|
return rc, out.strip(), err.strip()
|
|
|
|
|
|
def main():
|
|
client = AnsibleModuleDockerClient(
|
|
argument_spec={},
|
|
supports_check_mode=True,
|
|
)
|
|
|
|
try:
|
|
rc, ret, stderr = client.call_cli_json_stream(
|
|
"stack", "ls", "--format={{json .}}", check_rc=True
|
|
)
|
|
client.module.exit_json(
|
|
changed=False,
|
|
rc=rc,
|
|
stdout="\n".join([json.dumps(entry) for entry in ret]),
|
|
stderr=to_native(stderr).strip(),
|
|
results=ret,
|
|
)
|
|
except DockerException as e:
|
|
client.fail(
|
|
f"An unexpected Docker error occurred: {e}",
|
|
exception=traceback.format_exc(),
|
|
)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|