Spec-Zone.ru › Ansible 2.10

community.general.linode – Управление экземплярами на Linode Public Cloud

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general

Для использования в плейбуке, укажите: community.general.linode

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры

Краткое описание

  • Управление экземплярами Linode Public Cloud и, по желанию, ожидание перехода в состояние «запущен».

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

  • python >= 2.6
  • linode-python

Параметры

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

Примечания

Примечание

  • Обратите внимание, что linode-python не поддерживает Python 3.
  • Этот модуль использует устаревший API Linode версии 3.
  • 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/linode_module.html

Spec-Zone.ru

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