Spec-Zone.ru › TensorFlow

tf.distribute.cluster_resolver.SlurmClusterResolver

ClusterResolver для системы с диспетчером рабочих нагрузок Slurm.

Наследуется от: ClusterResolver

Просмотреть псевдонимы

Псевдонимы совместимости для миграции

Подробнее см. в руководстве по миграции.

tf.compat.v1.distribute.cluster_resolver.SlurmClusterResolver

tf.distribute.cluster_resolver.SlurmClusterResolver(
    jobs=None,
    port_base=8888,
    gpus_per_node=None,
    gpus_per_task=None,
    tasks_per_node=None,
    auto_set_gpu=True,
    rpc_layer='grpc'
)

Это реализация ClusterResolver для кластеров Slurm. Она позволяет задавать задания и количество задач, количество задач на узел, количество графических процессоров на каждом узле и количество графических процессоров для каждой задачи. Реализация получает атрибуты системы из переменных окружения Slurm, определяет имена выделенных вычислительных узлов, создает кластер и возвращает объект ClusterResolver, который можно использовать для распределенного выполнения TensorFlow.

Аргументы
jobs Словарь, в котором ключами являются имена заданий, а значениями — количество задач в задании. По умолчанию используется столько задач «worker», сколько заданий Slurm.
port_base Первый номер порта, который будет использоваться для процессов на узле.
gpus_per_node Количество графических процессоров, доступных на каждом узле. По умолчанию используется количество графических процессоров, сообщаемое nvidia-smi.
gpus_per_task Количество графических процессоров, используемых для каждой задачи. По умолчанию gpus_per_node равномерно распределяется между задачами tasks_per_node.
tasks_per_node Количество задач, выполняемых на каждом узле. Может быть целым числом, если количество задач на узел постоянно, или словарем, сопоставляющим имена узлов с количеством задач на каждом из них. Если значение не задано, нужные данные запрашиваются из окружения Slurm.
auto_set_gpu Автоматически задавать видимые устройства CUDA при определении кластера, устанавливая переменную окружения CUDA_VISIBLE_DEVICES. По умолчанию — True.
rpc_layer Протокол, используемый TensorFlow для взаимодействия между узлами. По умолчанию — 'grpc'.
Исключения
RuntimeError Если запрошено больше графических процессоров на узел, чем доступно, или запрошено больше задач, чем назначено, либо не удалось получить отсутствующие значения из окружения.
Атрибуты
environment Возвращает текущее окружение, в котором работает TensorFlow.

Возможны два значения: «google» (если TensorFlow работает во внутреннем окружении Google) или пустая строка (если TensorFlow работает в другом месте).

Если вы реализуете ClusterResolver, работающий как в окружении Google, так и в мире ПО с открытым исходным кодом (например, ClusterResolver для TPU или аналогичный), необходимо возвращать соответствующую строку в зависимости от окружения, которое вам потребуется определить.

В противном случае, если вы реализуете ClusterResolver, предназначенный только для TensorFlow с открытым исходным кодом, реализовывать это свойство не нужно.

task_id Возвращает идентификатор задачи, обозначенной этим ClusterResolver.

В распределенной среде TensorFlow для каждого задания может быть задан идентификатор задачи — индекс экземпляра среди задач данного типа. Это полезно, когда пользователю нужно выполнять определенный код в зависимости от индекса задачи. Например:

cluster_spec = tf.train.ClusterSpec({
    "ps": ["localhost:2222", "localhost:2223"],
    "worker": ["localhost:2224", "localhost:2225", "localhost:2226"]
})

# SimpleClusterResolver is used here for illustration; other cluster
# resolvers may be used for other source of task type/id.
simple_resolver = SimpleClusterResolver(cluster_spec, task_type="worker",
                                        task_id=0)

...

if cluster_resolver.task_type == 'worker' and cluster_resolver.task_id == 0:
  # Perform something that's only applicable on 'worker' type, id 0. This
  # block will run on this particular instance since we've specified this
  # task to be a 'worker', id 0 in above cluster resolver.
else:
  # Perform something that's only applicable on other ids. This block will
  # not run on this particular instance.

Возвращает None, если такие сведения недоступны или неприменимы в текущей распределенной среде, например при обучении с помощью tf.distribute.cluster_resolver.TPUClusterResolver.

Дополнительные сведения см. в строке документации класса tf.distribute.cluster_resolver.ClusterResolver.

task_type Возвращает тип задачи, обозначенной этим ClusterResolver.

В распределенной среде TensorFlow для каждого задания может быть задан тип задачи. Допустимые типы задач в TensorFlow: 'chief' — рабочий процесс с дополнительными обязанностями, 'worker' — обычный рабочий процесс для обучения или оценки, 'ps' — сервер параметров, 'evaluator' — процесс оценки контрольных точек по метрикам.

Подробнее о типах задач 'chief' и 'worker', которые используются чаще всего, см. в разделе Конфигурация нескольких рабочих процессов.

Доступ к таким сведениям полезен, когда пользователю нужно выполнять определенный код в зависимости от типа задачи. Например:

cluster_spec = tf.train.ClusterSpec({
    "ps": ["localhost:2222", "localhost:2223"],
    "worker": ["localhost:2224", "localhost:2225", "localhost:2226"]
})

# SimpleClusterResolver is used here for illustration; other cluster
# resolvers may be used for other source of task type/id.
simple_resolver = SimpleClusterResolver(cluster_spec, task_type="worker",
                                        task_id=1)

...

if cluster_resolver.task_type == 'worker':
  # Perform something that's only applicable on workers. This block
  # will run on this particular instance since we've specified this task to
  # be a worker in above cluster resolver.
elif cluster_resolver.task_type == 'ps':
  # Perform something that's only applicable on parameter servers. This
  # block will not run on this particular instance.

Возвращает None, если такие сведения недоступны или неприменимы в текущей распределенной среде, например при обучении с помощью tf.distribute.experimental.TPUStrategy.

Дополнительные сведения см. в документации класса tf.distribute.cluster_resolver.ClusterResolver.

Методы

cluster_spec

Просмотреть исходный код

cluster_spec()

Возвращает объект ClusterSpec на основе последних сведений о группе экземпляров.

Возвращает объект ClusterSpec для использования на основе сведений из указанных параметров инициализации и переменных окружения Slurm. Спецификация кластера определяется заново при каждом вызове этой функции. Резолвер извлекает имена узлов с помощью scontrol и распределяет задачи в этом порядке, пока на узле не будет задано указанное количество задач. Графические процессоры на узлах распределяются между задачами согласно спецификации путем установки переменной окружения CUDA_VISIBLE_DEVICES.

Возвращает
Объект ClusterSpec, содержащий сведения об узлах, полученные из переменных окружения Slurm.

get_task_info

Просмотреть исходный код

get_task_info()

Возвращает имя задания и task_id для вызывающего процесс.

Возвращает имя задания и индекс задачи для процесса, вызывающего эту функцию, в соответствии с его рангом и спецификацией кластера. Имя задания и индекс задачи задаются после создания кластера с помощью cluster_spec; в противном случае они по умолчанию равны None.

Возвращает
Строку с именем задания, к которому относится процесс, и целое число с индексом задачи этого процесса в задании.

master

Просмотреть исходный код

master(
    task_type=None, task_id=None, rpc_layer=None
)

Возвращает строку master для подключения к главному узлу TensorFlow.

Аргументы
task_type (Необязательно) Переопределяет автоматически выбранный тип задачи по умолчанию.
task_id (Необязательно) Переопределяет автоматически выбранный индекс задачи по умолчанию.
rpc_layer (Необязательно) Переопределяет протокол RPC по умолчанию, используемый TensorFlow для взаимодействия между узлами.
Возвращает
Строку подключения к главному узлу TensorFlow.

num_accelerators

Просмотреть исходный код

num_accelerators(
    task_type=None, task_id=None, config_proto=None
)

Возвращает количество ядер ускорителей на рабочий процесс.

Возвращает количество доступных каждому рабочему процессу ядер ускорителей (например, GPU и TPU).

При необходимости вызывающие стороны могут указать task_type и task_id, чтобы запросить количество ускорителей для конкретной задачи TensorFlow. Это поддерживает неоднородные среды, в которых количество ядер ускорителей на узел различается.

Аргументы
task_type (Необязательно) Тип задачи TensorFlow на машине, для которой требуется выполнить запрос.
task_id (Необязательно) Индекс задачи TensorFlow на машине, для которой требуется выполнить запрос.
config_proto (Необязательно) Конфигурация для запуска нового сеанса и запроса количества имеющихся ядер ускорителей.
Возвращает
Сопоставление типов ускорителей с количеством ядер.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/distribute/cluster_resolver/SlurmClusterResolver

Spec-Zone.ru

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