Spec-Zone.ru › Ansible 2.8

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
    Варианты:
  • no
  • yes
Установить статус уведомлений о пропускной способности входящего трафика.
alert_bwin_threshold
-
добавлен в 2.3
Установить порог в МБ для уведомлений о пропускной способности входящего трафика.
alert_bwout_enabled
boolean
добавлен в 2.3
    Варианты:
  • no
  • yes
Установить статус уведомлений о пропускной способности исходящего трафика.
alert_bwout_threshold
-
добавлен в 2.3
Установить порог в МБ для уведомлений о пропускной способности исходящего трафика.
alert_bwquota_enabled
boolean
добавлен в 2.3
    Варианты:
  • no
  • yes
Установить статус уведомлений о квоте пропускной способности в процентах от квоты сетевого трафика.
alert_bwquota_threshold
-
добавлен в 2.3
Установить порог в МБ для уведомлений о квоте пропускной способности.
alert_cpu_enabled
boolean
добавлен в 2.3
    Варианты:
  • no
  • yes
Установить статус получения уведомлений о загрузке ЦП.
alert_cpu_threshold
-
добавлен в 2.3
Установить процентный порог для получения уведомлений о загрузке ЦП. Каждый процессор добавляет 100% к общему значению.
alert_diskio_enabled
boolean
добавлен в 2.3
    Варианты:
  • no
  • yes
Установить статус получения уведомлений о ввода/выводе на диск.
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
-
    Варианты:
  • 1 ←
  • 12
  • 24
Срок оплаты для использования в экземпляре (срок оплаты в месяцах)
plan
-
Пакет для использования в экземпляре (Пакет Linode)
private_ip
boolean
добавлен в 2.3
    Варианты:
  • no ←
  • yes
Добавить частный IPv4-адрес при создании Linode.
ssh_pub_key
-
Открытый ключ SSH, применяемый к пользователю root
state
-
    Варианты:
  • absent
  • active
  • deleted
  • present ←
  • restarted
  • started
  • stopped
Указать желаемое состояние ресурса
swap
-
По умолчанию:
512
Размер подкачки в МБ
wait
boolean
    Варианты:
  • no ←
  • yes
Подождать, пока экземпляр не перейдет в состояние running перед возвратом
wait_timeout
-
По умолчанию:
300
Сколько времени ожидать, пока ожидание не завершится, в секундах
watchdog
boolean
добавлен в 2.2
    Варианты:
  • no
  • yes ←
Установить статус сервиса 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API