Spec-Zone.ru › Ansible 2.9

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
-
    Варианты:
  • 1 ←
  • 12
  • 24
Срок оплаты для использования в экземпляре (срок оплаты в месяцах).
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

Spec-Zone.ru

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