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

Примечание

Этот модуль входит в коллекцию google.cloud (версия 1.4.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: 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

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
accelerator_type строка / обязательно	Тип аппаратных ускорителей, связанных с этим узлом.
access_token строка	Токен доступа OAuth2, если тип аутентификации — accesstoken.
auth_kind строка / обязательно	Тип используемых учетных данных. Варианты: `"application"` `"machineaccount"` `"serviceaccount"` `"accesstoken"`
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 предопределяемым. Варианты: `false` `true`
scopes список / элементы=строка	Массив используемых областей
service_account_contents jsonarg	Содержимое файла JSON учетной записи службы, представленное либо в виде словаря, либо в виде JSON-строки.
service_account_email строка	Дополнительный адрес электронной почты учетной записи службы, если выбрано machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь	Путь к файлу JSON учетной записи службы, если тип serviceaccount выбран в качестве типа.
state строка	Требуется ли указанный объект в GCP Варианты: `"present"` ← (по умолчанию) `"absent"`
tensorflow_version строка / обязательно	Версия Tensorflow, работающая в узле.
use_service_networking логическое	Используется ли API Service Networking для настройки связывания VPC для узла? Настройка связывания VPC должна быть выполнена до развертывания узла. Если этот параметр установлен, параметр cidr_block не должен быть указан. Если сеть, к которой вы хотите подключить узел TPU, является сетью Shared VPC, узел должен быть создан с включением этого параметра. Варианты: `false` ← (по умолчанию) `true`
zone строка	Расположение GCP для TPU. Если оно не указано, используется зона поставщика.

Примечания

Примечание

API Reference: 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.
Для аутентификации вы можете установить access_token используя переменную окружения GCP_ACCESS_TOKEN.
Для аутентификации вы можете установить auth_kind используя переменную окружения GCP_AUTH_KIND.
Для аутентификации вы можете установить scopes используя переменную окружения GCP_SCOPES.
Значения переменных окружения будут использоваться только в том случае, если значения в playbook не установлены.
Параметры 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 string	Тип аппаратных ускорителей, связанных с этим узлом. Возвращается: успех
cidrBlock string	CIDR-блок, который узел TPU будет использовать при выборе IP-адреса. Этот CIDR-блок должен быть блоком /29; API сетей Compute Engine запрещает использование меньшего блока, а использование большего блока было бы нецелесообразным (узел может использовать только один IP-адрес). Ошибки возникнут, если CIDR-блок уже используется для существующего узла TPU, CIDR-блок конфликтует с любыми подсетями в сети, предоставленной пользователем, или предоставленная сеть связана с другой сетью, использующей этот CIDR-блок. Возвращается: успех
description string	Предоставленное пользователем описание TPU. Максимальное количество символов: 512. Возвращается: успех
labels dictionary	Метки ресурсов для представления метаданных, предоставленных пользователем. Возвращается: успех
name string	Неизменяемое имя TPU. Возвращается: успех
network string	Имя сети, к которой будет подключен узел TPU. Это должна быть существующая сеть Compute Engine в проекте, на котором активирован этот API. Если сеть не указана, будет использоваться «default». Возвращается: успех
networkEndpoints complex	Конечные точки сети, где можно получить доступ к рабочим процессам TPU и отправлять им задания. Рекомендуется, чтобы клиенты Tensorflow узла сначала обращались к первой (с индексом 0) записи. Возвращается: успех
ipAddress string	IP-адрес этой конечной точки сети. Возвращается: успех
port integer	Порт этой конечной точки сети. Возвращается: успех
schedulingConfig complex	Устанавливает параметры планирования для этого экземпляра TPU. Возвращается: успех
preemptible boolean	Определяет, является ли экземпляр TPU прерывистым. Возвращается: успех
serviceAccount string	Учетная запись службы, используемая для запуска служб потока тензоров в узле. Для совместного использования ресурсов, включая данные Google Cloud Storage, с задачей Tensorflow, работающей в узле, эта учетная запись должна иметь разрешения на доступ к этим данным. Возвращается: успех
tensorflowVersion string	Версия Tensorflow, работающая в узле. Возвращается: успех
useServiceNetworking boolean	Используется ли API Service Networking для настройки сопоставления VPC для узла. Сопоставление VPC должно быть настроено до подготовки узла. Если это поле установлено, поле cidr_block не должно быть указано. Если сеть, к которой вы хотите подключить узел TPU, является сетью Shared VPC, узел должен быть создан с включенным этим полем. Возвращается: успех
zone string	Расположение GCP для TPU. Если оно не указано, используется зона провайдера. Возвращается: успех

Авторы

Google Inc. (@googlecloudplatform)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/google/cloud/gcp_tpu_node_module.html