Spec-Zone.ru › Ansible

Модуль theforeman.foreman.repository – Управление репозиториями

Примечание

Этот модуль входит в коллекцию theforeman.foreman (версия 4.2.0).

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

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

Чтобы использовать его в плейбуке, укажите: theforeman.foreman.repository.

Новое в theforeman.foreman 1.0.0

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

Описание

  • Создание и управление репозиториями

Псевдонимы: katello_repository

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • requests
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

ansible_collection_requirements

string

Содержимое файла требований yaml для синхронизации с URL

arch

string

Архитектура содержимого репозитория

Установите значение noarch для отключения ограничения архитектуры.

auto_enabled

boolean

Репозитории будут автоматически активированы на зарегистрированном хосте, подписанном на этот продукт

Варианты:

  • false
  • true

checksum_type

string

Контрольная сумма репозитория

Варианты:

  • "sha1"
  • "sha256"

content_type

string / required

Тип содержимого репозитория

Варианты:

  • "deb"
  • "docker"
  • "file"
  • "ostree"
  • "puppet"
  • "yum"
  • "ansible_collection"

deb_architectures

string

Список архитектур, разделённый запятыми, которые необходимо синхронизировать из deb-архива

доступно только для content_type=deb

deb_components

string

Список компонентов репозитория, разделённый запятыми, которые необходимо синхронизировать из deb-архива

доступно только для content_type=deb

deb_errata_url

string

URL для синхронизации информации об ошибках Debian или Ubuntu

доступно только в Orcharhino

доступно только для content_type=deb

deb_releases

string

Список релизов, разделённый запятыми, которые необходимо синхронизировать из deb-архива

доступно только для content_type=deb

description

string

Описание репозитория

docker_tags_whitelist

list / elements=string

Список тегов для синхронизации репозитория образов контейнеров

доступно только для content_type=docker

Устарело начиная с Katello 4.4

docker_upstream_name

string

Имя основного репозитория docker

доступно только для content_type=docker

download_concurrency

integer

добавлено в theforeman.foreman 3.0.0

Параллелизм загрузки для синхронизации с основным репозиторием

поскольку API не возвращает это значение, это нарушит идемпотентность для этого модуля

download_policy

string

Политика загрузки для синхронизации с основным репозиторием.

Политика загрузки background устарела и недоступна начиная с Katello 4.3.

Варианты:

  • "background"
  • "immediate"
  • "on_demand"

exclude_tags

list / elements=string

добавлено в theforeman.foreman 3.7.0

Список тегов для исключения при синхронизации репозитория образов контейнеров.

gpg_key

string

GPG ключ репозитория

http_proxy

string

Имя прокси-сервера HTTP для использования при синхронизации контента

Должно быть объединено с http_proxy_policy=’use_selected_http_proxy’

http_proxy_policy

string

Какой прокси-сервер использовать для синхронизации контента

Варианты:

  • "global_default_http_proxy"
  • "none"
  • "use_selected_http_proxy"

ignorable_content

list / elements=string

Список единиц контента для игнорирования при синхронизации репозитория yum.

Должно быть подмножеством rpm,drpm,srpm,distribution,erratum.

ignore_global_proxy

boolean

Использовать или игнорировать глобальную настройку прокси-сервера HTTP при синхронизации контента

Устарело в Katello 3.13

Заменено на http_proxy_policy

Варианты:

  • false
  • true

include_tags

list / elements=string

добавлено в theforeman.foreman 3.7.0

Список тегов для синхронизации репозитория образов контейнеров.

label

string

Метка репозитория

mirror_on_sync

boolean

Включает/выключает «зеркалирование при синхронизации», где состояние репозитория отражает состояние репозитория upstream во время синхронизации

Устарело начиная с Katello 4.3

Заменено на mirroring_policy=mirror_content_only

Choices:

  • false
  • true

mirroring_policy

string

Политика для зеркалирования контента

Поддерживается начиная с Katello 4.3

Choices:

  • "additive"
  • "mirror_content_only"
  • "mirror_complete"

name

string / required

Имя репозитория

organization

string / required

Организация, к которой принадлежит сущность

os_versions

list / elements=string

Определяет, следует ли отключить репозиторий на клиенте с несоответствующей версией ОС.

Можно выбрать максимум одну версию ОС.

Установите значение [] для отключения фильтрации.

Choices:

  • "rhel-6"
  • "rhel-7"
  • "rhel-8"
  • "rhel-9"

password

string / required

Пароль пользователя, обращающегося к серверу Foreman.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения FOREMAN_PASSWORD.

product

string / required

Продукт, в котором находится репозиторий

server_url

string / required

URL сервера Foreman.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения FOREMAN_SERVER_URL.

ssl_ca_cert

string

Сертификат SSL CA репозитория

ssl_client_cert

string

Клиентский сертификат SSL репозитория

ssl_client_key

string

Закрытый ключ клиента SSL репозитория

state

string

Состояние сущности

present_with_defaults гарантирует существование сущности, но не обновляет существующие

Choices:

  • "present" ← (default)
  • "present_with_defaults"
  • "absent"

unprotected

boolean

Опубликовать репозиторий через HTTP

Choices:

  • false
  • true

upstream_password

string

Пароль для доступа к репозиторию upstream.

Когда этот параметр установлен, модуль не будет идемпотентным.

upstream_username

string

Имя пользователя для доступа к репозиторию upstream

url

string

URL репозитория для синхронизации

username

string / required

Имя пользователя, обращающегося к серверу Foreman.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения FOREMAN_USERNAME.

validate_certs

boolean

Проверять ли сертификаты TLS сервера Foreman.

Если значение не указано в задаче, вместо него будет использовано значение переменной окружения FOREMAN_VALIDATE_CERTS.

Choices:

  • false
  • true ← (default)

verify_ssl_on_sync

boolean

Проверить, подписаны ли сертификаты upstream доверенным центром сертификации

Choices:

  • false
  • true

Атрибуты

Атрибут

Поддержка

Описание

check_mode

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

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

diff_mode

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

Вернёт подробности о том, что изменилось (или, возможно, нужно изменить в режиме check_mode) при использовании diff-режима

Примечания

Примечание

  • Вы можете настроить определённые аспекты существующих репозиториев Red Hat (например, download_policy) с помощью этого модуля, но вы не можете создавать (включать) или удалять (отключать) их.
  • Если вам нужно включить или отключить репозитории Red Hat, доступные по вашей подписке, используйте модуль theforeman.foreman.repository_set вместо этого.

Примеры

- name: "Create repository"
  theforeman.foreman.repository:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "My repository"
    state: present
    content_type: "yum"
    product: "My Product"
    organization: "Default Organization"
    url: "http://yum.theforeman.org/plugins/latest/el7/x86_64/"
    mirror_on_sync: true
    download_policy: immediate

- name: "Create repository with content credentials"
  theforeman.foreman.repository:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "My repository 2"
    state: present
    content_type: "yum"
    product: "My Product"
    organization: "Default Organization"
    url: "http://yum.theforeman.org/releases/latest/el7/x86_64/"
    download_policy: on_demand
    mirror_on_sync: true
    gpg_key: RPM-GPG-KEY-my-product2

Значения возврата

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

Ключ

Описание

entity

словарь

Конечное состояние затронутых сущностей, сгруппированных по их типу.

Возвращаемое значение: успех

repositories

список / элементы=словарь

Список репозиториев.

Возвращаемое значение: успех

Авторы

  • Эрик Д. Хелмс (@ehelms)

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

  • Система отслеживания проблем
  • Главная страница
  • Репозиторий (источники)

© 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/theforeman/foreman/repository_module.html

Spec-Zone.ru

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