Dela via

RemoteCompute Klass

  • Referens

Hanterar ett fjärrberäkningsmål för användning i Azure Machine Learning.

Azure Machine Learning har stöd för att koppla en fjärrberäkningsresurs till din arbetsyta. Fjärrresursen kan vara en virtuell Azure-dator, en fjärrserver i din organisation eller lokalt, så länge resursen är tillgänglig för Azure Machine Learning. Mer information finns i Vad är beräkningsmål i Azure Machine Learning?

Class ComputeTarget-konstruktor.

Hämta en molnrepresentation av ett Compute-objekt som är associerat med den angivna arbetsytan. Returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade beräkningsobjektet.

Arv
ComputeTarget
RemoteCompute

Konstruktor

RemoteCompute(workspace, name)

Parametrar

Name Description
workspace
Obligatorisk
Workspace

Arbetsyteobjektet som innehåller remotecompute-objektet som ska hämtas.
name
Obligatorisk
str

Namnet på det RemoteCompute-objekt som ska hämtas.
workspace
Obligatorisk
Workspace

Arbetsyteobjektet som innehåller compute-objektet som ska hämtas.
name
Obligatorisk
str

Namnet på det Compute-objekt som ska hämtas.

Kommentarer

Följande Azure-regioner stöder inte användning av den offentliga IP-adressen för en virtuell dator eller HDInsight-kluster för att koppla beräkningsmålet.

  • USA, Östra

  • USA, västra 2

  • USA, södra centrala

Använd i stället Azure Resource Manager-ID för den virtuella datorn eller HDInsight-klustret. Resurs-ID:t för den virtuella datorn kan konstrueras med prenumerations-ID, resursgruppsnamn och VM-namn med följande strängformat: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

I följande exempel visas hur du skapar och kopplar en Data Science Virtual Machine (DSVM) som beräkningsmål.


   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)

Fullständigt exempel är tillgängligt från https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Metoder

attach

DEPRECATED. attach_configuration Använd metoden i stället.

Associera en befintlig fjärrberäkningsresurs med den angivna arbetsytan.
attach_configuration

Skapa ett konfigurationsobjekt för att koppla ett fjärrberäkningsmål.

Det går inte längre att ansluta en virtuell dator med den virtuella datorns offentliga IP-adress. Använd i stället resourceId för den virtuella datorn. ResourceId för den virtuella datorn kan konstrueras med följande strängformat: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>".

Du kan också använda subscription_id, resource_group och vm_name utan att skapa resourceId. Mer information finns i https://aka.ms/azureml-compute-vm.
delete

Borttagning stöds inte för ett RemoteCompute-objekt. Använd detach i stället.
deserialize

Konvertera ett JSON-objekt till ett RemoteCompute-objekt.
detach

Koppla från RemoteCompute-objektet från dess associerade arbetsyta.

Underliggande molnobjekt tas inte bort, endast associationen tas bort.
get_credentials

Hämta autentiseringsuppgifterna för RemoteCompute-målet.
refresh_state

Utför en uppdatering på plats av objektets egenskaper.

Den här metoden uppdaterar egenskaperna baserat på det aktuella tillståndet för motsvarande molnobjekt. Detta används främst för manuell avsökning av beräkningstillstånd.
serialize

Konvertera det här RemoteCompute-objektet till en serialiserad JSON-ordlista.

attach

DEPRECATED. attach_configuration Använd metoden i stället.

Associera en befintlig fjärrberäkningsresurs med den angivna arbetsytan.

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

Parametrar

Name Description
workspace
Obligatorisk
Workspace

Det arbetsyteobjekt som beräkningsresursen ska associeras med.
name
Obligatorisk
str

Namnet som ska associeras med beräkningsresursen i den angivna arbetsytan. Behöver inte matcha namnet på den beräkningsresurs som ska kopplas.
username
Obligatorisk
str

Användarnamnet som behövs för att komma åt resursen.
address
Obligatorisk
str

Adressen till den resurs som ska kopplas.
ssh_port
int

Den exponerade porten för resursen. Standardvärdet är 22.

Standardvärde: 22
password
Obligatorisk
str

Lösenordet som behövs för att komma åt resursen.
private_key_file
Obligatorisk
str

Sökväg till en fil som innehåller den privata nyckeln för resursen.
private_key_passphrase
Obligatorisk
str

Privat nyckelfras som behövs för att komma åt resursen.

Returer

Typ Description
RemoteCompute

En RemoteCompute-objektrepresentation av beräkningsobjektet.

Undantag

Typ Description
ComputeTargetException

attach_configuration

Skapa ett konfigurationsobjekt för att koppla ett fjärrberäkningsmål.

Det går inte längre att ansluta en virtuell dator med den virtuella datorns offentliga IP-adress. Använd i stället resourceId för den virtuella datorn. ResourceId för den virtuella datorn kan konstrueras med följande strängformat: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>".

Du kan också använda subscription_id, resource_group och vm_name utan att skapa resourceId. Mer information finns i 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='')

Parametrar

Name Description
username
Obligatorisk
str

Användarnamnet som behövs för att komma åt resursen.
subscription_id
str

Azure-prenumerations-ID:t där den virtuella datorn finns.

Standardvärde: None
resource_group
str

Namnet på resursgruppen där den virtuella datorn finns.

Standardvärde: None
vm_name
str

Namnet på den virtuella datorn.

Standardvärde: None
resource_id
str

Resurs-ID för Azure Resource Manager (ARM) för den befintliga resursen.

Standardvärde: None
address
str

Adressen för den befintliga resursen.

Standardvärde: None
ssh_port
int

Den exponerade porten för resursen. Standardvärdet är 22.

Standardvärde: 22
password
Obligatorisk
str

Lösenordet som behövs för att komma åt resursen.
private_key_file
Obligatorisk
str

Sökväg till en fil som innehåller den privata nyckeln för resursen.
private_key_passphrase
Obligatorisk
str

Den privata nyckelfras som behövs för att komma åt resursen.

Returer

Typ Description
RemoteComputeAttachConfiguration

Ett konfigurationsobjekt som ska användas när ett beräkningsobjekt kopplas.

Undantag

Typ Description
ComputeTargetException

delete

Borttagning stöds inte för ett RemoteCompute-objekt. Använd detach i stället.

delete()

Undantag

Typ Description
ComputeTargetException

deserialize

Konvertera ett JSON-objekt till ett RemoteCompute-objekt.

static deserialize(workspace, object_dict)

Parametrar

Name Description
workspace
Obligatorisk
Workspace

Arbetsyteobjektet som RemoteCompute-objektet är associerat med.
object_dict
Obligatorisk
dict

Ett JSON-objekt som ska konverteras till ett RemoteCompute-objekt.

Returer

Typ Description
RemoteCompute

RemoteCompute-representationen av det angivna JSON-objektet.

Undantag

Typ Description
ComputeTargetException

Kommentarer

Genererar en ComputeTargetException om den angivna arbetsytan inte är den arbetsyta som beräkning är associerad med.

detach

Koppla från RemoteCompute-objektet från dess associerade arbetsyta.

Underliggande molnobjekt tas inte bort, endast associationen tas bort.

detach()

Undantag

Typ Description
ComputeTargetException

get_credentials

Hämta autentiseringsuppgifterna för RemoteCompute-målet.

get_credentials()

Returer

Typ Description
dict

Autentiseringsuppgifterna för RemoteCompute-målet.

Undantag

Typ Description
ComputeTargetException

refresh_state

Utför en uppdatering på plats av objektets egenskaper.

Den här metoden uppdaterar egenskaperna baserat på det aktuella tillståndet för motsvarande molnobjekt. Detta används främst för manuell avsökning av beräkningstillstånd.

refresh_state()

Undantag

Typ Description
ComputeTargetException

serialize

Konvertera det här RemoteCompute-objektet till en serialiserad JSON-ordlista.

serialize()

Returer

Typ Description
dict

JSON-representationen av det här RemoteCompute-objektet.

Undantag

Typ Description
ComputeTargetException