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

Примечание

Этот модуль является частью коллекции community.general collection (версия 9.5.0).

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

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

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

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

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

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

Требования

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

linode_api4 >= 2.0.0

Параметры

Параметр	Комментарии
access_token string / required	Токен доступа к API Linode v4. Он также может быть указан путем предоставления переменной окружения `LINODE_ACCESS_TOKEN`. См. https://www.linode.com/docs/api#access-and-authentication.
authorized_keys list / elements=string	Список частей открытого ключа SSH для развертывания для пользователя root.
group string	Группа, под которой должен быть помечен экземпляр. Обратите внимание, что маркировка групп устарела, но все еще поддерживается. Рекомендуемый способ маркировки экземпляров — использование тегов.
image string	Образ экземпляра. Это обязательный параметр только при создании экземпляров Linode. См. https://www.linode.com/docs/api/images/.
label string / required	Метка экземпляра. Эта метка используется в качестве основного определителя идемпотентности для модуля и поэтому является обязательной.
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	Числовой ID StackScript, который нужно использовать при создании экземпляра. См. https://www.linode.com/docs/api/stackscripts/.
state string / required	Требуемое состояние экземпляра. Варианты: `"present"` `"absent"`
tags list / elements=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	Поддержка: отсутствует	В режиме diff будет возвращать подробную информацию о том, что изменилось (или, возможно, нуждается в изменении в `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 словарь	Описание экземпляра в формате 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

словарь

Описание экземпляра в формате 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/linode_v4_module.html