google.cloud.gcp_tpu_node_info – Сбор информации о узле GCP

Примечание

Этот плагин входит в сборку google.cloud (версия 1.0.2).

Для его установки используйте: ansible-galaxy collection install google.cloud.

Чтобы использовать его в книге задач, укажите: google.cloud.gcp_tpu_node_info.

Обзор
Требования
Параметры
Примечания
Примеры
Значения возврата

Обзор

Сбор информации об узле GCP

Требования

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

python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
auth_kind строка / обязательно	Варианты: application machineaccount serviceaccount	Тип используемых учетных данных.
env_type строка		Указывает, в какой среде Ansible вы выполняете этот модуль. Это не следует устанавливать, если вы не знаете, что делаете. Это изменяет только строку User Agent для всех запросов API.
project строка		Проект Google Cloud Platform для использования.
scopes список / элементы=строка		Массив используемых областей
service_account_contents jsonarg		Содержимое файла Service Account JSON, либо в виде словаря, либо в виде JSON-строки, представляющей его.
service_account_email строка		Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь		Путь к файлу Service Account JSON, если тип serviceaccount выбран в качестве типа.
zone строка		Местоположение GCP для TPU. Если не указано, используется зона поставщика.

Примечания

Примечание

для аутентификации можно установить service_account_file с помощью переменной среды gcp_service_account_file.
для аутентификации можно установить service_account_contents с помощью переменной среды GCP_SERVICE_ACCOUNT_CONTENTS.
для аутентификации можно установить service_account_email с помощью переменной среды GCP_SERVICE_ACCOUNT_EMAIL.
для аутентификации можно установить auth_kind с помощью переменной среды GCP_AUTH_KIND.
для аутентификации можно установить scopes с помощью переменной среды GCP_SCOPES.
Значения переменных среды будут использоваться только в том случае, если значения в книге задач не установлены.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: get info on a node
  gcp_tpu_node_info:
    zone: us-central1-b
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:

Ключ			Возвращаемое	Описание
resources сложное			всегда	Список ресурсов
	acceleratorType строка		успех	Тип аппаратных ускорителей, связанных с этим узлом.
	cidrBlock строка		успех	Блок CIDR, который узел TPU будет использовать при выборе IP-адреса. Этот блок CIDR должен быть блоком /29; API сетей Compute Engine запрещает меньшие блоки, а использование больших блоков будет неэффективным (узел может использовать только один IP-адрес). Возникнут ошибки, если блок CIDR уже использовался для существующего узла TPU, блок CIDR конфликтует с любыми подсетями в предоставленной сети пользователя или предоставленная сеть связана с другой сетью, использующей этот блок CIDR.
	description строка		успех	Описание узла TPU, предоставленное пользователем. Максимальная длина 512 символов.
	labels словарь		успех	Метки ресурсов для представления пользовательских метаданных.
	name строка		успех	Неизменяемое имя TPU.
	network строка		успех	Имя сети, к которой следует подключить узел TPU. Это должна быть существующая сеть Compute Engine в рамках проекта, в котором активирован этот API. Если не указано, используется «default».
	networkEndpoints сложное		успех	Сеть конечных точек, к которым рабочие TPU могут получить доступ и отправлять задачи. Рекомендуется, чтобы клиенты Tensorflow узла сначала обращались к первому (индекс 0) элементу.
		ipAddress строка	успех	IP-адрес этой сетевой конечной точки.
		port целое число	успех	Порт этой сетевой конечной точки.
	schedulingConfig сложное		успех	Устанавливает параметры планирования для этого экземпляра TPU.
		preemptible булево	успех	Определяет, является ли экземпляр TPU прерывимым.
	serviceAccount строка		успех	Учетная запись службы, используемая для выполнения сервисов TensorFlow в узле. Для совместного использования ресурсов, включая данные Google Cloud Storage, с задачей TensorFlow, выполняемой в узле, эта учетная запись должна иметь разрешения на доступ к этим данным.
	tensorflowVersion строка		успех	Версия TensorFlow, работающая в узле.
	useServiceNetworking булево		успех	Указывает, настроено ли совместное использование сети VPC для узла через API Service Networking. Настройка совместного использования сети VPC должна быть выполнена до развертывания узла. Если это поле установлено, поле cidr_block не должно быть указано. Если сеть, к которой вы хотите подключить узел TPU, является сетью Shared VPC, узел должен быть создан с включенным этим полем.
	zone строка		успех	Местоположение GCP для TPU. Если не указано, используется зона поставщика.

Авторы

Google Inc. (@googlecloudplatform)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/google/cloud/gcp_tpu_node_info_module.html