linode – Управление экземплярами в Linode Public Cloud
Обзор
- Управление экземплярами Linode Public Cloud и, по желанию, ожидание состояния «запущен».
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- linode-python
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| additional_disks - | Список словарей для создания дополнительных дисков, которые добавляются к настройкам конфигурации Linode. Словарь принимает Размер, Метка, Тип. Размер в МБ. | |
| alert_bwin_enabled boolean |
| Установить состояние уведомлений о пропускной способности. |
| alert_bwin_threshold - | Установить порог пропускной способности в МБ для уведомлений. | |
| alert_bwout_enabled boolean |
| Установить состояние уведомлений о пропускной способности вывода. |
| alert_bwout_threshold - | Установить порог пропускной способности вывода в МБ для уведомлений. | |
| alert_bwquota_enabled boolean |
| Установить состояние уведомлений о квоте пропускной способности как процент от квоты сетевого трафика. |
| alert_bwquota_threshold - | Установить порог пропускной способности квоты в МБ для уведомлений. | |
| alert_cpu_enabled boolean |
| Установить состояние получения уведомлений об использовании ЦП. |
| alert_cpu_threshold - | Установить процентный порог для получения уведомлений об использовании ЦП. Каждый процессорный ядро добавляет 100% к общему значению. | |
| alert_diskio_enabled boolean |
| Установить состояние получения уведомлений об операциях ввода/вывода на диске. |
| alert_diskio_threshold - | Установить порог для среднего значения операций ввода/вывода в секунду за 2-часовой период. | |
| api_key - | Ключ API Linode | |
| backupweeklyday - | Целое число, обозначающее день недели для хранения еженедельных резервных копий. | |
| datacenter - | ЦОД для создания экземпляра (ЦОД Linode). | |
| displaygroup - | Добавить экземпляр в группу отображения в Linode Manager. | |
| distribution - | Дистрибутив для использования в экземпляре (Дистрибутив Linode). | |
| kernel_id - добавлено в 2.4 | Ядро для использования в экземпляре (Ядро Linode). | |
| linode_id - | Уникальный идентификатор сервера linode. Это значение является только для чтения в том смысле, что если вы укажете его при создании Linode, он не будет использован. API Linode генерирует эти идентификаторы, и мы можем использовать эти сгенерированные значения здесь для более точной ссылки на Linode. Это полезно для идемпотентности. псевдонимы: lid | |
| name - / обязательно | Имя экземпляра (буквенно-цифровое, дефисы, подчеркивание). Для сохранения целостности консоли Linode веб-портала, имя префикс LinodeID-. | |
| password - | Пароль root для нового сервера (автоматически генерируется, если отсутствует). | |
| payment_term - |
| Срок оплаты для использования в экземпляре (срок оплаты в месяцах). |
| plan - | Пакет для использования в экземпляре (план Linode). | |
| private_ip boolean |
| Добавить частный IPv4-адрес при создании Linode. |
| ssh_pub_key - | Открытый ключ SSH, применяемый к пользователю root. | |
| state - |
| Укажите желаемое состояние ресурса. |
| swap - | По умолчанию: 512 | размер подкачки в МБ |
| wait boolean |
| подождать, пока экземпляр перейдет в состояние running перед возвратом |
| wait_timeout - | По умолчанию: 300 | сколько времени ожидать, пока произойдёт отказ, в секундах |
| watchdog boolean |
| Установить состояние сторожевой собаки Lassie. |
Примечания
Примечание
- Обратите внимание, что linode-python не поддерживает python 3.
- Этот модуль использует устаревшую версию 3 API Linode.
-
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.9/modules/linode_module.html