Поделиться через

RemoteCompute Класс

Управляет удаленным целевым объектом вычислений для использования в Машинном обучении Azure.

Машинное обучение Azure поддерживает подключение удаленного вычислительного ресурса к рабочей области. Удаленный ресурс может быть виртуальной машиной Azure, удаленным сервером в организации или локальной средой, если ресурс доступен машинному обучению Azure. Дополнительные сведения см. в статье "Что такое целевые объекты вычислений в Машинном обучении Azure"?

Конструктор ComputeTarget класса.

Получение облачного представления объекта Вычислений, связанного с предоставленной рабочей областью. Возвращает экземпляр дочернего класса, соответствующего конкретному типу извлеченного вычислительного объекта.

Конструктор

RemoteCompute(workspace, name)

Параметры

Имя Описание
workspace
Обязательно
Workspace

Объект рабочей области, содержащий объект RemoteCompute для извлечения.
name
Обязательно
str

Имя извлекаемого объекта RemoteCompute.
workspace
Обязательно
Workspace

Объект рабочей области, содержащий объект Compute для извлечения.
name
Обязательно
str

Имя извлекаемого объекта Вычислений.

Комментарии

Следующие регионы Azure не поддерживают использование общедоступного IP-адреса виртуальной машины или кластера HDInsight для подключения целевого объекта вычислений.

  • Восточная часть США

  • Западная часть США 2

  • Южная часть США

Вместо этого используйте идентификатор Azure Resource Manager для виртуальной машины или кластера HDInsight. Идентификатор ресурса виртуальной машины можно создать с помощью идентификатора подписки, имени группы ресурсов и имени виртуальной машины, используя следующий строковый формат: /subscriptions/subscription_id/resourceGroups/<resource_group></providers/Microsoft.Compute/virtualMachines/>vm_name<.>

В следующем примере показано, как создать и подключить виртуальную машину для обработки и анализа данных (DSVM) в качестве целевого объекта вычислений.


   from azureml.core.compute import ComputeTarget, RemoteCompute
   from azureml.core.compute_target import ComputeTargetException

   username = os.getenv('AZUREML_DSVM_USERNAME', default='<my_username>')
   address = os.getenv('AZUREML_DSVM_ADDRESS', default='<ip_address_or_fqdn>')

   compute_target_name = 'cpudsvm'
   # if you want to connect using SSH key instead of username/password you can provide parameters private_key_file and private_key_passphrase
   try:
       attached_dsvm_compute = RemoteCompute(workspace=ws, name=compute_target_name)
       print('found existing:', attached_dsvm_compute.name)
   except ComputeTargetException:
       attach_config = RemoteCompute.attach_configuration(address=address,
                                                          ssh_port=22,
                                                          username=username,
                                                          private_key_file='./.ssh/id_rsa')


   # Attaching a virtual machine using the public IP address of the VM is no longer supported.
   # Instead, use resourceId of the VM.
   # The resourceId of the VM can be constructed using the following string format:
   # /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.
   # You can also use subscription_id, resource_group and vm_name without constructing resourceId.
       attach_config = RemoteCompute.attach_configuration(resource_id='<resource_id>',
                                                          ssh_port=22,
                                                          username='username',
                                                          private_key_file='./.ssh/id_rsa')

       attached_dsvm_compute = ComputeTarget.attach(ws, compute_target_name, attach_config)

       attached_dsvm_compute.wait_for_completion(show_output=True)

Полный пример доступен из https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Методы

attach

УСТАРЕВШИЕ. attach_configuration Вместо этого используйте метод.

Свяжите существующий удаленный вычислительный ресурс с предоставленной рабочей областью.
attach_configuration

Создайте объект конфигурации для подключения удаленного целевого объекта вычислений.

Подключение виртуальной машины с помощью общедоступного IP-адреса виртуальной машины больше не поддерживается. Вместо этого используйте resourceId виртуальной машины. Идентификатор ресурса виртуальной машины можно создать с помощью следующего строкового формата: "/subscriptions/<subscription_id/resourceGroups/>resource_group<>/providers/Microsoft.Compute/virtualMachines/<vm_name>".

Вы также можете использовать subscription_id, resource_group и vm_name без создания resourceId. Дополнительные сведения см. в разделе https://aka.ms/azureml-compute-vm.
delete

Удаление не поддерживается для объекта RemoteCompute. Вместо этого используйте detach.
deserialize

Преобразуйте объект JSON в объект RemoteCompute.
detach

Отсоедините объект RemoteCompute от связанной рабочей области.

Базовые облачные объекты не удаляются, только связь удаляется.
get_credentials

Получение учетных данных для целевого объекта RemoteCompute.
refresh_state

Выполните обновление на месте свойств объекта.

Этот метод обновляет свойства на основе текущего состояния соответствующего облачного объекта. Это в основном используется для ручного опроса состояния вычислений.
serialize

Преобразуйте этот объект RemoteCompute в сериализованный словарь JSON.

attach

УСТАРЕВШИЕ. attach_configuration Вместо этого используйте метод.

Свяжите существующий удаленный вычислительный ресурс с предоставленной рабочей областью.

static attach(workspace, name, username, address, ssh_port=22, password='', private_key_file='', private_key_passphrase='')

Параметры

Имя Описание
workspace
Обязательно
Workspace

Объект рабочей области для связывания вычислительного ресурса с.
name
Обязательно
str

Имя для связывания с вычислительным ресурсом в предоставленной рабочей области. Не обязательно соответствовать имени присоединенного вычислительного ресурса.
username
Обязательно
str

Имя пользователя, необходимое для доступа к ресурсу.
address
Обязательно
str

Адрес присоединенного ресурса.
ssh_port
int

Предоставленный порт для ресурса. Значение по умолчанию — 22.

Default value: 22
password
Обязательно
str

Пароль, необходимый для доступа к ресурсу.
private_key_file
Обязательно
str

Путь к файлу с закрытым ключом ресурса.
private_key_passphrase
Обязательно
str

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

Возвращаемое значение

Тип Описание
RemoteCompute

Представление объекта RemoteCompute вычислительного объекта.

Исключения

Тип Описание
ComputeTargetException

attach_configuration

Создайте объект конфигурации для подключения удаленного целевого объекта вычислений.

Подключение виртуальной машины с помощью общедоступного IP-адреса виртуальной машины больше не поддерживается. Вместо этого используйте resourceId виртуальной машины. Идентификатор ресурса виртуальной машины можно создать с помощью следующего строкового формата: "/subscriptions/<subscription_id/resourceGroups/>resource_group<>/providers/Microsoft.Compute/virtualMachines/<vm_name>".

Вы также можете использовать subscription_id, resource_group и vm_name без создания resourceId. Дополнительные сведения см. в разделе https://aka.ms/azureml-compute-vm.

static attach_configuration(username, subscription_id=None, resource_group=None, vm_name=None, resource_id=None, address=None, ssh_port=22, password='', private_key_file='', private_key_passphrase='')

Параметры

Имя Описание
username
Обязательно
str

Имя пользователя, необходимое для доступа к ресурсу.
subscription_id
str

Идентификатор подписки Azure, в которой находится виртуальная машина.

Default value: None
resource_group
str

Имя группы ресурсов, в которой находится виртуальная машина.

Default value: None
vm_name
str

Имя виртуальной машины.

Default value: None
resource_id
str

Идентификатор ресурса Azure Resource Manager (ARM) для существующего ресурса.

Default value: None
address
str

Адрес существующего ресурса.

Default value: None
ssh_port
int

Предоставленный порт для ресурса. Значение по умолчанию — 22.

Default value: 22
password
Обязательно
str

Пароль, необходимый для доступа к ресурсу.
private_key_file
Обязательно
str

Путь к файлу с закрытым ключом ресурса.
private_key_passphrase
Обязательно
str

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

Возвращаемое значение

Тип Описание
RemoteComputeAttachConfiguration

Объект конфигурации, используемый при присоединении вычислительного объекта.

delete

Удаление не поддерживается для объекта RemoteCompute. Вместо этого используйте detach.

delete()

Исключения

Тип Описание
ComputeTargetException

deserialize

Преобразуйте объект JSON в объект RemoteCompute.

static deserialize(workspace, object_dict)

Параметры

Имя Описание
workspace
Обязательно
Workspace

Объект рабочей области, с которым связан объект RemoteCompute.
object_dict
Обязательно
dict

Объект JSON для преобразования в объект RemoteCompute.

Возвращаемое значение

Тип Описание
RemoteCompute

Представление предоставленного объекта JSON remoteCompute.

Исключения

Тип Описание
ComputeTargetException

Комментарии

Вызывает, ComputeTargetException если указанная рабочая область не является рабочей областью, с которым связана вычисление.

detach

Отсоедините объект RemoteCompute от связанной рабочей области.

Базовые облачные объекты не удаляются, только связь удаляется.

detach()

Исключения

Тип Описание
ComputeTargetException

get_credentials

Получение учетных данных для целевого объекта RemoteCompute.

get_credentials()

Возвращаемое значение

Тип Описание
dict

Учетные данные для целевого объекта RemoteCompute.

Исключения

Тип Описание
ComputeTargetException

refresh_state

Выполните обновление на месте свойств объекта.

Этот метод обновляет свойства на основе текущего состояния соответствующего облачного объекта. Это в основном используется для ручного опроса состояния вычислений.

refresh_state()

serialize

Преобразуйте этот объект RemoteCompute в сериализованный словарь JSON.

serialize()

Возвращаемое значение

Тип Описание
dict

Представление JSON этого объекта RemoteCompute.