Spec-Zone.ru › Ansible

Модуль google.cloud.gcp_tpu_node — создание узла GCP

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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

Параметры

Параметр

Комментарии

accelerator_type

string / обязательный

Тип аппаратных ускорителей, связанных с этим узлом.

access_token

string

Токен доступа OAuth2, если тип учётных данных — accesstoken.

auth_kind

string / обязательный

Тип используемых учётных данных.

Варианты:

  • "application"
  • "machineaccount"
  • "serviceaccount"
  • "accesstoken"

cidr_block

string

Блок CIDR, который узел TPU будет использовать при выборе IP-адреса. Этот блок CIDR должен иметь размер /29: API сетей Compute Engine запрещает блоки меньшего размера, а использование блока большего размера было бы нерациональным (узел может использовать только один IP-адрес).

Возникнет ошибка, если блок CIDR уже используется существующим узлом TPU, конфликтует с любой подсетью в предоставленной пользователем сети или если предоставленная сеть подключена к другой сети, использующей этот блок CIDR.

description

string

Описание TPU, предоставленное пользователем. Максимум 512 символов.

env_type

string

Указывает, в какой среде Ansible выполняется этот модуль.

Не задавайте этот параметр, если не знаете, что делаете.

Он изменяет только строку User Agent для запросов API.

labels

dictionary

Метки ресурса для представления метаданных, предоставленных пользователем.

name

string / обязательный

Неизменяемое имя TPU.

network

string

Имя сети, к которой нужно подключить узел TPU. Это должна быть существующая сеть Compute Engine в проекте, для которого активирован этот API. Если сеть не указана, будет использоваться «default».

project

string

Проект Google Cloud Platform, который нужно использовать.

scheduling_config

dictionary

Задаёт параметры планирования для этого экземпляра TPU.

preemptible

boolean / обязательный

Определяет, является ли экземпляр TPU прерываемым.

Варианты:

  • false
  • true

scopes

list / elements=string

Массив используемых областей доступа

service_account_contents

jsonarg

Содержимое JSON-файла сервисного аккаунта в виде словаря или строки JSON, представляющей это содержимое.

service_account_email

string

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

service_account_file

path

Путь к JSON-файлу сервисного аккаунта, если в качестве типа выбран serviceaccount.

state

string

Должен ли указанный объект существовать в GCP

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tensorflow_version

string / обязательный

Версия Tensorflow, работающая на узле.

use_service_networking

boolean

Настроено ли подключение VPC для узла через API Service Networking.

Подключение VPC необходимо настроить до подготовки узла. Если это поле задано, поле cidr_block указывать не следует. Если сеть, к которой нужно подключить узел TPU, является общей сетью VPC, узел необходимо создать с включённым этим полем.

Варианты:

  • false
  • true

zone

string

Местоположение TPU в GCP. Если оно не указано, используется зона провайдера.

Примечания

Примечание

  • Справочник 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.
  • Для аутентификации можно задать access_token с помощью переменной окружения GCP_ACCESS_TOKEN.
  • Для аутентификации можно задать 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

string

Тип аппаратных ускорителей, связанных с этим узлом.

Возвращается: при успехе

cidrBlock

string

Блок CIDR, который узел TPU будет использовать при выборе IP-адреса. Этот блок CIDR должен иметь размер /29: API сетей Compute Engine запрещает блоки меньшего размера, а использование блока большего размера было бы нерациональным (узел может использовать только один IP-адрес).

Возникнет ошибка, если блок CIDR уже используется существующим узлом TPU, конфликтует с любой подсетью в предоставленной пользователем сети или если предоставленная сеть подключена к другой сети, использующей этот блок 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

Сервисный аккаунт, используемый для запуска сервисов TensorFlow на узле. Чтобы предоставить заданию Tensorflow, выполняющемуся на узле, доступ к ресурсам, включая данные Google Cloud Storage, у этой учётной записи должны быть соответствующие разрешения.

Возвращается: при успехе

tensorflowVersion

string

Версия Tensorflow, работающая на узле.

Возвращается: при успехе

useServiceNetworking

boolean

Настроено ли подключение VPC для узла через API Service Networking.

Подключение VPC необходимо настроить до подготовки узла. Если это поле задано, поле cidr_block указывать не следует. Если сеть, к которой нужно подключить узел TPU, является общей сетью VPC, узел необходимо создать с включённым этим полем.

Возвращается: при успехе

zone

string

Местоположение TPU в GCP. Если оно не указано, используется зона провайдера.

Возвращается: при успехе

Авторы

  • Google Inc. (@googlecloudplatform)

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

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API