Spec-Zone.ru › Ansible

community.general.pulp_repo модуль – Добавить или удалить репозитории Pulp на удалённом хосте

Примечание

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

У вас, возможно, уже установлена эта коллекция, если вы используете пакет 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

aliases: importer_ssl_ca_cert

string

Строка сертификата CA, используемая для проверки SSL-сертификата источника данных. Может быть содержимым файла или путём к файлу.

feed_client_cert

aliases: importer_ssl_client_cert

string

Сертификат, используемый в качестве сертификата клиента при синхронизации репозитория. Используется для передачи информации об аутентификации источнику данных. Значение этого параметра должно быть полным путём к сертификату. Указанный файл может содержать сам сертификат или один файл, содержащий и сертификат, и закрытый ключ. Может быть содержимым файла или путём к файлу.

feed_client_key

aliases: importer_ssl_client_key

string

Закрытый ключ к сертификату, указанному в feed_client_cert, если он не включён в сам файл сертификата. Может быть содержимым файла или путём к файлу.

force

boolean

Если yes не использовать кэшированную копию.

Варианты:

  • false ← (по умолчанию)
  • true

force_basic_auth

boolean

httplib2, библиотека, используемая модулем ansible.builtin.uri, отправляет информацию об аутентификации только тогда, когда веб-сервис отвечает на начальный запрос статусом 401. Поскольку некоторые службы basic auth не отправляют 401 должным образом, вход может завершиться ошибкой. Этот параметр принудительно отправляет заголовок Basic authentication при первом запросе.

Варианты:

  • false ← (по умолчанию)
  • true

generate_sqlite

boolean

Флаг boolean, указывающий, должны ли генерироваться файлы sqlite при публикации репозитория.

Варианты:

  • false ← (по умолчанию)
  • true

http_agent

string

Заголовок для идентификации, обычно отображается в логах веб-сервера.

По умолчанию: "ansible-httpget"

name

aliases: repo

string / обязательно

Имя репозитория для добавления или удаления. Соответствует значению repo-id в Pulp.

proxy_host

string

Настройка URL-адреса прокси для импортера репозитория pulp. Формат — схема://хост.

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 Basic с API pulp. Если параметр url_username не указан, параметр url_password не будет использован.

url_username

string

Имя пользователя для использования в аутентификации HTTP Basic с API pulp.

use_gssapi

boolean

added in 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

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз изменения статуса без изменения целевого объекта.

diff_mode

Поддержка: отсутствует

Вернет подробности о том, что изменилось (или, возможно, должно измениться в check_mode), когда режим diff.

Примечания

Примечание

  • В настоящее время этот модуль может создавать только дистрибуторы и импортеры для репозиториев 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

строка

Имя репозитория, к которому было применено действие.

Возвращается: успех

Пример: "my_repo"

Авторы

  • Джо Адамс (@sysadmind)

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

  • Система отслеживания задач
  • Репозиторий (исходные коды)
  • Задать вопрос о помощи
  • Отправить отчет об ошибке
  • Запросить функцию
  • Общение

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/pulp_repo_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API