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

Новое в версии 2.9.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

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

Псевдонимы: gcp_tpu_node_facts

Требования

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

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, используя переменную среды c(gcp_service_account_file).
для аутентификации можно установить service_account_contents, используя переменную среды c(GCP_SERVICE_ACCOUNT_CONTENTS).
для аутентификации можно установить service_account_email, используя переменную среды GCP_SERVICE_ACCOUNT_EMAIL.
для аутентификации можно установить auth_kind, используя переменную среды GCP_AUTH_KIND.
для аутентификации можно установить scopes, используя переменную среды GCP_SCOPES.
Значения переменных среды будут использоваться только в том случае, если значения в playbook не установлены.
Параметры 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, работающая в узле.
	zone строка		успех	Расположение GCP для TPU.

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Данный модуль поддерживается сообществом Ansible. [community]

Авторы

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.9/modules/gcp_tpu_node_info_module.html