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

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

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

Описание

Инстанс облачного 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 Значение по умолчанию: "false"	Определяет, является ли экземпляр TPU предварительно прерывимым.
scopes список			Массив используемых областей.
service_account_contents jsonarg			Содержимое файла JSON учетной записи службы, либо в виде словаря, либо в виде JSON-строки, представляющей его.
service_account_email строка			Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь			Путь к файлу JSON учетной записи службы, если в качестве типа выбран serviceaccount.
state строка		Варианты: present ← absent	Указывает, должен ли заданный объект существовать в GCP
tensorflow_version строка / обязательно			Версия Tensorflow, работающая в узле.
zone строка / обязательно			Расположение GCP для TPU.

Примечания

Примечание

Ссылка на API: https://cloud.google.com/tpu/docs/reference/rest/
Официальная документация: https://cloud.google.com/tpu/docs/
для проверки подлинности можно установить 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: create a node
  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 строка		успех	Учетная запись службы, используемая для запуска сервисов tensor flow внутри узла. Чтобы поделиться ресурсами, включая данные Google Cloud Storage, с заданием Tensorflow, выполняемым в узле, этой учетной записи необходимо иметь разрешения на эти данные.
tensorflowVersion строка		успех	Версия Tensorflow, работающая в узле.
zone строка		успех	Расположение GCP для TPU.

Статус

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

Авторы

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_module.html