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 dans votre organisation ou un serveur local, à condition que la ressource soit accessible à Azure Machine Learning. Pour plus d’informations, consultez Qu’est-ce qu’une cible 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. Renvoie une instance d’une classe enfant correspondant au type spécifique de l’objet Compute récupéré.
- Héritage
-
RemoteCompute
Constructeur
RemoteCompute(workspace, name)
Paramètres
- workspace
- Workspace
Objet de l’espace de travail contenant l’objet RemoteCompute à récupérer.
- workspace
- Workspace
Objet de l’espace de travail contenant l’objet de calcul à récupérer.
Remarques
Les régions Azure suivantes ne prennent pas en charge l’utilisation de l’adresse IP publique d’un ordinateur virtuel 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 du cluster peut être construit avec ce format : /subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>.
L’exemple suivant montre comment créer et attacher une Data Science Virtual Machine (DSVM) 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)
Un exemple complet est disponible sur https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb
Méthodes
attach |
DÉPRÉCIÉ. Utilisez plutôt la méthode Associe une ressource de calcul distante existante à l’espace de travail fourni. |
attach_configuration |
Crée un objet de configuration pour joindre une cible de calcul Batch. 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 la machine virtuelle. L’ID de ressource du cluster peut être construit avec ce format : « /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 de 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 |
Convertit un objet JSON en objet RemoteCompute. |
detach |
Détache 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ère les informations d’identification pour la cible RemoteCompute. |
refresh_state |
Effectue 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. Elle est principalement utilisée pour l’interrogation manuelle de l’état de calcul. |
serialize |
Convertit cet objet RemoteCompute en dictionnaire JSON sérialisé. |
attach
DÉPRÉCIÉ. Utilisez plutôt la méthode attach_configuration
.
Associe 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
- workspace
- Workspace
Objet d’espace de travail avec lequel associer la ressource de calcul.
- name
- str
Nom à associer à la ressource de calcul dans l’espace de travail fourni. Ne doit pas nécessairement correspondre au nom de la ressource de calcul à joindre.
- private_key_file
- str
Chemin d’accès à un fichier contenant la clé privée pour la ressource.
Retours
Représentation sous forme d’objet RemoteCompute de l’objet de calcul.
Type de retour
Exceptions
attach_configuration
Crée un objet de configuration pour joindre une cible de calcul Batch.
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 la machine virtuelle. L’ID de ressource du cluster peut être construit avec ce format : « /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 de 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
- subscription_id
- str
ID d’abonnement Azure dans lequel se trouve la machine virtuelle.
- resource_group
- str
Nom du groupe de ressources dans lequel se trouve l’ordinateur virtuel.
- resource_id
- str
ID de ressource Azure Resource Manager (ARM) pour la ressource existante.
- private_key_file
- str
Chemin d’accès à un fichier contenant la clé privée pour la ressource.
Retours
Objet de configuration à utiliser quand un objet de calcul est joint.
Type de retour
Exceptions
delete
La suppression n’est pas prise en charge pour un objet RemoteCompute. Utilisez detach à la place.
delete()
Exceptions
deserialize
Convertit un objet JSON en objet RemoteCompute.
static deserialize(workspace, object_dict)
Paramètres
- workspace
- Workspace
Objet de l’espace de travail auquel l’objet RemoteCompute est associé.
Retours
Représentation RemoteCompute de l’objet JSON fourni.
Type de retour
Exceptions
Remarques
Lève une ComputeTargetException si l’espace de travail fourni n’est pas l’espace de travail associé au calcul.
detach
Détache 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
get_credentials
Récupère les informations d’identification pour la cible RemoteCompute.
get_credentials()
Retours
Informations d’identification pour la cible RemoteCompute.
Type de retour
Exceptions
refresh_state
Effectue 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. Elle est principalement utilisée pour l’interrogation manuelle de l’état de calcul.
refresh_state()
Exceptions
serialize
Convertit cet objet RemoteCompute en dictionnaire JSON sérialisé.
serialize()
Retours
Représentation JSON de cet objet RemoteCompute.
Type de retour
Exceptions
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour