katello – Управление ресурсами Katello
Новая версия 2.3.
Обзор
- Позволяет управлять ресурсами 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 timout
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 paralell.
# When a conflicting action is already running,
# the task will fail instantly instead of waiting for the already running action to complete.
# So you sould 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
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.7/modules/katello_module.html