community.general.linode – Управление экземплярами на Linode Public Cloud
Примечание
Этот плагин является частью коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general
Для использования в плейбуке, укажите: community.general.linode
Краткое описание
- Управление экземплярами Linode Public Cloud и, по желанию, ожидание перехода в состояние «запущен».
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- linode-python
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| additional_disks список / элементы=строка | Список словарей для создания дополнительных дисков, которые добавляются к настройкам конфигурации Linode. Словарь принимает Size, Label, Type. Размер указывается в МБ. | |
| alert_bwin_enabled логическое |
| Установить состояние оповещений по входящему трафику. |
| alert_bwin_threshold целое число | Установить порог в МБ для оповещений по входящему трафику. | |
| alert_bwout_enabled логическое |
| Установить состояние оповещений по исходящему трафику. |
| alert_bwout_threshold целое число | Установить порог в МБ для оповещений по исходящему трафику. | |
| alert_bwquota_enabled логическое |
| Установить состояние оповещений о превышении квоты трафика в процентах от установленной квоты. |
| alert_bwquota_threshold целое число | Установить порог в МБ для оповещений о превышении квоты трафика. | |
| alert_cpu_enabled логическое |
| Установить состояние оповещений о загруженности ЦП. |
| alert_cpu_threshold целое число | Установить процентный порог для оповещений о загруженности ЦП. Каждый процессорный ядро добавляет 100% к общему значению. | |
| alert_diskio_enabled логическое |
| Установить состояние оповещений о работе диска. |
| alert_diskio_threshold целое число | Установить порог для среднего значения операций ввода-вывода в секунду за 2-часовой период. | |
| api_key строка | Ключ API Linode | |
| backupweeklyday целое число | Целое число, обозначающее день недели для хранения еженедельных резервных копий. | |
| datacenter целое число | ЦОД для создания экземпляра (ЦОД Linode). | |
| displaygroup строка | Добавить экземпляр в группу отображения в Linode Manager. | |
| distribution целое число | Дистрибутив для использования в экземпляре (Дистрибутив Linode). | |
| kernel_id целое число | Ядро для использования в экземпляре (Ядро Linode). | |
| linode_id целое число | Уникальный идентификатор сервера Linode. Это значение является только для чтения, в том смысле, что если вы его указываете при создании Linode, оно не будет использоваться. API Linode генерирует эти идентификаторы, и мы можем использовать эти сгенерированные значения здесь, чтобы более точно сослаться на Linode. Это полезно для идемпотентности. псевдонимы: lid | |
| name строка / обязательно | Имя экземпляра (буквенно-цифровое, дефисы, подчеркивания). Для сохранения целостности веб-консоли Linode, имя предваряется LinodeID-. | |
| password строка | Пароль root для нового сервера (автоматически генерируется, если отсутствует). | |
| payment_term целое число |
1 | Срок оплаты для использования в экземпляре (срок оплаты в месяцах). |
| plan целое число | План для использования в экземпляре (план Linode). | |
| private_ip логическое |
| Добавить частный IPv4-адрес при создании Linode. Значение по умолчанию false. |
| ssh_pub_key строка | Открытый ключ SSH, применяемый к пользователю root. | |
| state строка |
| Указывает желаемое состояние ресурса. |
| swap целое число | Значение по умолчанию: 512 | Размер подкачки в МБ. |
| wait логическое |
| Дождаться, пока экземпляр перейдет в состояние running перед возвратом. |
| wait_timeout целое число | Значение по умолчанию: 300 | Время ожидания перед отказом, в секундах. |
| watchdog логическое |
"True" | Установить состояние службы мониторинга Lassie. |
Примечания
Примечание
- Обратите внимание, что linode-python не поддерживает Python 3.
- Этот модуль использует устаревший API Linode версии 3.
-
LINODE_API_KEYпеременная среды может быть использована вместо этого. - Для определения необходимых параметров, пожалуйста, перейдите по ссылке https://www.linode.com/api/linode.
Примеры
- name: Create a new Linode
community.general.linode:
name: linode-test1
plan: 1
datacenter: 7
distribution: 129
state: present
register: linode_creation
- name: Create a server with a private IP Address
community.general.linode:
module: linode
api_key: 'longStringFromLinodeApi'
name: linode-test1
plan: 1
datacenter: 2
distribution: 99
password: 'superSecureRootPassword'
private_ip: yes
ssh_pub_key: 'ssh-rsa qwerty'
swap: 768
wait: yes
wait_timeout: 600
state: present
delegate_to: localhost
register: linode_creation
- name: Fully configure new server
community.general.linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
plan: 4
datacenter: 2
distribution: 99
kernel_id: 138
password: 'superSecureRootPassword'
private_ip: yes
ssh_pub_key: 'ssh-rsa qwerty'
swap: 768
wait: yes
wait_timeout: 600
state: present
alert_bwquota_enabled: True
alert_bwquota_threshold: 80
alert_bwin_enabled: True
alert_bwin_threshold: 10
alert_cpu_enabled: True
alert_cpu_threshold: 210
alert_bwout_enabled: True
alert_bwout_threshold: 10
alert_diskio_enabled: True
alert_diskio_threshold: 10000
backupweeklyday: 1
backupwindow: 2
displaygroup: 'test'
additional_disks:
- {Label: 'disk1', Size: 2500, Type: 'raw'}
- {Label: 'newdisk', Size: 2000}
watchdog: True
delegate_to: localhost
register: linode_creation
- name: Ensure a running server (create if missing)
community.general.linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
plan: 1
datacenter: 2
distribution: 99
password: 'superSecureRootPassword'
ssh_pub_key: 'ssh-rsa qwerty'
swap: 768
wait: yes
wait_timeout: 600
state: present
delegate_to: localhost
register: linode_creation
- name: Delete a server
community.general.linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
linode_id: "{{ linode_creation.instance.id }}"
state: absent
delegate_to: localhost
- name: Stop a server
community.general.linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
linode_id: "{{ linode_creation.instance.id }}"
state: stopped
delegate_to: localhost
- name: Reboot a server
community.general.linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
linode_id: "{{ linode_creation.instance.id }}"
state: restarted
delegate_to: localhost
Авторы
- Vincent Viallet (@zbal)
© 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/linode_module.html