community.general.linode_v4 – Управление экземплярами в облаке Linode.

Примечание

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

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

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

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управление экземплярами в облаке Linode.

Требования

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

python >= 2.7
linode_api4 >= 2.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
access_token строка / обязательно		Токен доступа к API Linode v4. Также может быть указан через переменную среды `LINODE_ACCESS_TOKEN`. См. https://www.linode.com/docs/api#access-and-authentication.
authorized_keys список / элементы=строка		Список SSH-открытых ключей для развёртывания от имени пользователя root.
group строка		Группа, под которой должен быть помечен экземпляр. Обратите внимание, что группировка устарела, но всё ещё поддерживается. Рекомендуемый способ маркировки экземпляров — использование тегов.
image строка		Изображение экземпляра. Этот параметр требуется только при создании экземпляров Linode. См. https://www.linode.com/docs/api/images/.
label строка / обязательно		Метка экземпляра. Эта метка используется в качестве основного определителя идемпотентности для модуля и поэтому является обязательной.
region строка		Регион экземпляра. Этот параметр требуется только при создании экземпляров Linode. См. https://www.linode.com/docs/api/regions/.
root_pass строка		Пароль для пользователя root. Если не указан, будет сгенерирован. Сгенерированный пароль будет доступен в JSON-ответе при успешном выполнении задачи.
stackscript_data словарь добавлен в 1.3.0 community.general		Объект, содержащий аргументы для всех пользовательских полей, присутствующих в StackScript, используемых при создании экземпляра. Действителен только при указании stackscript_id. См. https://www.linode.com/docs/api/stackscripts/.
stackscript_id целое число добавлен в 1.3.0 community.general		Числовой ID StackScript для использования при создании экземпляра. См. https://www.linode.com/docs/api/stackscripts/.
state строка / обязательно	Варианты: present absent	Желаемое состояние экземпляра.
tags список / элементы=строка		Теги, под которыми должен быть помечен экземпляр. См. https://www.linode.com/docs/api/tags/.
type строка		Тип экземпляра. Этот параметр требуется только при создании экземпляров Linode. См. https://www.linode.com/docs/api/linode-types/.

Примечания

Примечание

В настоящее время масштабирование Linode не реализовано. Этот модуль со временем заменит текущий модуль Linode, который использует устаревшие API-связки на стороне Linode.

Примеры

- name: Create a new Linode.
  community.general.linode_v4:
    label: new-linode
    type: g6-nanode-1
    region: eu-west
    image: linode/debian9
    root_pass: passw0rd
    authorized_keys:
      - "ssh-rsa ..."
    stackscript_id: 1337
    stackscript_data:
      variable: value
    state: present

- name: Delete that new Linode.
  community.general.linode_v4:
    label: new-linode
    state: absent

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие — поля, уникальные для этого модуля:

Ключ	Возвращаемое значение	Описание
instance словарь	Всегда.	Описание экземпляра в формате JSON. Пример: {'alerts': {'cpu': 90, 'io': 10000, 'network_in': 10, 'network_out': 10, 'transfer_quota': 80}, 'backups': {'enabled': False, 'schedule': {'day': None, 'window': None}}, 'created': '2018-09-26T08:12:33', 'group': 'Группа Foobar', 'hypervisor': 'kvm', 'id': 10480444, 'image': 'linode/centos7', 'ipv4': ['130.132.285.233'], 'ipv6': '2a82:7e00::h03c:46ff:fe04:5cd2/64', 'label': 'lin-foo', 'region': 'европейский запад', 'root_pass': 'foobar', 'specs': {'disk': 25600, 'memory': 1024, 'transfer': 1000, 'vcpus': 1}, 'status': 'running', 'tags': [], 'type': 'g6-nanode-1', 'updated': '2018-09-26T10:10:14', 'watchdog_enabled': True}

Авторы

Luke Murphy (@decentral1se)

© 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_v4_module.html