Модуль community.general.linode_v4 — управление экземплярами в облаке Linode

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.linode_v4.

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

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

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

Требования

Следующие требования необходимы на хосте, на котором выполняется этот модуль.

linode_api4 >= 2.0.0

Параметры

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

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме сравнения возвращает сведения об изменениях (или о том, что может потребоваться изменить в `check_mode`).

Примечания

Примечание

Изменение размера 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 dictionary	Описание экземпляра в формате JSON. Возвращается: всегда. Пример: {"alerts": {"cpu": 90, "io": 10000, "network_in": 10, "network_out": 10, "transfer_quota": 80}, "backups": {"enabled": false, "schedule": {"day": null, "window": null}}, "created": "2018-09-26T08:12:33", "group": "Foobar Group", "hypervisor": "kvm", "id": 10480444, "image": "linode/centos7", "ipv4": ["130.132.285.233"], "ipv6": "2a82:7e00::h03c:46ff:fe04:5cd2/64", "label": "lin-foo", "region": "eu-west", "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}

Ключ

Описание

instance

dictionary

Описание экземпляра в формате JSON.

Возвращается: всегда.

Пример: {"alerts": {"cpu": 90, "io": 10000, "network_in": 10, "network_out": 10, "transfer_quota": 80}, "backups": {"enabled": false, "schedule": {"day": null, "window": null}}, "created": "2018-09-26T08:12:33", "group": "Foobar Group", "hypervisor": "kvm", "id": 10480444, "image": "linode/centos7", "ipv4": ["130.132.285.233"], "ipv6": "2a82:7e00::h03c:46ff:fe04:5cd2/64", "label": "lin-foo", "region": "eu-west", "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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/linode_v4_module.html