linode – Управление экземплярами в Linode Public Cloud
Обзор
- Управление экземплярами Linode Public Cloud и, необязательно, ожидание, пока они не перейдут в состояние «запущен».
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- linode-python
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| additional_disks - добавлен в 2.3 | Список словарей для создания дополнительных дисков, которые добавляются к настройкам конфигурации Linode. Словарь принимает Size, Label, Type. Размер в МБ. | |
| alert_bwin_enabled boolean добавлен в 2.3 |
| Установить статус уведомлений о пропускной способности входящего трафика. |
| alert_bwin_threshold - добавлен в 2.3 | Установить порог в МБ для уведомлений о пропускной способности входящего трафика. | |
| alert_bwout_enabled boolean добавлен в 2.3 |
| Установить статус уведомлений о пропускной способности исходящего трафика. |
| alert_bwout_threshold - добавлен в 2.3 | Установить порог в МБ для уведомлений о пропускной способности исходящего трафика. | |
| alert_bwquota_enabled boolean добавлен в 2.3 |
| Установить статус уведомлений о квоте пропускной способности в процентах от квоты сетевого трафика. |
| alert_bwquota_threshold - добавлен в 2.3 | Установить порог в МБ для уведомлений о квоте пропускной способности. | |
| alert_cpu_enabled boolean добавлен в 2.3 |
| Установить статус получения уведомлений о загрузке ЦП. |
| alert_cpu_threshold - добавлен в 2.3 | Установить процентный порог для получения уведомлений о загрузке ЦП. Каждый процессор добавляет 100% к общему значению. | |
| alert_diskio_enabled boolean добавлен в 2.3 |
| Установить статус получения уведомлений о ввода/выводе на диск. |
| alert_diskio_threshold - добавлен в 2.3 | Установить порог для среднего значения операций ввода/вывода в секунду за 2 часа. | |
| api_key - | Ключ API Linode | |
| backupweeklyday - добавлен в 2.3 | Целое число, обозначающее день недели для хранения еженедельных резервных копий. | |
| datacenter - | ЦОД для создания экземпляра (ЦОД Linode) | |
| displaygroup - добавлен в 2.3 | Добавить экземпляр в группу отображения в Linode Manager. | |
| distribution - | Распределение для использования в экземпляре (Распределение Linode) | |
| kernel_id - добавлен в 2.4 | Ядро для использования в экземпляре (Ядро Linode) | |
| linode_id - | Уникальный идентификатор сервера linode. Это значение является только для чтения в том смысле, что если вы укажете его при создании Linode, оно не будет использовано. Linode API генерирует эти идентификаторы, и мы можем использовать эти сгенерированные значения здесь для более точной ссылки на Linode. Это полезно для идемпотентности. псевдонимы: lid | |
| name - / обязательно | Имя экземпляра (буквенно-цифровое, дефисы, нижние подчеркивания). Для поддержания порядка на веб-консоли Linode имя предваряется значением LinodeID-. | |
| password - | Пароль root для нового сервера (автоматически генерируется, если отсутствует) | |
| payment_term - |
| Срок оплаты для использования в экземпляре (срок оплаты в месяцах) |
| plan - | Пакет для использования в экземпляре (Пакет Linode) | |
| private_ip boolean добавлен в 2.3 |
| Добавить частный IPv4-адрес при создании Linode. |
| ssh_pub_key - | Открытый ключ SSH, применяемый к пользователю root | |
| state - |
| Указать желаемое состояние ресурса |
| swap - | По умолчанию: 512 | Размер подкачки в МБ |
| wait boolean |
| Подождать, пока экземпляр не перейдет в состояние running перед возвратом |
| wait_timeout - | По умолчанию: 300 | Сколько времени ожидать, пока ожидание не завершится, в секундах |
| watchdog boolean добавлен в 2.2 |
| Установить статус сервиса Lassie watchdog. |
Примечания
Примечание
- Обратите внимание, что linode-python не поддерживает Python 3.
- Этот модуль использует устаревший API Linode v3.
-
LINODE_API_KEYпеременная среды может быть использована вместо неё. - Пожалуйста, ознакомьтесь с https://www.linode.com/api/linode для определения необходимых параметров.
Примеры
- name: Create a new Linode
linode:
name: linode-test1
plan: 1
datacenter: 7
distribution: 129
state: present
register: linode_creation
- name: Create a server with a private IP Address
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
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)
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
linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
linode_id: "{{ linode_creation.instance.id }}"
state: absent
delegate_to: localhost
- name: Stop a server
linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
linode_id: "{{ linode_creation.instance.id }}"
state: stopped
delegate_to: localhost
- name: Reboot a server
linode:
api_key: 'longStringFromLinodeApi'
name: linode-test1
linode_id: "{{ linode_creation.instance.id }}"
state: restarted
delegate_to: localhost
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/linode_module.html