community.general.katello – Управление ресурсами Katello
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.katello.
УСТАРЕЛО
- Удалено в
-
версии 2.0.0
- Почему
-
Заменено переработанными отдельными модулями по адресу https://github.com/theforeman/foreman-ansible-modules
- Альтернатива
Обзор
- Позволяет управлять ресурсами Katello внутри сервера Foreman.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- nailgun >= 0.28.0
- python >= 2.6
- datetime
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| action строка |
| действие, связанное с ресурсом сущности для установки или редактирования в формате словаря. Возможные действия в отношении сущностей. sync (доступно, когда entity=product или entity=repository) publish (доступно, когда entity=content_view) promote (доступно, когда entity=content_view) |
| entity строка / обязательно |
| Ресурс Foreman, для которого будет выполнено действие (например, организация, хост). |
| params строка / обязательно | Параметры, связанные с ресурсом сущности и действием, для установки или редактирования в формате словаря. Каждый вариант может быть доступен только со специфическими сущностями и действиями. Возможные варианты в формате param_name ([entry,action,action,...],[entity,..],...). Действие "None" означает, что действие не указано. Возможные параметры в зависимости от сущности и действия. name ([product,sync,None], [repository,sync], [repository_set,None], [sync_plan,None], [content_view,promote,publish,None], [lifecycle_environment,None], [activation_key,None]) organization ([product,sync,None] ,[repository,sync,None], [repository_set,None], [sync_plan,None], [content_view,promote,publish,None], [lifecycle_environment,None], [activation_key,None]) content ([manifest,None]) product ([repository,sync,None], [repository_set,None], [sync_plan,None]) basearch ([repository_set,None]) releaserver ([repository_set,None]) sync_date ([sync_plan,None]) interval ([sync_plan,None]) repositories ([content_view,None]) from_environment ([content_view,promote]) to_environment([content_view,promote]) prior ([lifecycle_environment,None]) content_view ([activation_key,None]) lifecycle_environment ([activation_key,None]) | |
| password строка / обязательно | Пароль для пользователя, имеющего доступ к серверу Foreman. | |
| server_url строка / обязательно | URL сервера Foreman. | |
| task_timeout строка | По умолчанию: 1000 | Таймаут в секундах ожидания завершения начатого действия Foreman. Если таймаут истечет, а действие Foreman не завершится, задача Ansible завершается с ошибкой. При этом действие Foreman не отменяется. |
| username строка / обязательно | Имя пользователя на сервере Foreman. | |
| verify_ssl логическое |
| проверить соединение ssl/https (например, для валидного сертификата) |
Примеры
---
# Simple Example:
- name: Create Product
community.general.katello:
username: admin
password: admin
server_url: https://fakeserver.com
entity: product
params:
name: Centos 7
delegate_to: localhost
# Abstraction Example:
# katello.yml
---
- name: "{{ name }}"
community.general.katello:
username: admin
password: admin
server_url: https://fakeserver.com
entity: "{{ entity }}"
params: "{{ params }}"
delegate_to: localhost
# tasks.yml
---
- include: katello.yml
vars:
name: Create Dev Environment
entity: lifecycle_environment
params:
name: Dev
prior: Library
organization: Default Organization
- include: katello.yml
vars:
name: Create Centos Product
entity: product
params:
name: Centos 7
organization: Default Organization
- include: katello.yml
vars:
name: Create 7.2 Repository
entity: repository
params:
name: Centos 7.2
product: Centos 7
organization: Default Organization
content_type: yum
url: http://mirror.centos.org/centos/7/os/x86_64/
- include: katello.yml
vars:
name: Create Centos 7 View
entity: content_view
params:
name: Centos 7 View
organization: Default Organization
repositories:
- name: Centos 7.2
product: Centos 7
- include: katello.yml
vars:
name: Enable RHEL Product
entity: repository_set
params:
name: Red Hat Enterprise Linux 7 Server (RPMs)
product: Red Hat Enterprise Linux Server
organization: Default Organization
basearch: x86_64
releasever: 7
- include: katello.yml
vars:
name: Promote Contentview Environment with longer timeout
task_timeout: 10800
entity: content_view
action: promote
params:
name: MyContentView
organization: MyOrganisation
from_environment: Testing
to_environment: Production
# Best Practices
# In Foreman, things can be done in parallel.
# When a conflicting action is already running,
# the task will fail instantly instead of waiting for the already running action to complete.
# So you should use a "until success" loop to catch this.
- name: Promote Contentview Environment with increased Timeout
community.general.katello:
username: ansibleuser
password: supersecret
task_timeout: 10800
entity: content_view
action: promote
params:
name: MyContentView
organization: MyOrganisation
from_environment: Testing
to_environment: Production
register: task_result
until: task_result is success
retries: 9
delay: 120
Статус
- Этот модуль будет удален в версии 2.0.0. [устарел]
- Для получения дополнительной информации см. УСТАРЕЛО.
Авторы
- Eric D Helms (@ehelms)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/katello_module.html