google.cloud.gcp_compute_node_template_info модуль — Сбор информации о GCP NodeTemplate
Примечание
Этот модуль входит в состав коллекции google.cloud (версия 1.4.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.
Для использования в книге задач укажите: google.cloud.gcp_compute_node_template_info.
Описание
- Сбор информации о GCP NodeTemplate
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
Параметр | Комментарии |
|---|---|
access_token строка | Токен доступа OAuth2, если тип учетных данных — accesstoken. |
auth_kind строка / обязательно | Тип учетных данных, используемых для аутентификации. Варианты:
|
env_type строка | Указывает, в какой среде Ansible выполняется этот модуль. Это поле не нужно устанавливать, если вам неизвестно, что вы делаете. Это поле изменяет только строку пользовательского агента для всех запросов к API. |
filters список / элементы=строка | Список пар значений фильтров. Доступные фильтры перечислены здесь https://cloud.google.com/sdk/gcloud/reference/topic/filters. Каждый дополнительный фильтр в списке будет добавлен как условие И (filter1 и filter2). |
project строка | Проект Google Cloud Platform для использования. |
region строка / обязательно | Регион, в котором узлы, использующие шаблон узла, будут созданы. |
scopes список / элементы=строка | Массив областей видимости для использования. |
service_account_contents jsonarg | Содержимое файла JSON учетной записи службы, либо в словаре, либо в виде строки JSON, которая его представляет. |
service_account_email строка | Дополнительный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию. |
service_account_file путь | Путь к файлу JSON учетной записи службы, если тип serviceaccount выбран в качестве типа. |
Примечания
Примечание
- для аутентификации можно установить service_account_file с помощью переменной среды
GCP_SERVICE_ACCOUNT_FILE. - для аутентификации можно установить service_account_contents с помощью переменной среды
GCP_SERVICE_ACCOUNT_CONTENTS. - для аутентификации можно установить service_account_email с помощью переменной среды
GCP_SERVICE_ACCOUNT_EMAIL. - для аутентификации можно установить access_token с помощью переменной среды
GCP_ACCESS_TOKEN. - для аутентификации можно установить auth_kind с помощью переменной среды
GCP_AUTH_KIND. - для аутентификации можно установить scopes с помощью переменной среды
GCP_SCOPES. - Значения переменных среды будут использоваться только в том случае, если значения в книге задач не установлены.
- Параметры service_account_email и service_account_file взаимоисключающие.
Примеры
- name: get info on a node template
gcp_compute_node_template_info:
region: us-central1
filters:
- name = test_object
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:
Ключ | Описание |
|---|---|
resources сложный | Список ресурсов Возвращается: всегда |
|
cpuOvercommitType строка |
Перераспределение процессорных ресурсов. Возвращается: успех |
|
creationTimestamp строка |
Дата и время создания в формате RFC3339. Возвращается: успех |
|
description строка |
Необязательное текстовое описание ресурса. Возвращается: успех |
|
name строка |
Имя ресурса. Возвращается: успех |
|
nodeAffinityLabels словарь |
Метки для сродства узлов, которые будут использоваться при планировании экземпляров. Возвращается: успех |
|
nodeType строка |
Тип узла для использования в группе узлов, созданных из этой шаблона. Можно указать только один из nodeTypeFlexibility и nodeType. Возвращается: успех |
|
nodeTypeFlexibility сложный |
Гибкие свойства для желаемого типа узла. Группы узлов, использующие этот шаблон, будут создавать узлы типа, соответствующего этим свойствам. Можно указать только один из nodeTypeFlexibility и nodeType. Возвращается: успех |
|
cpus строка |
Количество виртуальных процессоров. Возвращается: успех |
|
localSsd строка |
Использовать локальный SSD. Возвращается: успех |
|
memory строка |
Физическая память, доступная узлу, в МБ. Возвращается: успех |
|
region строка |
Регион, в котором будут созданы узлы, использующие шаблон. Возвращается: успех |
|
serverBinding сложный |
Политика привязки сервера для узлов, использующих этот шаблон. Определяет, где должны перезапуститься узлы после события технического обслуживания. Возвращается: успех |
|
type строка |
Тип политики привязки сервера. Если `RESTART_NODE_ON_ANY_SERVER`, узлы, использующие этот шаблон, перезапустятся на любом физическом сервере после события технического обслуживания. Если `RESTART_NODE_ON_MINIMAL_SERVER`, узлы, использующие этот шаблон, перезапустятся на том же физическом сервере после события технического обслуживания, вместо того, чтобы быть мигрированными или перезапущенными на новом физическом сервере. Этот параметр может быть полезен, если вы используете программные лицензии, связанные с характеристиками базового сервера, такими как физические сокеты или ядра, чтобы избежать необходимости в дополнительных лицензиях при проведении технического обслуживания. Однако виртуальные машины на таких узлах будут испытывать перерывы в работе во время проведения технического обслуживания. Возвращается: успех |
Ссылки на сборку
© 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/google/cloud/gcp_compute_node_template_info_module.html
