Модуль theforeman.foreman.compute_resource — Управление ресурсами вычислений
Примечание
Этот модуль входит в коллекцию theforeman.foreman (версия 4.2.0).
Вы, возможно, уже установили эту коллекцию, если используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install theforeman.foreman. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Для использования в плейбуке укажите: theforeman.foreman.compute_resource.
Новая версия в theforeman.foreman 1.0.0
Описание
- Создание, обновление и удаление ресурсов вычислений
Псевдонимы: foreman_compute_resource
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- requests
Параметры
Параметр | Комментарии |
|---|---|
description строка | описание вычислительного ресурса |
locations список / элементы=строка | Список расположений, к которым должна быть назначена сущность |
name строка / обязательно | имя вычислительного ресурса |
organizations список / элементы=строка | Список организаций, которым должна быть назначена сущность |
password строка / обязательно | Пароль пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
provider строка | Поставщик вычислительных ресурсов. Требуется, если state=present_with_defaults. Варианты:
|
provider_params словарь | Параметр, специфичный для поставщика вычислительных ресурсов. Требуется, если state=present_with_defaults. |
|
app_ident строка |
Идентификатор клиента AzureRM |
|
caching_enabled логическое |
Включить кэширование для provider=vmware Варианты:
|
|
cloud строка добавлено в theforeman.foreman 2.1.0 |
облако для provider=AzureRm Варианты:
|
|
datacenter строка |
Центр обработки данных, в котором находится вычислительный ресурс, недействителен для provider=libvirt |
|
display_type строка |
Тип отображения, используемый для удаленной консоли, действителен только для provider=libvirt |
|
domain строка |
Домен авторизации для пользователей, действителен только для provider=Openstack |
|
строка |
Электронная почта для provider=GCE |
|
key_path строка |
Путь к сертификату для provider=GCE |
|
keyboard_layout строка добавлено в theforeman.foreman 2.0.0 |
По умолчанию раскладка клавиатуры VNC для provider=ovirt Варианты:
|
|
ovirt_quota строка |
Идентификатор квоты oVirt, действителен только для provider=ovirt |
|
password строка |
Пароль для подключения к вычислительному ресурсу, недействителен для provider=libvirt |
|
project строка |
Идентификатор проекта для provider=GCE |
|
project_domain_id строка |
Идентификатор домена проекта, действителен только для provider=Openstack |
|
project_domain_name строка |
Имя домена проекта, действителен только для provider=Openstack |
|
public_key строка добавлено в theforeman.foreman 2.0.0 |
Удостоверяющие центры X509, только для provider=ovirt |
|
region строка |
AWS регион, AZURE регион |
|
set_console_password логическое добавлено в theforeman.foreman 2.0.0 |
Установить случайным образом сгенерированный пароль для подключения к дисплею для provider=vmware и provider=libvirt Варианты:
|
|
ssl_verify_peer логическое |
Проверить ssl от поставщика provider=proxmox Варианты:
|
|
sub_id строка добавлено в theforeman.foreman 2.1.0 |
Идентификатор подписки для provider=AzureRm |
|
tenant строка |
AzureRM арендатор, имя проекта Openstack |
|
url строка |
URL вычислительного ресурса |
|
use_v4 логическое |
Использовать oVirt API v4, только для provider=ovirt Варианты:
|
|
user строка |
Имя пользователя для подключения к вычислительному ресурсу, недействительно для provider=libvirt |
|
zone строка |
зона для provider=GCE |
server_url строка / обязательно | URL сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды |
state строка | Состояние сущности
Варианты:
|
updated_name строка | новое имя вычислительного ресурса |
username строка / обязательно | Имя пользователя, доступного к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды |
validate_certs логическое | Подтверждать ли сертификаты TLS сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная | Может работать в режиме check_mode и возвращать прогноз о состоянии изменения без изменения сущности |
diff_mode | Поддержка: полная | Возвращает детали о том, что изменилось (или, возможно, требует изменения в режиме check_mode), при использовании режима diff |
Примеры
- name: Create libvirt compute resource
theforeman.foreman.compute_resource:
name: example_compute_resource
locations:
- Munich
organizations:
- ACME
provider: libvirt
provider_params:
url: qemu+ssh://root@libvirt.example.com/system
display_type: spice
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: qemu+ssh://root@libvirt.example.com/system
display_type: spice
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:
sub_id: 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
- name: create Openstack compute resource
theforeman.foreman.compute_resource:
name: Openstack compute resource
description: Openstack
locations:
- DC1
organizations:
- ACME
provider: Openstack
provider_params:
url: "https://Openstack.example.com:5000/v3"
user: admin
password: secret
tenant: "MyProject"
domain: "example.com"
project_domain_name: "example.com"
project_domain_id: "0123456789a0123456789b0123456789"
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
Значения возврата
Общие значения возврата документированы здесь, следующие являются полями, уникальными для этого модуля:
Ключ | Описание |
|---|---|
entity словарь | Конечное состояние затронутых сущностей, сгруппированных по их типу. Возвращено: успех |
|
compute_resources список / элементы=словарь |
Список вычислительных ресурсов. Возвращено: успех |
Ссылки на сборку
© 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/compute_resource_module.html