community.general.gce_tag – добавление или удаление тега(ов) к/из экземпляров GCE
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.gce_tag.
Описание
- Этот модуль может добавлять или удалять метки 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 строка | Шаблон имён экземпляров 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
community.general.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)
community.general.gce_tag:
instance_name: test-server
tags: foo,bar
state: absent
- name: Add tags to instances in zone that match pattern
community.general.gce_tag:
instance_pattern: test-server-*
tags: foo,bar
zone: us-central1-a
state: present
Авторы
- Do Hoang Khiem (@dohoangkhiem) <(dohoangkhiem@gmail.com>
- Tom Melendez (@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.10/collections/community/general/gce_tag_module.html
