Модуль containers.podman.podman_system_connection — управление системными подключениями Podman

Примечание

Этот модуль входит в коллекцию containers.podman (версия 1.20.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install containers.podman. Для использования этого модуля требуются дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: containers.podman.podman_system_connection.

Добавлено в containers.podman 1.18.0

Краткое описание
Требования
Параметры
Примеры
Возвращаемые значения

Краткое описание

Управление системными подключениями Podman с помощью команды podman system connection.
Добавление, удаление, переименование подключений к службам Podman и назначение подключения по умолчанию.

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

podman

Параметры

Параметр	Описание
default логическое значение	Сделать это подключение подключением по умолчанию для данного пользователя Возможные значения: `false` `true`
destination строка	Адрес назначения для подключения. Обязателен, если state=present. Может быть указан в формате `[user@]hostname[:port]`, `ssh://[user@]hostname[:port]`, `unix://path`, `tcp://hostname:port`
executable строка	Путь к исполняемому файлу `podman`, если он отсутствует в `$PATH` на машине, где выполняется `podman` По умолчанию: `"podman"`
identity строка	Путь к файлу идентификации SSH
name строка / обязательный	Имя подключения
new_name строка	Новое имя подключения при переименовании (используется с state=present)
port целое число	Порт SSH (по умолчанию — 22)
socket_path строка	Путь к сокету домена Unix службы Podman на целевом узле SSH
state строка	Состояние подключения Возможные значения: `"present"` ← (по умолчанию) `"absent"`

Примеры

- name: Add a basic SSH connection
  containers.podman.podman_system_connection:
    name: production
    destination: root@server.example.com
    state: present

- name: Add SSH connection with custom port and identity
  containers.podman.podman_system_connection:
    name: staging
    destination: user@staging.example.com
    port: 2222
    identity: ~/.ssh/staging_rsa
    state: present

- name: Add connection and set as default
  containers.podman.podman_system_connection:
    name: development
    destination: dev@dev.example.com
    default: true
    state: present

- name: Add unix socket connection
  containers.podman.podman_system_connection:
    name: local
    destination: unix:///run/podman/podman.sock
    state: present

- name: Add TCP connection
  containers.podman.podman_system_connection:
    name: remote_tcp
    destination: tcp://remote.example.com:8080
    state: present

- name: Rename a connection
  containers.podman.podman_system_connection:
    name: old_name
    new_name: new_name
    state: present

- name: Remove a connection
  containers.podman.podman_system_connection:
    name: old_connection
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
actions список / элементы=строка	Действия, выполненные с подключением Возвращается: всегда Пример: `["Connection 'production' added", "Connection 'production' set as default"]`
connection словарь	Сведения о подключении в формате JSON Podman Возвращается: всегда Пример: `{"Default": true, "Name": "production", "ReadWrite": true, "URI": "ssh://root@server.example.com:22/run/user/0/podman/podman.sock"}`

Авторы

Sagi Shnaidman (@sshnaidm)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/containers/podman/podman_system_connection_module.html