katello – Управление ресурсами Katello
Новое в версии 2.3.
УСТЕРЕКШЕЕ
| Удалено в Ansible: | |
|---|---|
| версия: 2.12 | |
| Почему: | Заменено переработанными отдельными модулями, расположенными по адресу https://github.com/theforeman/foreman-ansible-modules |
| Альтернатива: | 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 - добавлено в 2.7 | Значение по умолчанию: 1000 | Время ожидания в секундах для завершения начатого действия Foreman. Если время ожидания истечёт, а действие Foreman не будет завершено, задача ansible завершится с ошибкой. Однако действие foreman не отменяется. |
| username - / обязательно | Имя пользователя на сервере Foreman. | |
| verify_ssl boolean |
| проверка подключения ssl/https (например, для проверки действительного сертификата) |
Примеры
---
# Simple Example:
- name: Create Product
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 }}"
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
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.12. [устаревший]
- Для получения дополнительной информации см. УСТЕРЕКШЕЕ.
Авторы
- 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.8/modules/katello_module.html