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

workspace
Workspace
Obligatorisk

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

name
str
Obligatorisk

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

workspace
Workspace
Obligatorisk

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

name
str
Obligatorisk

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

workspace
Workspace
Obligatorisk

Det arbetsyteobjekt som beräkningsresursen ska associeras med.

name
str
Obligatorisk

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

username
str
Obligatorisk

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

address
str
Obligatorisk

Adressen till den resurs som ska kopplas.

ssh_port
int
standardvärde: 22

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

password
str
Obligatorisk

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

private_key_file
str
Obligatorisk

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

private_key_passphrase
str
Obligatorisk

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

Returer

En RemoteCompute-objektrepresentation av beräkningsobjektet.

Returtyp

RemoteCompute

Undantag

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

username
str
Obligatorisk

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

subscription_id
str
standardvärde: None

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

resource_group
str
standardvärde: None

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

vm_name
str
standardvärde: None

Namnet på den virtuella datorn.

resource_id
str
standardvärde: None

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

address
str
standardvärde: None

Adressen för den befintliga resursen.

ssh_port
int
standardvärde: 22

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

password
str
Obligatorisk

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

private_key_file
str
Obligatorisk

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

private_key_passphrase
str
Obligatorisk

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

Returer

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

Returtyp

RemoteComputeAttachConfiguration

Undantag

ComputeTargetException

delete

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

delete()

Undantag

ComputeTargetException

deserialize

Konvertera ett JSON-objekt till ett RemoteCompute-objekt.

static deserialize(workspace, object_dict)

Parametrar

workspace
Workspace
Obligatorisk

Arbetsyteobjektet som RemoteCompute-objektet är associerat med.

object_dict
dict
Obligatorisk

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

Returer

RemoteCompute-representationen av det angivna JSON-objektet.

Returtyp

RemoteCompute

Undantag

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

ComputeTargetException

get_credentials

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

get_credentials()

Returer

Autentiseringsuppgifterna för RemoteCompute-målet.

Returtyp

dict

Undantag

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

ComputeTargetException

serialize

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

serialize()

Returer

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

Returtyp

dict

Undantag

ComputeTargetException