Модуль community.general.pulp_repo — добавление и удаление репозиториев Pulp на удалённом узле

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

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

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать коллекцию в плейбуке, укажите: community.general.pulp_repo.

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

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

Добавляет или удаляет репозитории Pulp на удалённом узле.
Обратите внимание: этот модуль предназначен только для Pulp 2.

Параметры

Параметр	Комментарии
add_export_distributor boolean	Следует ли добавлять дистрибьютор экспорта в новые репозитории `rpm`. Варианты: `false` ← (по умолчанию) `true`
client_cert path	Файл цепочки сертификатов в формате PEM, используемый для аутентификации клиента SSL. Этот файл также может содержать ключ; если ключ включён в файл, параметр `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий закрытый ключ для аутентификации клиента SSL. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
feed string	URL вышестоящего источника для получения обновлений.
feed_ca_cert псевдонимы: importer_ssl_ca_cert string	Строка сертификата CA, используемая для проверки SSL-сертификата источника feed. Это может быть содержимое файла или путь к нему.
feed_client_cert псевдонимы: importer_ssl_client_cert string	Сертификат клиента, используемый при синхронизации репозитория. Он служит для передачи данных аутентификации источнику feed. Значением этого параметра должен быть полный путь к сертификату. Указанный файл может содержать только сертификат либо сертификат вместе с закрытым ключом. Это может быть содержимое файла или путь к нему.
feed_client_key псевдонимы: importer_ssl_client_key string	Закрытый ключ для сертификата, указанного в `feed_client_cert`, если он не включён в сам файл сертификата. Это может быть содержимое файла или путь к нему.
force boolean	Если `yes`, не использовать кэшированную копию. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth boolean	Библиотека `httplib2`, используемая модулем ansible.builtin.uri, передаёт данные аутентификации только после того, как веб-служба отвечает кодом состояния 401 на первоначальный запрос. Поскольку некоторые службы с базовой аутентификацией некорректно отправляют код 401, вход в систему завершается ошибкой. Этот параметр принудительно отправляет заголовок базовой аутентификации уже при первоначальном запросе. Варианты: `false` ← (по умолчанию) `true`
generate_sqlite boolean	Логический флаг, указывающий, следует ли создавать файлы sqlite при публикации репозитория. Варианты: `false` ← (по умолчанию) `true`
http_agent string	Значение заголовка идентификатора, обычно отображаемое в журналах веб-сервера. По умолчанию: `"ansible-httpget"`
name псевдонимы: repo string / обязательный	Имя репозитория для добавления или удаления. Соответствует repo-id в Pulp.
proxy_host string	Настройка URL прокси для импортёра репозитория Pulp. Формат: `scheme://host`.
proxy_password string	Пароль прокси для импортёра репозитория Pulp.
proxy_port string	Настройка порта прокси для импортёра репозитория Pulp.
proxy_username string	Имя пользователя прокси для импортёра репозитория Pulp.
publish_distributor string	Дистрибьютор, используемый при `state=publish`. По умолчанию публикуются все дистрибьюторы.
pulp_host string	URL сервера Pulp, к которому нужно подключиться. По умолчанию: `"https://127.0.0.1"`
relative_url string	Относительный URL локального репозитория. Обязателен, если state=present.
repo_type string	Тип подключаемого модуля репозитория (то есть `rpm`, `docker`). По умолчанию: `"rpm"`
repoview boolean	Следует ли создавать файлы repoview для опубликованного репозитория. При установке значения `true` автоматически активируется `generate_sqlite`. Варианты: `false` ← (по умолчанию) `true`
serve_http boolean	Сделать репозиторий доступным по HTTP. Варианты: `false` ← (по умолчанию) `true`
serve_https boolean	Сделать репозиторий доступным по HTTPS. Варианты: `false` `true` ← (по умолчанию)
state string	Состояние репозитория. Состояние `sync` ставит синхронизацию репозитория в очередь. Она выполняется асинхронно, но, в отличие от запланированной синхронизации, без задержки. Состояние `publish` использует дистрибьютор репозитория для публикации содержимого. Варианты: `"present"` ← (по умолчанию) `"absent"` `"sync"` `"publish"`
url string	URL HTTP, HTTPS или FTP в формате (http\|https\|ftp)://[user[:pass]]@host.domain[:port]/path
url_password string	Пароль для базовой HTTP-аутентификации в API Pulp. Если параметр `url_username` не указан, параметр `url_password` не используется.
url_username string	Имя пользователя для базовой HTTP-аутентификации в API Pulp.
use_gssapi boolean добавлено в ansible-core 2.11	Использовать GSSAPI для аутентификации; обычно применяется Kerberos или Kerberos через аутентификацию Negotiate. Требуется установленная библиотека Python gssapi. Учётные данные GSSAPI можно указать с помощью `url_username`/`url_password` или переменной среды GSSAPI `KRB5CCNAME`, задающей пользовательский кэш учётных данных Kerberos. Аутентификация NTLM не поддерживается, даже если установлен механизм GSSAPI для NTLM. Варианты: `false` ← (по умолчанию) `true`
use_proxy boolean	Если `no`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Если `false`, SSL-сертификаты не проверяются. Этот параметр следует использовать только на подконтрольных вам сайтах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)
wait_for_completion boolean	Дождаться завершения асинхронных задач перед возвратом. Варианты: `false` ← (по умолчанию) `true`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: full	Может выполняться в режиме `check_mode` и возвращать прогноз изменения статуса без изменения целевого узла.
diff_mode	Поддержка: none	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

В настоящее время этот модуль может создавать дистрибьюторы и импортёры только для RPM-репозиториев. Будем рады вкладу в поддержку других типов репозиториев.

Примеры

- name: Create a new repo with name 'my_repo'
  community.general.pulp_repo:
    name: my_repo
    relative_url: my/repo
    state: present

- name: Create a repo with a feed and a relative URL
  community.general.pulp_repo:
    name: my_centos_updates
    repo_type: rpm
    feed: http://mirror.centos.org/centos/6/updates/x86_64/
    relative_url: centos/6/updates
    url_username: admin
    url_password: admin
    force_basic_auth: true
    state: present

- name: Remove a repo from the pulp server
  community.general.pulp_repo:
    name: my_old_repo
    repo_type: rpm
    state: absent

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

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

Ключ	Описание
repo string	Имя репозитория, над которым было выполнено действие. Возвращается: success Пример: `"my_repo"`

Авторы

Joe Adams (@sysadmind)

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

© 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/community/general/pulp_repo_module.html