google.cloud.gcp_tpu_node – Создаёт узел GCP

Примечание

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

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

Для использования в плане задания укажите: google.cloud.gcp_tpu_node.

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Экземпляр виртуальной машины Cloud TPU.

Требования

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

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
accelerator_type строка / обязательно			Тип аппаратных ускорителей, связанных с этим узлом.
auth_kind строка / обязательно		Варианты: application machineaccount serviceaccount	Тип используемых учетных данных.
cidr_block строка			Диапазон CIDR, который будет использовать узел TPU при выборе IP-адреса. Этот диапазон CIDR должен быть /29; API-интерфейс Compute Engine запрещает использование меньшего диапазона, а использование большего диапазона будет неэффективным (узел может использовать только один IP-адрес). Возникнут ошибки, если диапазон CIDR уже используется для существующего узла TPU, диапазон CIDR конфликтует с подсетями в предоставленной сети пользователя или предоставленная сеть подключена к другой сети, использующей этот диапазон CIDR.
description строка			Описание узла TPU, предоставленное пользователем. Максимальная длина 512 символов.
env_type строка			Указывает, в какой среде Ansible вы выполняете этот модуль. Не нужно устанавливать, если вы не знаете, что делаете. Это изменяет только строку User Agent для всех API-запросов.
labels словарь			Метки ресурсов для представления пользовательских метаданных.
name строка / обязательно			Неизменяемое имя TPU.
network строка			Имя сети для подключения к узлу TPU. Это должна быть существующая сеть Compute Engine в проекте, для которого активирован этот API. Если не указано, используется «default».
project строка			Проект Google Cloud Platform, который следует использовать.
scheduling_config словарь			Устанавливает параметры планирования для этого экземпляра TPU.
	preemptible логическое значение / обязательно	Варианты: no yes	Определяет, является ли экземпляр TPU предварительно прерывимым.
scopes список / элементы=строка			Массив используемых областей.
service_account_contents jsonarg			Содержимое JSON-файла учетной записи службы, либо в виде словаря, либо как JSON-строка, которая его представляет.
service_account_email строка			Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь			Путь к файлу JSON учетной записи службы, если выбран тип serviceaccount.
state строка		Варианты: present ← absent	Указывает, должен ли данный объект существовать в GCP
tensorflow_version строка / обязательно			Версия TensorFlow, работающая в узле.
use_service_networking логическое значение		Варианты: no yes Значение по умолчанию: "false"	Указывает, настроено ли виртуальное соединение VPC для узла через API Service Networking. ВPC-соединение должно быть настроено перед развертыванием узла. Если этот параметр установлен, параметр cidr_block не должен быть указан. Если сеть, к которой требуется подключить узел TPU, представляет собой общую сеть VPC, узел должен быть создан с включённым этим параметром.
zone строка / обязательно			Географическое расположение GCP для TPU.

Примечания

Примечание

Справочник API: https://cloud.google.com/tpu/docs/reference/rest/v1/projects.locations.nodes
Официальная документация: https://cloud.google.com/tpu/docs/
для проверки подлинности можно установить 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: create a node
  google.cloud.gcp_tpu_node:
    name: test_object
    zone: us-central1-b
    accelerator_type: v3-8
    tensorflow_version: '1.11'
    cidr_block: 10.2.0.0/29
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: present

Возвращаемые значения

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

Ключевые параметры		Результат	Описание
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_module.html