community.general.linode – Управление экземплярами в общедоступном облаке Linode
Примечание
Этот плагин является частью коллекции community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.linode.
Обзор
- Управление экземплярами Linode Public Cloud и, по желанию, ожидание состояния «запущен».
Требования
Ниже перечислены требования, необходимые на хосте, на котором будет выполняться этот модуль.
- python >= 2.6
- linode-python
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| additional_disks список / элементы=строка | Список словарей для создания дополнительных дисков, которые добавляются к настройкам конфигурации Linode. Словарь использует поля Размер, Метка, Тип. Размер указан в МБ. | |
| 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 строка | Корневой пароль, применяемый к новому серверу (автоматически генерируется, если отсутствует) | |
| payment_term целое число |
1 | Срок оплаты для использования в экземпляре (срок оплаты в месяцах) |
| plan целое число | План для использования в экземпляре (План Linode) | |
| private_ip логическое значение |
| Добавить частный IPv4-адрес при создании Linode. Значение по умолчанию — false. |
| ssh_pub_key строка | Открытый ключ SSH, применяемый к корневому пользователю | |
| state строка |
| Укажите желаемое состояние ресурса |
| swap целое число | Значение по умолчанию: 512 | Размер подкачки в МБ |
| wait логическое значение |
| Ожидать состояния экземпляра running перед возвратом |
| wait_timeout целое число | Значение по умолчанию: 300 | Сколько времени ждать, прежде чем ожидание будет прервано, в секундах |
| watchdog логическое значение |
"True" | Устанавливает статус сторожевой собаки Lassie. |
Примечания
Примечание
- Обратите внимание, что linode-python не поддерживает python 3.
- Этот модуль использует устаревший API Linode v3.
-
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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/linode_module.html