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

Примечание

Этот плагин является частью коллекции google.cloud (версия 1.0.2).

Для его установки используйте: 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 булево / обязательно	Варианты: нет да	Определяет, является ли экземпляр TPU предсказуемым.
scopes список / элементы=строка			Массив используемых областей
service_account_contents jsonarg			Содержимое файла JSON учетной записи службы, представленное либо словарем, либо строкой JSON.
service_account_email строка			Дополнительный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь			Путь к файлу JSON учетной записи службы, если выбран тип serviceaccount.
state строка		Варианты: present ← отсутствует	Указывает, должен ли данный объект существовать в GCP
tensorflow_version строка / обязательно			Версия TensorFlow, работающая в узле.
use_service_networking булево		Варианты: нет да Значение по умолчанию: "false"	Указывает, настроен ли VPC-соединение узла через API Service Networking. ВPC-соединение должно быть настроено перед развертыванием узла. Если этот параметр установлен, параметр cidr_block не должен быть указан. Если сеть, к которой нужно подключить узел TPU, является сетью Shared 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 строка		success	Тип аппаратных ускорителей, связанных с этим узлом.
cidrBlock строка		success	CIDR-блок, который узел TPU будет использовать при выборе IP-адреса. Этот CIDR-блок должен быть блоком /29; API сетей Compute Engine запрещает использование меньшего блока, а использование большего блока будет избыточным (узел может использовать только один IP-адрес). Возникнут ошибки, если CIDR-блок уже используется для существующего узла TPU, CIDR-блок конфликтует с какими-либо подсетями в предоставленной пользователю сети или предоставленная сеть связана с другой сетью, использующей этот CIDR-блок.
description строка		success	Описание TPU, предоставленное пользователем. Максимальная длина 512 символов.
labels словарь		success	Метки ресурсов для представления предоставленных пользователем метаданных.
name строка		success	Неизменяемое имя TPU.
network строка		success	Имя сети, к которой следует подключить узел TPU. Это должна быть существующая сеть Compute Engine в проекте, в котором активирован этот API. Если не указано, будет использоваться "default".
networkEndpoints сложная структура		success	Сетевые конечные точки, через которые к узлам TPU рабочих процессов можно получить доступ и отправлять задания. Рекомендуется, чтобы клиенты Tensorflow для узла сначала обращались к первой записи (с индексом 0).
	ipAddress строка	success	IP-адрес этой сетевой конечной точки.
	port целое число	success	Порт этой сетевой конечной точки.
schedulingConfig сложная структура		success	Устанавливает параметры планирования для этого экземпляра TPU.
	preemptible булево	success	Определяет, является ли экземпляр TPU предварительно выводимым.
serviceAccount строка		success	Учетная запись службы, используемая для запуска служб TensorFlow внутри узла. Для совместного использования ресурсов, включая данные Google Cloud Storage, с заданием TensorFlow, выполняемым в узле, эта учетная запись должна иметь разрешения на доступ к этим данным.
tensorflowVersion строка		success	Версия TensorFlow, выполняемая в узле.
useServiceNetworking булево		success	Указывает, настроено ли взаимное соединение VPC для узла через API Service Networking. Взаимное соединение VPC должно быть настроено до подготовки узла. Если этот параметр установлен, параметр cidr_block не должен быть указан. Если сеть, к которой вы хотите подключить узел TPU, является сетью Shared VPC, узел должен быть создан с включенным этим параметром.
zone строка		success	Географическое расположение 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_module.html