Spec-Zone.ru › Ansible 2.11

community.general.linode – Управление экземплярами в общедоступном облаке Linode

Примечание

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

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

Для использования в книге задач укажите: community.general.linode.

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры

Обзор

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

Требования

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

  • python >= 2.6
  • linode-python

Параметры

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

Примечания

Примечание

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

Spec-Zone.ru

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