community.general.pulp_repo – Добавить или удалить репозитории Pulp с удаленного хоста.
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.pulp_repo.
Обзор
- Добавить или удалить репозитории Pulp с удалённого хоста.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| add_export_distributor boolean |
| Добавить экспортный дистрибутор в новые rpm репозитории. |
| client_cert path | Файл цепочки сертификатов в формате PEM для аутентификации клиента SSL. Этот файл также может содержать ключ, и если ключ включён, client_key не требуется. | |
| client_key path | Файл в формате PEM, содержащий ваш закрытый ключ для аутентификации клиента SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не нужен. | |
| feed string | URL исходного фида для получения обновлений. | |
| feed_ca_cert string | Строка сертификата CA, используемая для проверки сертификата SSL источника фида. Может быть содержимым файла или путём к файлу. Псевдоним ca_cert будет удален в community.general 3.0.0. псевдонимы: importer_ssl_ca_cert, ca_cert | |
| feed_client_cert string | Сертификат, используемый в качестве клиентского сертификата при синхронизации репозитория. Используется для передачи данных аутентификации источнику фида. Значение этого параметра должно быть полным путём к сертификату. Указанный файл может содержать сам сертификат или единый файл, содержащий как сертификат, так и закрытый ключ. Может быть содержимым файла или путём к файлу. Если не указано, значение по умолчанию будет взято из client_cert. Это изменится в community.general 3.0.0. псевдонимы: importer_ssl_client_cert | |
| feed_client_key string | Закрытый ключ к сертификату, указанному в importer_ssl_client_cert, если он не включён в сам сертификат файла. Может быть содержимым файла или путём к файлу. Если не указано, значение по умолчанию будет взято из client_key. Это изменится в community.general 3.0.0. псевдонимы: importer_ssl_client_key | |
| force boolean |
| Если yes не получить кэшированную копию.Псевдоним thirsty устарел и будет удалён в версии 2.13.псевдонимы: thirsty |
| force_basic_auth boolean |
| httplib2, библиотека, используемая модулем ansible.builtin.uri, отправляет данные аутентификации только тогда, когда веб-сервис отвечает на начальный запрос статусом 401. Поскольку некоторые сервисы basic auth не отправляют должным образом 401, авторизация может не удаться. Этот параметр принудительно отправляет заголовок Basic authentication при первом запросе. |
| generate_sqlite boolean |
| Флаг булевого типа, указывающий, нужно ли генерировать файлы sqlite во время публикации репозитория. |
| http_agent string | Значение по умолчанию: "ansible-httpget" | Заголовок, идентифицирующий пользователя, обычно отображается в логах веб-сервера. |
| name string / обязательный | Имя репозитория для добавления или удаления. Соответствует repo-id в Pulp. псевдонимы: repo | |
| proxy_host string | Настройка URL прокси для импортера репозитория pulp. Формат: схема://хост. | |
| proxy_password string | Пароль прокси для импортера репозитория pulp. | |
| proxy_port string | Настройка порта прокси для импортера репозитория pulp. | |
| proxy_username string | Имя пользователя прокси для импортера репозитория pulp. | |
| publish_distributor string | Дистрибутор, используемый, когда состояние publish. По умолчанию публикуются все дистрибуторы. | |
| pulp_host string | Значение по умолчанию: "https://127.0.0.1" | URL сервера pulp для подключения. |
| relative_url string | Относительный URL для локального репозитория. Требуется, когда состояние=present. | |
| repo_type string | Значение по умолчанию: "rpm" | Тип плагина репозитория (например, rpm, docker). |
| repoview boolean |
| Генерировать файлы repoview для опубликованного репозитория. Установка в "да" автоматически активирует `generate_sqlite`. |
| serve_http boolean |
| Сделать репозиторий доступным через HTTP. |
| serve_https boolean |
| Сделать репозиторий доступным через HTTPS. |
| state string |
| Состояние репозитория. Состояние sync поставит репозиторий в очередь на синхронизацию. Это асинхронно, но не откладывается, как запланированная синхронизация. Состояние publish будет использовать дистрибутор репозитория для публикации содержимого. |
| url string | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password string | Пароль для использования в HTTP-аутентификации по основанию pulp API. Если параметр url_username не указан, параметр url_password не будет использоваться. | |
| url_username string | Имя пользователя для использования в HTTP-аутентификации по основанию pulp API. | |
| use_gssapi boolean добавлен в 2.11 ansible.builtin |
| Использовать GSSAPI для выполнения аутентификации, обычно для Kerberos или Kerberos через аутентификацию Negotiate. Требуется установка Python-библиотеки gssapi. Учетные данные для GSSAPI можно указать с помощью url_username/url_password или с помощью переменной окружения GSSAPI KRB5CCNAME, которая указывает на пользовательский кэш учетных данных Kerberos.NTLM аутентификация not поддерживается, даже если механизм GSSAPI для NTLM установлен. |
| use_proxy boolean |
| Если no, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах. |
| validate_certs boolean |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах, использующих самозаверяющие сертификаты. |
| wait_for_completion boolean |
| Ожидать завершения асинхронных задач перед возвратом. |
Примечания
Примечание
- В настоящее время модуль может создавать только дистрибуторы и импортеры для репозиториев 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: yes
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 | успех | Имя репозитория, на котором выполнено действие. Пример: my_repo |
Авторы
- Joe Adams (@sysadmind)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/pulp_repo_module.html