theforeman.foreman.compute_resource – Управление ресурсами вычислений
Примечание
Этот плагин входит в коллекцию theforeman.foreman (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в книге задач укажите: theforeman.foreman.compute_resource.
В версии 1.0.0: theforeman.foreman
Обзор
- Создание, обновление и удаление ресурсов вычислений
Требования
Ниже приведенные требования необходимы на хосте, на котором выполняется этот модуль.
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка | Описание ресурса вычислений | ||
| locations список / элементы=строка | Список местоположений, которым должна быть назначена сущность | ||
| name строка / обязательно | Имя ресурса вычислений | ||
| organizations список / элементы=строка | Список организаций, которым должна быть назначена сущность | ||
| password строка / обязательно | Пароль пользователя, который получает доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_PASSWORD. | ||
| provider строка |
| Поставщик ресурсов вычислений. Требуется, если state=present_with_defaults. | |
| provider_params словарь | Параметры, специфичные для поставщика ресурсов вычислений. Требуется, если state=present_with_defaults. | ||
| app_ident строка | Идентификатор клиента AzureRM | ||
| caching_enabled булево |
| Включить кэширование для provider=vmware
| |
| datacenter строка | Центр обработки данных, в котором находится ресурс вычислений, недопустим для provider=libvirt
| ||
| display_type строка | Тип отображения для использования удаленного консоли, допустимо только для provider=libvirt
| ||
| email строка | Электронная почта для provider=GCE
| ||
| key_path строка | Путь к сертификату для provider=GCE
| ||
| ovirt_quota строка | Идентификатор квоты oVirt, допустимо только для provider=ovirt
| ||
| password строка | Пароль для подключения к ресурсу вычислений, недопустимо для provider=libvirt
| ||
| project строка | Идентификатор проекта для provider=GCE
| ||
| region строка | Регион AWS, регион AZURE | ||
| ssl_verify_peer булево |
| Проверять SSL-сертификаты поставщика provider=proxmox
| |
| tenant строка | Абонент AzureRM | ||
| url строка | URL ресурса вычислений | ||
| use_v4 булево |
| Использовать API oVirt v4, допустимо только для provider=ovirt
| |
| user строка | Имя пользователя для подключения к ресурсу вычислений, недопустимо для provider=libvirt
| ||
| zone строка | зона для provider=GCE
| ||
| server_url строка / обязательно | URL сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_SERVER_URL. | ||
| state строка |
| Состояние сущности present_with_defaults гарантирует существование сущности, но не будет обновлять существующие | |
| updated_name строка | Новое имя ресурса вычислений | ||
| username строка / обязательно | Имя пользователя, получающий доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_USERNAME. | ||
| validate_certs булево |
| Нужно ли проверять TLS-сертификаты сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_VALIDATE_CERTS. | |
Примеры
- name: Create livirt compute resource
theforeman.foreman.compute_resource:
name: example_compute_resource
locations:
- Munich
organizations:
- ACME
provider: libvirt
provider_params:
url: libvirt.example.com
display_type: vnc
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
- name: Update libvirt compute resource
theforeman.foreman.compute_resource:
name: example_compute_resource
description: updated compute resource
locations:
- Munich
organizations:
- ACME
provider: libvirt
provider_params:
url: libvirt.example.com
display_type: vnc
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
- name: Delete libvirt compute resource
theforeman.foreman.compute_resource:
name: example_compute_resource
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: absent
- name: Create vmware compute resource
theforeman.foreman.compute_resource:
name: example_compute_resource
locations:
- Munich
organizations:
- ACME
provider: vmware
provider_params:
caching_enabled: false
url: vsphere.example.com
user: admin
password: secret
datacenter: ax01
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
- name: Create ovirt compute resource
theforeman.foreman.compute_resource:
name: ovirt_compute_resource
locations:
- France/Toulouse
organizations:
- Example Org
provider: ovirt
provider_params:
url: ovirt.example.com
user: ovirt-admin@example.com
password: ovirtsecret
datacenter: aa92fb54-0736-4066-8fa8-b8b9e3bd75ac
ovirt_quota: 24868ab9-c2a1-47c3-87e7-706f17d215ac
use_v4: true
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
- name: Create proxmox compute resource
theforeman.foreman.compute_resource:
name: proxmox_compute_resource
locations:
- Munich
organizations:
- ACME
provider: proxmox
provider_params:
url: https://proxmox.example.com:8006/api2/json
user: root@pam
password: secretpassword
ssl_verify_peer: true
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
- name: create EC2 compute resource
theforeman.foreman.compute_resource:
name: EC2_compute_resource
description: EC2
locations:
- AWS
organizations:
- ACME
provider: EC2
provider_params:
user: AWS_ACCESS_KEY
password: AWS_SECRET_KEY
region: eu-west-1
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
- name: create Azure compute resource
theforeman.foreman.compute_resource:
name: AzureRm_compute_resource
description: AzureRm
locations:
- Azure
organizations:
- ACME
provider: AzureRm
provider_params:
user: SUBSCRIPTION_ID
tenant: TENANT_ID
app_ident: CLIENT_ID
password: CLIENT_SECRET
region: westeurope
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
- name: create GCE compute resource
theforeman.foreman.compute_resource:
name: GCE compute resource
description: Google Cloud Engine
locations:
- GCE
organizations:
- ACME
provider: GCE
provider_params:
project: orcharhino
email: myname@atix.de
key_path: "/usr/share/foreman/gce_orcharhino_key.json"
zone: europe-west3-b
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| entity словарь | успех | Конечное состояние затронутых сущностей, сгруппированных по их типу. | |
| compute_resources список / элементы=словарь | успех | Список ресурсов вычислений. | |
Авторы
- Philipp Joos (@philippj)
- Baptiste Agasse (@bagasse)
- Manisha Singhal (@Manisha15) ATIX AG
- Mark Hlawatschek (@hlawatschek) ATIX AG
© 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/theforeman/foreman/compute_resource_module.html