community.general.sl_vm модуль — Создание или отмена виртуальной машины в SoftLayer

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.

Для использования в книге задач укажите: community.general.sl_vm.

Описание
Требования
Параметры
Атрибуты
Примеры

Описание

Создаёт или отменяет виртуальные машины SoftLayer.
При создании можно дождаться её перехода в состояние «запущенная».

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

softlayer >= 4.1.1

Параметры

Параметр	Комментарии
cpus integer	Количество процессоров, которые будут назначены новому виртуальному экземпляру. Варианты: `1` `2` `4` `8` `16` `32` `56`
datacenter string	Центр обработки данных для развертывания виртуального экземпляра. Варианты: `"ams01"` `"ams03"` `"che01"` `"dal01"` `"dal05"` `"dal06"` `"dal09"` `"dal10"` `"dal12"` `"dal13"` `"fra02"` `"fra04"` `"fra05"` `"hkg02"` `"hou02"` `"lon02"` `"lon04"` `"lon06"` `"mel01"` `"mex01"` `"mil01"` `"mon01"` `"osl01"` `"par01"` `"sao01"` `"sea01"` `"seo01"` `"sjc01"` `"sjc03"` `"sjc04"` `"sng01"` `"syd01"` `"syd04"` `"tok02"` `"tor01"` `"wdc01"` `"wdc04"` `"wdc06"` `"wdc07"`
dedicated boolean	Флаг, определяющий, следует ли развертывать экземпляр в выделенном пространстве. Варианты: `false` ← (default) `true`
disks list / elements=integer	Список размеров дисков, которые будут назначены новому виртуальному экземпляру. По умолчанию: `[25]`
domain string	Доменное имя, которое будет предоставлено виртуальному экземпляру.
flavor string added in community.general 0.2.0	Укажите, какой шаблон SoftLayer flavor использовать вместо cpus и memory.
hostname string	Имя хоста, которое будет предоставлено виртуальному экземпляру.
hourly boolean	Флаг, определяющий, должен ли экземпляр оплачиваться почасово. Варианты: `false` `true` ← (default)
image_id string	Шаблон образа, который будет использоваться для нового виртуального экземпляра.
instance_id string	Идентификатор экземпляра виртуального экземпляра для выполнения операции.
local_disk boolean	Флаг, определяющий, следует ли использовать локальный диск для нового экземпляра. Варианты: `false` `true` ← (default)
memory integer	Объем памяти, который будет назначен новому виртуальному экземпляру. Варианты: `1024` `2048` `4096` `6144` `8192` `12288` `16384` `32768` `49152` `65536` `131072` `247808`
nic_speed integer	Скорость сетевой интерфейсной карты, которая будет назначена новому виртуальному экземпляру. Варианты: `10` `100` `1000`
os_code string	Код ОС, который будет использоваться для нового виртуального экземпляра.
post_uri string	URL-адрес скрипта пост-подготовки, который будет загружен и выполнен на виртуальном экземпляре.
private boolean	Флаг, определяющий, должен ли экземпляр быть только частным. Варианты: `false` ← (default) `true`
private_vlan string	VLAN по его идентификатору, который будет назначен частному NIC.
public_vlan string	VLAN по его идентификатору, который будет назначен общедоступному NIC.

ssh_keys список / элементы=строка	Список идентификаторов ключей ssh, которые нужно назначить виртуальной машине. По умолчанию: `[]`
state строка	Создание или отмена виртуальной машины. Укажите `present` для создания, `absent` для отмены. Значения: `"absent"` `"present"` ← (по умолчанию)
tags строка	Тег или список тегов для виртуальной машины.
wait булево	Флаг, используемый для ожидания активного статуса перед возвратом. Значения: `false` `true` ← (по умолчанию)
wait_time целое число	Время в секундах, которое ожидает возврат wait. По умолчанию: `600`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может работать в режиме `check_mode` и возвращать прогноз статуса изменений без модификации целевого объекта.
diff_mode	Поддержка: нет	Возвращает подробности о том, что изменилось (или, возможно, нуждается в изменении в `check_mode`) в режиме diff.

Примеры

- name: Build instance
  hosts: localhost
  gather_facts: false
  tasks:
  - name: Build instance request
    community.general.sl_vm:
      hostname: instance-1
      domain: anydomain.com
      datacenter: dal09
      tags: ansible-module-test
      hourly: true
      private: false
      dedicated: false
      local_disk: true
      cpus: 1
      memory: 1024
      disks: [25]
      os_code: UBUNTU_LATEST
      wait: false

- name: Build additional instances
  hosts: localhost
  gather_facts: false
  tasks:
  - name: Build instances request
    community.general.sl_vm:
      hostname: "{{ item.hostname }}"
      domain: "{{ item.domain }}"
      datacenter: "{{ item.datacenter }}"
      tags: "{{ item.tags }}"
      hourly: "{{ item.hourly }}"
      private: "{{ item.private }}"
      dedicated: "{{ item.dedicated }}"
      local_disk: "{{ item.local_disk }}"
      cpus: "{{ item.cpus }}"
      memory: "{{ item.memory }}"
      disks: "{{ item.disks }}"
      os_code: "{{ item.os_code }}"
      ssh_keys: "{{ item.ssh_keys }}"
      wait: "{{ item.wait }}"
    with_items:
      - hostname: instance-2
        domain: anydomain.com
        datacenter: dal09
        tags:
          - ansible-module-test
          - ansible-module-test-replicas
        hourly: true
        private: false
        dedicated: false
        local_disk: true
        cpus: 1
        memory: 1024
        disks:
          - 25
          - 100
        os_code: UBUNTU_LATEST
        ssh_keys: []
        wait: true
      - hostname: instance-3
        domain: anydomain.com
        datacenter: dal09
        tags:
          - ansible-module-test
          - ansible-module-test-replicas
        hourly: true
        private: false
        dedicated: false
        local_disk: true
        cpus: 1
        memory: 1024
        disks:
          - 25
          - 100
        os_code: UBUNTU_LATEST
        ssh_keys: []
        wait: true

- name: Cancel instances
  hosts: localhost
  gather_facts: false
  tasks:
  - name: Cancel by tag
    community.general.sl_vm:
      state: absent
      tags: ansible-module-test

Авторы

Matt Colton (@mcltn)

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

© 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/community/general/sl_vm_module.html