Condividi tramite

RemoteCompute Classe

  • Riferimento

Gestisce una destinazione di calcolo remota da usare in Azure Machine Learning.

Azure Machine Learning supporta l'uso del collegamento di una risorsa di calcolo remota all'area di lavoro. La risorsa remota può essere una macchina virtuale di Azure, un server remoto nell'organizzazione o in locale, purché la risorsa sia accessibile ad Azure Machine Learning. Per altre informazioni, vedere Informazioni sulle destinazioni di calcolo in Azure Machine Learning?

Costruttore ComputeTarget di classe.

Recuperare una rappresentazione cloud di un oggetto Compute associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Compute recuperato.

Ereditarietà
ComputeTarget
RemoteCompute

Costruttore

RemoteCompute(workspace, name)

Parametri

workspace
Workspace
Necessario

Oggetto area di lavoro contenente l'oggetto RemoteCompute da recuperare.

name
str
Necessario

Nome dell'oggetto RemoteCompute da recuperare.

workspace
Workspace
Necessario

Oggetto dell'area di lavoro contenente l'oggetto Compute da recuperare.

name
str
Necessario

Nome dell'oggetto Compute da recuperare.

Commenti

Le aree di Azure seguenti non supportano l'uso dell'indirizzo IP pubblico di una macchina virtuale o di un cluster HDInsight per collegare la destinazione di calcolo.

  • Stati Uniti orientali

  • Stati Uniti occidentali 2

  • Stati Uniti centro-meridionali

Usare invece l'ID di Azure Resource Manager del cluster VM o HDInsight. L'ID risorsa della macchina virtuale può essere costruito usando l'ID sottoscrizione, il nome del gruppo di risorse e il nome della macchina virtuale usando il formato stringa seguente: /subscriptions/<subscription_id/resourceGroups</resource_group>>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

Nell'esempio seguente viene illustrato come creare e collegare un Data Science Virtual Machine (DSVM) come destinazione di calcolo.


   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'esempio completo è disponibile da https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Metodi

attach

DEPRECATO. Al suo posto usa il metodo attach_configuration.

Associare una risorsa di calcolo remota esistente all'area di lavoro fornita.
attach_configuration

Creare un oggetto di configurazione per collegare una destinazione di calcolo remota.

Il collegamento di una macchina virtuale usando l'indirizzo IP pubblico della macchina virtuale non è più supportato. Usare invece il resourceId della macchina virtuale. Il resourceId della macchina virtuale può essere costruito usando il formato stringa seguente: "/subscriptions/subscription_id/resourceGroups<</resource_group>>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

È anche possibile usare subscription_id, resource_group e vm_name senza costruire resourceId. Per altre informazioni, vedere https://aka.ms/azureml-compute-vm.
delete

Delete non è supportato per un oggetto RemoteCompute. Usare invece detach.
deserialize

Convertire un oggetto JSON in un oggetto RemoteCompute.
detach

Scollegare l'oggetto RemoteCompute dall'area di lavoro associata.

Gli oggetti cloud sottostanti non vengono eliminati, solo l'associazione viene rimossa.
get_credentials

Recuperare le credenziali per la destinazione RemoteCompute.
refresh_state

Eseguire un aggiornamento sul posto delle proprietà dell'oggetto.

Questo metodo aggiorna le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Viene usato principalmente per il polling manuale dello stato di calcolo.
serialize

Convertire questo oggetto RemoteCompute in un dizionario serializzato JSON.

attach

DEPRECATO. Al suo posto usa il metodo attach_configuration.

Associare una risorsa di calcolo remota esistente all'area di lavoro fornita.

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

Parametri

workspace
Workspace
Necessario

Oggetto area di lavoro con cui associare la risorsa di calcolo.

name
str
Necessario

Nome da associare alla risorsa di calcolo all'interno dell'area di lavoro specificata. Non deve corrispondere al nome della risorsa di calcolo da collegare.

username
str
Necessario

Nome utente necessario per accedere alla risorsa.

address
str
Necessario

Indirizzo della risorsa da collegare.

ssh_port
int
valore predefinito: 22

Porta esposta per la risorsa. Il valore predefinito è 22.

password
str
Necessario

Password necessaria per accedere alla risorsa.

private_key_file
str
Necessario

Percorso di un file contenente la chiave privata per la risorsa.

private_key_passphrase
str
Necessario

Frase chiave privata necessaria per accedere alla risorsa.

Restituisce

Rappresentazione dell'oggetto RemoteCompute dell'oggetto di calcolo.

Tipo restituito

RemoteCompute

Eccezioni

ComputeTargetException

attach_configuration

Creare un oggetto di configurazione per collegare una destinazione di calcolo remota.

Il collegamento di una macchina virtuale usando l'indirizzo IP pubblico della macchina virtuale non è più supportato. Usare invece il resourceId della macchina virtuale. Il resourceId della macchina virtuale può essere costruito usando il formato stringa seguente: "/subscriptions/subscription_id/resourceGroups<</resource_group>>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

È anche possibile usare subscription_id, resource_group e vm_name senza costruire resourceId. Per altre informazioni, vedere 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='')

Parametri

username
str
Necessario

Nome utente necessario per accedere alla risorsa.

subscription_id
str
valore predefinito: None

ID sottoscrizione di Azure in cui si trova la macchina virtuale.

resource_group
str
valore predefinito: None

Nome del gruppo di risorse in cui si trova la macchina virtuale.

vm_name
str
valore predefinito: None

Nome della macchina virtuale.

resource_id
str
valore predefinito: None

ID risorsa azure Resource Manager (ARM) per la risorsa esistente.

address
str
valore predefinito: None

Indirizzo della risorsa esistente.

ssh_port
int
valore predefinito: 22

Porta esposta per la risorsa. Il valore predefinito è 22.

password
str
Necessario

Password necessaria per accedere alla risorsa.

private_key_file
str
Necessario

Percorso di un file contenente la chiave privata per la risorsa.

private_key_passphrase
str
Necessario

Frase chiave privata necessaria per accedere alla risorsa.

Restituisce

Oggetto di configurazione da usare quando si collega un oggetto Compute.

Tipo restituito

RemoteComputeAttachConfiguration

Eccezioni

ComputeTargetException

delete

Delete non è supportato per un oggetto RemoteCompute. Usare invece detach.

delete()

Eccezioni

ComputeTargetException

deserialize

Convertire un oggetto JSON in un oggetto RemoteCompute.

static deserialize(workspace, object_dict)

Parametri

workspace
Workspace
Necessario

L'oggetto area di lavoro a cui è associato l'oggetto RemoteCompute.

object_dict
dict
Necessario

Oggetto JSON da convertire in un oggetto RemoteCompute.

Restituisce

Rappresentazione RemoteCompute dell'oggetto JSON specificato.

Tipo restituito

RemoteCompute

Eccezioni

ComputeTargetException

Commenti

Genera un valore ComputeTargetException se l'area di lavoro specificata non è l'area di lavoro a cui è associato il calcolo.

detach

Scollegare l'oggetto RemoteCompute dall'area di lavoro associata.

Gli oggetti cloud sottostanti non vengono eliminati, solo l'associazione viene rimossa.

detach()

Eccezioni

ComputeTargetException

get_credentials

Recuperare le credenziali per la destinazione RemoteCompute.

get_credentials()

Restituisce

Credenziali per la destinazione RemoteCompute.

Tipo restituito

dict

Eccezioni

ComputeTargetException

refresh_state

Eseguire un aggiornamento sul posto delle proprietà dell'oggetto.

Questo metodo aggiorna le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Viene usato principalmente per il polling manuale dello stato di calcolo.

refresh_state()

Eccezioni

ComputeTargetException

serialize

Convertire questo oggetto RemoteCompute in un dizionario serializzato JSON.

serialize()

Restituisce

Rappresentazione JSON di questo oggetto RemoteCompute.

Tipo restituito

dict

Eccezioni

ComputeTargetException