Spec-Zone.ru › Ansible

Модуль 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.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды FOREMAN_PASSWORD.

provider

строка

Поставщик вычислительных ресурсов. Требуется, если state=present_with_defaults.

Варианты:

  • "vmware"
  • "libvirt"
  • "ovirt"
  • "proxmox"
  • "EC2"
  • "AzureRm"
  • "GCE"
  • "Openstack"

provider_params

словарь

Параметр, специфичный для поставщика вычислительных ресурсов. Требуется, если state=present_with_defaults.

app_ident

строка

Идентификатор клиента AzureRM

caching_enabled

логическое

Включить кэширование для provider=vmware

Варианты:

  • false
  • true

cloud

строка

добавлено в theforeman.foreman 2.1.0

облако для provider=AzureRm

Варианты:

  • "azure"
  • "azureusgovernment"
  • "azurechina"
  • "azuregermancloud"

datacenter

строка

Центр обработки данных, в котором находится вычислительный ресурс, недействителен для provider=libvirt

display_type

строка

Тип отображения, используемый для удаленной консоли, действителен только для provider=libvirt

domain

строка

Домен авторизации для пользователей, действителен только для provider=Openstack

email

строка

Электронная почта для provider=GCE

key_path

строка

Путь к сертификату для provider=GCE

keyboard_layout

строка

добавлено в theforeman.foreman 2.0.0

По умолчанию раскладка клавиатуры VNC для provider=ovirt

Варианты:

  • "ar"
  • "da"
  • "de"
  • "de-ch"
  • "en-gb"
  • "en-us"
  • "es"
  • "et"
  • "fi"
  • "fo"
  • "fr"
  • "fr-be"
  • "fr-ca"
  • "fr-ch"
  • "hr"
  • "hu"
  • "is"
  • "it"
  • "ja"
  • "lt"
  • "lv"
  • "mk"
  • "nl"
  • "nl-be"
  • "no"
  • "pl"
  • "pt"
  • "pt-br"
  • "ru"
  • "sl"
  • "sv"
  • "th"
  • "tr"

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

Варианты:

  • false
  • true

ssl_verify_peer

логическое

Проверить ssl от поставщика provider=proxmox

Варианты:

  • false
  • true

sub_id

строка

добавлено в theforeman.foreman 2.1.0

Идентификатор подписки для provider=AzureRm

tenant

строка

AzureRM арендатор, имя проекта Openstack

url

строка

URL вычислительного ресурса

use_v4

логическое

Использовать oVirt API v4, только для provider=ovirt

Варианты:

  • false
  • true

user

строка

Имя пользователя для подключения к вычислительному ресурсу, недействительно для provider=libvirt

zone

строка

зона для provider=GCE

server_url

строка / обязательно

URL сервера Foreman.

Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_SERVER_URL.

state

строка

Состояние сущности

present_with_defaults гарантирует существование сущности, но не будет обновлять существующие

Варианты:

  • "present" ← (по умолчанию)
  • "present_with_defaults"
  • "absent"

updated_name

строка

новое имя вычислительного ресурса

username

строка / обязательно

Имя пользователя, доступного к серверу Foreman.

Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_USERNAME.

validate_certs

логическое

Подтверждать ли сертификаты TLS сервера Foreman.

Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

Атрибуты

Атрибут

Поддержка

Описание

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

список / элементы=словарь

Список вычислительных ресурсов.

Возвращено: успех

Авторы

  • Philipp Joos (@philippj)
  • Baptiste Agasse (@bagasse)
  • Manisha Singhal (@Manisha15) ATIX AG
  • Mark Hlawatschek (@hlawatschek) ATIX AG

Ссылки на сборку

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходные коды)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API