Delen via

RemoteCompute Klas

  • Referentie

Hiermee beheert u een extern rekendoel voor gebruik in Azure Machine Learning.

Azure Machine Learning ondersteunt het koppelen van een externe rekenresource aan uw werkruimte. De externe resource kan een Azure-VM, een externe server in uw organisatie of on-premises zijn, zolang de resource maar toegankelijk is voor Azure Machine Learning. Zie Wat zijn rekendoelen in Azure Machine Learning? voor meer informatie.

Klasse ComputeTarget-constructor.

Haal een cloudweergave op van een compute-object dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde Compute-object.

Overname
ComputeTarget
RemoteCompute

Constructor

RemoteCompute(workspace, name)

Parameters

Name Description
workspace
Vereist
Workspace

Het werkruimteobject met het remotecompute-object dat moet worden opgehaald.
name
Vereist
str

De naam van de van het RemoteCompute-object dat moet worden opgehaald.
workspace
Vereist
Workspace

Het werkruimteobject met het rekenobject dat moet worden opgehaald.
name
Vereist
str

De naam van het rekenobject dat moet worden opgehaald.

Opmerkingen

De volgende Azure-regio's bieden geen ondersteuning voor het gebruik van het openbare IP-adres van een virtuele machine of HDInsight-cluster om het rekendoel te koppelen.

  • US - oost

  • US - west 2

  • US - zuid-centraal

Gebruik in plaats daarvan de Azure Resource Manager-id van de VM of het HDInsight-cluster. De resource-id van de VM kan worden samengesteld met behulp van de abonnements-id, de naam van de resourcegroep en de naam van de VM met de volgende tekenreeksindeling: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

In het volgende voorbeeld ziet u hoe u een Data Science Virtual Machine (DSVM) maakt en koppelt als een rekendoel.


   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)

Het volledige voorbeeld is beschikbaar via https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Methoden

attach

AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode.

Koppel een bestaande externe rekenresource aan de opgegeven werkruimte.
attach_configuration

Maak een configuratieobject voor het koppelen van een extern rekendoel.

Het koppelen van een virtuele machine met behulp van het openbare IP-adres van de VM wordt niet meer ondersteund. Gebruik in plaats daarvan de resourceId van de VM. De resourceId van de VM kan worden samengesteld met behulp van de volgende tekenreeksindeling: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

U kunt ook subscription_id, resource_group en vm_name gebruiken zonder resourceId te maken. Voor meer informatie raadpleegt u https://aka.ms/azureml-compute-vm.
delete

Verwijderen wordt niet ondersteund voor een RemoteCompute-object. Gebruik in plaats daarvan detach.
deserialize

Converteer een JSON-object naar een RemoteCompute-object.
detach

Koppel het RemoteCompute-object los van de bijbehorende werkruimte.

Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.
get_credentials

Haal de referenties voor het RemoteCompute-doel op.
refresh_state

Voer een in-place update van de eigenschappen van het object uit.

Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.
serialize

Converteer dit RemoteCompute-object naar een geserialiseerde JSON-woordenlijst.

attach

AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode.

Koppel een bestaande externe rekenresource aan de opgegeven werkruimte.

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

Parameters

Name Description
workspace
Vereist
Workspace

Het werkruimteobject waaraan de rekenresource moet worden gekoppeld.
name
Vereist
str

De naam die moet worden gekoppeld aan de rekenresource in de opgegeven werkruimte. Hoeft niet overeen te komen met de naam van de rekenresource die moet worden gekoppeld.
username
Vereist
str

De gebruikersnaam die nodig is voor toegang tot de resource.
address
Vereist
str

Het adres van de resource die moet worden gekoppeld.
ssh_port
int

De weergegeven poort voor de resource. De standaardwaarde is 22.

Default value: 22
password
Vereist
str

Het wachtwoord dat nodig is voor toegang tot de resource.
private_key_file
Vereist
str

Pad naar een bestand met de persoonlijke sleutel voor de resource.
private_key_passphrase
Vereist
str

Persoonlijke sleutelzin die nodig is voor toegang tot de resource.

Retouren

Type Description
RemoteCompute

Een RemoteCompute-objectweergave van het rekenobject.

Uitzonderingen

Type Description
ComputeTargetException

attach_configuration

Maak een configuratieobject voor het koppelen van een extern rekendoel.

Het koppelen van een virtuele machine met behulp van het openbare IP-adres van de VM wordt niet meer ondersteund. Gebruik in plaats daarvan de resourceId van de VM. De resourceId van de VM kan worden samengesteld met behulp van de volgende tekenreeksindeling: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

U kunt ook subscription_id, resource_group en vm_name gebruiken zonder resourceId te maken. Voor meer informatie raadpleegt u 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='')

Parameters

Name Description
username
Vereist
str

De gebruikersnaam die nodig is voor toegang tot de resource.
subscription_id
str

De Azure-abonnements-id waarin de virtuele machine zich bevindt.

Default value: None
resource_group
str

De naam van de resourcegroep waarin de virtuele machine zich bevindt.

Default value: None
vm_name
str

De naam van de virtuele machine.

Default value: None
resource_id
str

De ARM-resource-id (Azure Resource Manager) voor de bestaande resource.

Default value: None
address
str

Het adres voor de bestaande resource.

Default value: None
ssh_port
int

De weergegeven poort voor de resource. De standaardwaarde is 22.

Default value: 22
password
Vereist
str

Het wachtwoord dat nodig is voor toegang tot de resource.
private_key_file
Vereist
str

Pad naar een bestand met de persoonlijke sleutel voor de resource.
private_key_passphrase
Vereist
str

De woordgroep met de persoonlijke sleutel die nodig is voor toegang tot de resource.

Retouren

Type Description
RemoteComputeAttachConfiguration

Een configuratieobject dat moet worden gebruikt bij het koppelen van een compute-object.

Uitzonderingen

Type Description
ComputeTargetException

delete

Verwijderen wordt niet ondersteund voor een RemoteCompute-object. Gebruik in plaats daarvan detach.

delete()

Uitzonderingen

Type Description
ComputeTargetException

deserialize

Converteer een JSON-object naar een RemoteCompute-object.

static deserialize(workspace, object_dict)

Parameters

Name Description
workspace
Vereist
Workspace

Het werkruimteobject waar het RemoteCompute-object aan is gekoppeld.
object_dict
Vereist
dict

Een JSON-object dat moet worden geconverteerd naar een RemoteCompute-object.

Retouren

Type Description
RemoteCompute

De RemoteCompute-weergave van het opgegeven JSON-object.

Uitzonderingen

Type Description
ComputeTargetException

Opmerkingen

Genereert een ComputeTargetException als de opgegeven werkruimte niet de werkruimte is waar de compute aan is gekoppeld.

detach

Koppel het RemoteCompute-object los van de bijbehorende werkruimte.

Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.

detach()

Uitzonderingen

Type Description
ComputeTargetException

get_credentials

Haal de referenties voor het RemoteCompute-doel op.

get_credentials()

Retouren

Type Description
dict

De referenties voor het RemoteCompute-doel.

Uitzonderingen

Type Description
ComputeTargetException

refresh_state

Voer een in-place update van de eigenschappen van het object uit.

Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.

refresh_state()

Uitzonderingen

Type Description
ComputeTargetException

serialize

Converteer dit RemoteCompute-object naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type Description
dict

De JSON-weergave van dit RemoteCompute-object.

Uitzonderingen

Type Description
ComputeTargetException