gce_tag — добавление или удаление тегов (метки) для экземпляров GCE
Новое в версии 2.0.
Обзор
- Этот модуль может добавлять или удалять теги https://cloud.google.com/compute/docs/label-or-tag-resources#tags для экземпляров GCE. Используйте ‘instance_pattern’, чтобы обновить несколько экземпляров в заданной зоне.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- apache-libcloud >= 0.17.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| instance_name | Имя экземпляра GCE для добавления/удаления тегов.
Обязательно, если instance_pattern не указано. |
|
| instance_pattern (добавлено в 2.3) |
Шаблон имен экземпляров GCE для сопоставления при добавлении/удалении тегов. Поддерживается полный синтаксис регулярных выражений Python. Подробности см. в https://docs.python.org/2/library/re.html.
Если instance_name не указано, этот параметр обязателен. |
|
| pem_file | Путь к файлу PEM, связанному с адресом электронной почты учетной записи службы. |
|
| project_id | Идентификатор вашего проекта GCE. |
|
| service_account_email | Адрес электронной почты учетной записи службы. |
|
| state |
|
Желаемое состояние тегов. |
| tags обязательно |
Список тегов, разделенных запятыми, которые нужно добавить или удалить. |
|
| zone | По умолчанию: "us-central1-a" |
Зона диска, указанного параметром source. |
Примечания
Примечание
- Требуется либо instance_name, либо instance_pattern.
Примеры
- name: Add tags to instance
gce_tag:
instance_name: staging-server
tags: http-server,https-server,staging
zone: us-central1-a
state: present
- name: Remove tags from instance in default zone (us-central1-a)
gce_tag:
instance_name: test-server
tags: foo,bar
state: absent
- name: Add tags to instances in zone that match pattern
gce_tag:
instance_pattern: test-server-*
tags: foo,bar
zone: us-central1-a
state: present
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратной совместимости интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Дополнительная информация представлена в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, которые также поддерживаются сообществом Ansible, см. в разделе здесь.
Автор
- До Хоанг Хием (dohoangkhiem@gmail.com)
- Том Мелендес (@supertom)
Подсказка
Если вы обнаружите проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/gce_tag_module.html
