Partager via

RemoteCompute Classe

Gère une cible de calcul distante à utiliser dans Azure Machine Learning.

Azure Machine Learning prend en charge l’attachement d’une ressource de calcul distante à votre espace de travail. La ressource distante peut être une machine virtuelle Azure, un serveur distant de votre organisation ou localement, tant que la ressource est accessible à Azure Machine Learning. Pour plus d’informations, consultez Quelles sont les cibles de calcul dans Azure Machine Learning ?

Constructeur ComputeTarget de classe.

Récupérez une représentation cloud d’un objet Compute associé à l’espace de travail fourni. Retourne une instance d’une classe enfant correspondant au type spécifique de l’objet Compute récupéré.

Constructeur

RemoteCompute(workspace, name)

Paramètres

Nom Description
workspace
Obligatoire
Workspace

Objet d’espace de travail contenant l’objet RemoteCompute à récupérer.
name
Obligatoire
str

Nom de l’objet RemoteCompute à récupérer.
workspace
Obligatoire
Workspace

Objet d’espace de travail contenant l’objet Compute à récupérer.
name
Obligatoire
str

Nom de l’objet Compute à récupérer.

Remarques

Les régions Azure suivantes ne prennent pas en charge l’utilisation de l’adresse IP publique d’une machine virtuelle ou d’un cluster HDInsight pour attacher la cible de calcul.

  • USA Est

  • USA Ouest 2

  • USA Centre Sud

Utilisez plutôt l’ID Azure Resource Manager de la machine virtuelle ou du cluster HDInsight. L’ID de ressource de la machine virtuelle peut être construit à l’aide de l’ID d’abonnement, du nom du groupe de ressources et du nom de la machine virtuelle au format de chaîne suivant : /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

L’exemple suivant montre comment créer et attacher une machine virtuelle DSVM (Data Science Virtual Machine) en tant que cible de calcul.


   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)

L’exemple complet est disponible à partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Méthodes

attach

OBSOLESCENT. Utilisez plutôt la attach_configuration méthode.

Associez une ressource de calcul distante existante à l’espace de travail fourni.
attach_configuration

Créez un objet de configuration pour attacher une cible de calcul distante.

L’attachement d’une machine virtuelle à l’aide de l’adresse IP publique de la machine virtuelle n’est plus pris en charge. Utilisez plutôt l’ID de ressource de la machine virtuelle. L’ID de ressource de la machine virtuelle peut être construit à l’aide du format de chaîne suivant : « /subscriptions/<subscription_id/resourceGroups/>resource_group</ providers/Microsoft.Compute/virtualMachines/>vm_name<> ».

Vous pouvez également utiliser subscription_id, resource_group et vm_name sans construire resourceId. Pour plus d’informations, consultez https://aka.ms/azureml-compute-vm.
delete

La suppression n’est pas prise en charge pour un objet RemoteCompute. Utilisez detach à la place.
deserialize

Convertissez un objet JSON en objet RemoteCompute.
detach

Détachez l’objet RemoteCompute de son espace de travail associé.

Les objets cloud sous-jacents ne sont pas supprimés, seule l’association est supprimée.
get_credentials

Récupérez les informations d’identification de la cible RemoteCompute.
refresh_state

Effectuez une mise à jour sur place des propriétés de l’objet.

Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Ceci est principalement utilisé pour l’interrogation manuelle de l’état de calcul.
serialize

Convertissez cet objet RemoteCompute en dictionnaire sérialisé JSON.

attach

OBSOLESCENT. Utilisez plutôt la attach_configuration méthode.

Associez une ressource de calcul distante existante à l’espace de travail fourni.

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

Paramètres

Nom Description
workspace
Obligatoire
Workspace

Objet d’espace de travail auquel associer la ressource de calcul.
name
Obligatoire
str

Nom à associer à la ressource de calcul à l’intérieur de l’espace de travail fourni. Ne doit pas correspondre au nom de la ressource de calcul à joindre.
username
Obligatoire
str

Nom d’utilisateur nécessaire pour accéder à la ressource.
address
Obligatoire
str

Adresse de la ressource à joindre.
ssh_port
int

Port exposé pour la ressource. La valeur par défaut est 22.

Valeur par défaut: 22
password
Obligatoire
str

Mot de passe nécessaire pour accéder à la ressource.
private_key_file
Obligatoire
str

Chemin d’accès à un fichier contenant la clé privée de la ressource.
private_key_passphrase
Obligatoire
str

Expression de clé privée nécessaire pour accéder à la ressource.

Retours

Type Description
RemoteCompute

Représentation d’objet RemoteCompute de l’objet de calcul.

Exceptions

Type Description
ComputeTargetException

attach_configuration

Créez un objet de configuration pour attacher une cible de calcul distante.

L’attachement d’une machine virtuelle à l’aide de l’adresse IP publique de la machine virtuelle n’est plus pris en charge. Utilisez plutôt l’ID de ressource de la machine virtuelle. L’ID de ressource de la machine virtuelle peut être construit à l’aide du format de chaîne suivant : « /subscriptions/<subscription_id/resourceGroups/>resource_group</ providers/Microsoft.Compute/virtualMachines/>vm_name<> ».

Vous pouvez également utiliser subscription_id, resource_group et vm_name sans construire resourceId. Pour plus d’informations, consultez 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='')

Paramètres

Nom Description
username
Obligatoire
str

Nom d’utilisateur nécessaire pour accéder à la ressource.
subscription_id
str

ID d’abonnement Azure dans lequel se trouve la machine virtuelle.

Valeur par défaut: None
resource_group
str

Nom du groupe de ressources dans lequel se trouve la machine virtuelle.

Valeur par défaut: None
vm_name
str

Nom de la machine virtuelle.

Valeur par défaut: None
resource_id
str

ID de ressource Azure Resource Manager (ARM) pour la ressource existante.

Valeur par défaut: None
address
str

Adresse de la ressource existante.

Valeur par défaut: None
ssh_port
int

Port exposé pour la ressource. La valeur par défaut est 22.

Valeur par défaut: 22
password
Obligatoire
str

Mot de passe nécessaire pour accéder à la ressource.
private_key_file
Obligatoire
str

Chemin d’accès à un fichier contenant la clé privée de la ressource.
private_key_passphrase
Obligatoire
str

Expression de clé privée nécessaire pour accéder à la ressource.

Retours

Type Description
RemoteComputeAttachConfiguration

Objet de configuration à utiliser lors de l’attachement d’un objet Compute.

delete

La suppression n’est pas prise en charge pour un objet RemoteCompute. Utilisez detach à la place.

delete()

Exceptions

Type Description
ComputeTargetException

deserialize

Convertissez un objet JSON en objet RemoteCompute.

static deserialize(workspace, object_dict)

Paramètres

Nom Description
workspace
Obligatoire
Workspace

L’objet d’espace de travail auquel l’objet RemoteCompute est associé.
object_dict
Obligatoire
dict

Objet JSON à convertir en objet RemoteCompute.

Retours

Type Description
RemoteCompute

Représentation RemoteCompute de l’objet JSON fourni.

Exceptions

Type Description
ComputeTargetException

Remarques

Déclenche une ComputeTargetException opération si l’espace de travail fourni n’est pas l’espace de travail associé au calcul.

detach

Détachez l’objet RemoteCompute de son espace de travail associé.

Les objets cloud sous-jacents ne sont pas supprimés, seule l’association est supprimée.

detach()

Exceptions

Type Description
ComputeTargetException

get_credentials

Récupérez les informations d’identification de la cible RemoteCompute.

get_credentials()

Retours

Type Description
dict

Informations d’identification de la cible RemoteCompute.

Exceptions

Type Description
ComputeTargetException

refresh_state

Effectuez une mise à jour sur place des propriétés de l’objet.

Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Ceci est principalement utilisé pour l’interrogation manuelle de l’état de calcul.

refresh_state()

serialize

Convertissez cet objet RemoteCompute en dictionnaire sérialisé JSON.

serialize()

Retours

Type Description
dict

Représentation JSON de cet objet RemoteCompute.