community.general.sl_vm – создание или отмена виртуальной машины в SoftLayer
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.sl_vm.
Обзор
- Создаёт или отменяет виртуальные машины SoftLayer.
- При создании, необязательно, ожидает, что она будет в статусе «работает».
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- softlayer >= 4.1.1
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cpus целое число |
| Количество ядер CPU для новой виртуальной машины. |
| datacenter строка |
| Центр обработки данных для развертывания виртуальной машины. |
| dedicated логическое значение |
| Флаг, определяющий, должна ли виртуальная машина быть развернута в выделенном пространстве. |
| disks список / элементы=строка | Значение по умолчанию: [25] | Список размеров дисков, которые нужно назначить новой виртуальной машине. |
| domain строка | Имя домена, которое нужно предоставить виртуальной машине. | |
| flavor строка добавлено в 0.2.0 community.general | Укажите шаблон шаблона SoftLayer для использования вместо cpus и памяти. | |
| hostname строка | Имя хоста, которое нужно предоставить виртуальной машине. | |
| hourly логическое значение |
| Флаг, определяющий, должна ли виртуальная машина рассчитываться почасово. |
| image_id строка | Шаблон образа для использования с новой виртуальной машиной. | |
| instance_id строка | Идентификатор виртуальной машины для выполнения действия. | |
| local_disk логическое значение |
| Флаг, определяющий, нужно ли использовать локальный диск для новой виртуальной машины. |
| memory целое число |
| Объём оперативной памяти для новой виртуальной машины. |
| nic_speed целое число |
| Скорость сетевого интерфейса для новой виртуальной машины. |
| os_code строка | Код операционной системы для новой виртуальной машины. | |
| post_uri строка | URL скрипта после развертывания, который будет загружен и выполнен на виртуальной машине. | |
| private логическое значение |
| Флаг, определяющий, должна ли виртуальная машина быть доступной только в частной сети. |
| private_vlan строка | VLAN по её ID, которая должна быть назначена частному сетевому интерфейсу. | |
| public_vlan строка | VLAN по её ID, которая должна быть назначена общедоступному сетевому интерфейсу. | |
| ssh_keys список / элементы=строка | Список SSH ключей по их ID, которые нужно назначить виртуальной машине. | |
| state строка |
| Создать или отменить виртуальную машину. Укажите present для создания, absent для отмены. |
| tags строка | Тег или список тегов, которые нужно предоставить виртуальной машине. | |
| wait логическое значение |
| Флаг, используемый для ожидания активного состояния перед возвратом. |
| wait_time целое число | Значение по умолчанию: 600 | Время в секундах, которое ожидает функция wait перед возвратом. |
Примеры
- name: Build instance
hosts: localhost
gather_facts: no
tasks:
- name: Build instance request
community.general.sl_vm:
hostname: instance-1
domain: anydomain.com
datacenter: dal09
tags: ansible-module-test
hourly: yes
private: no
dedicated: no
local_disk: yes
cpus: 1
memory: 1024
disks: [25]
os_code: UBUNTU_LATEST
wait: no
- name: Build additional instances
hosts: localhost
gather_facts: no
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-slaves
hourly: yes
private: no
dedicated: no
local_disk: yes
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-slaves
hourly: yes
private: no
dedicated: no
local_disk: yes
cpus: 1
memory: 1024
disks:
- 25
- 100
os_code: UBUNTU_LATEST
ssh_keys: []
wait: yes
- name: Cancel instances
hosts: localhost
gather_facts: no
tasks:
- name: Cancel by tag
community.general.sl_vm:
state: absent
tags: ansible-module-test
Авторы
- Matt Colton (@mcltn)
© 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/community/general/sl_vm_module.html