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

Примечание

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

Для его установки используйте: 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		Содержимое файла JSON учетной записи службы, представленное либо в виде словаря, либо как JSON-строка.
service_account_email строка		Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь		Путь к файлу 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/google/cloud/gcp_tpu_node_info_module.html