Udostępnij przez

RemoteCompute Klasa

Zarządza zdalnym celem obliczeniowym do użycia w usłudze Azure Machine Learning.

Usługa Azure Machine Learning obsługuje dołączanie zdalnego zasobu obliczeniowego do obszaru roboczego. Zasób zdalny może być maszyną wirtualną platformy Azure, serwerem zdalnym w organizacji lub lokalnym, o ile zasób jest dostępny dla usługi Azure Machine Learning. Aby uzyskać więcej informacji, zobacz Co to są cele obliczeniowe w usłudze Azure Machine Learning?

Konstruktor Klasy ComputeTarget.

Pobierz reprezentację w chmurze obiektu obliczeniowego skojarzonego z podanym obszarem roboczym. Zwraca wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu obliczeniowego.

Konstruktor

RemoteCompute(workspace, name)

Parametry

Nazwa Opis
workspace
Wymagane
Workspace

Obiekt obszaru roboczego zawierający obiekt RemoteCompute do pobrania.
name
Wymagane
str

Nazwa obiektu RemoteCompute do pobrania.
workspace
Wymagane
Workspace

Obiekt obszaru roboczego zawierający obiekt Compute do pobrania.
name
Wymagane
str

Nazwa obiektu Compute do pobrania.

Uwagi

Następujące regiony platformy Azure nie obsługują używania publicznego adresu IP maszyny wirtualnej lub klastra usługi HDInsight w celu dołączenia docelowego obiektu obliczeniowego.

  • Wschodnie stany USA

  • Zachodnie stany USA 2

  • Południowo-środkowe stany USA

Zamiast tego użyj identyfikatora usługi Azure Resource Manager maszyny wirtualnej lub klastra usługi HDInsight. Identyfikator zasobu maszyny wirtualnej można utworzyć przy użyciu identyfikatora subskrypcji, nazwy grupy zasobów i nazwy maszyny wirtualnej przy użyciu następującego formatu ciągu: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

W poniższym przykładzie pokazano, jak utworzyć i dołączyć maszynę wirtualną Data Science Virtual Machine (DSVM) jako docelowy obiekt obliczeniowy.


   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)

Pełny przykład jest dostępny w witrynie https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Metody

attach

PRZESTARZAŁE. attach_configuration Zamiast tego użyj metody .

Skojarz istniejący zdalny zasób obliczeniowy z podanym obszarem roboczym.
attach_configuration

Utwórz obiekt konfiguracji na potrzeby dołączania zdalnego obiektu docelowego obliczeniowego.

Dołączanie maszyny wirtualnej przy użyciu publicznego adresu IP maszyny wirtualnej nie jest już obsługiwane. Zamiast tego użyj identyfikatora resourceId maszyny wirtualnej. Identyfikator resourceId maszyny wirtualnej można utworzyć przy użyciu następującego formatu ciągu: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

Można również użyć subscription_id, resource_group i vm_name bez konstruowania identyfikatora resourceId. Aby uzyskać więcej informacji, zobacz https://aka.ms/azureml-compute-vm.
delete

Usuwanie nie jest obsługiwane dla obiektu RemoteCompute. Użyj detach zamiast tego.
deserialize

Przekonwertuj obiekt JSON na obiekt RemoteCompute.
detach

Odłącz obiekt RemoteCompute od skojarzonego z nim obszaru roboczego.

Bazowe obiekty w chmurze nie są usuwane, a skojarzenie jest usuwane.
get_credentials

Pobierz poświadczenia dla obiektu docelowego RemoteCompute.
refresh_state

Przeprowadź aktualizację w miejscu właściwości obiektu.

Ta metoda aktualizuje właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu obliczeniowego.
serialize

Przekonwertuj ten obiekt RemoteCompute na słownik serializowany JSON.

attach

PRZESTARZAŁE. attach_configuration Zamiast tego użyj metody .

Skojarz istniejący zdalny zasób obliczeniowy z podanym obszarem roboczym.

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

Parametry

Nazwa Opis
workspace
Wymagane
Workspace

Obiekt obszaru roboczego do skojarzenia zasobu obliczeniowego z.
name
Wymagane
str

Nazwa do skojarzenia z zasobem obliczeniowym w podanym obszarze roboczym. Nie musi być zgodna z nazwą zasobu obliczeniowego, który ma być dołączony.
username
Wymagane
str

Nazwa użytkownika wymagana do uzyskania dostępu do zasobu.
address
Wymagane
str

Adres zasobu do dołączenia.
ssh_port
int

Uwidoczniony port zasobu. Wartość domyślna to 22.

Domyślna wartość: 22
password
Wymagane
str

Hasło potrzebne do uzyskania dostępu do zasobu.
private_key_file
Wymagane
str

Ścieżka do pliku zawierającego klucz prywatny zasobu.
private_key_passphrase
Wymagane
str

Fraza klucza prywatnego potrzebna do uzyskania dostępu do zasobu.

Zwraca

Typ Opis
RemoteCompute

Obiekt RemoteCompute reprezentujący obiekt obliczeniowy.

Wyjątki

Typ Opis
ComputeTargetException

attach_configuration

Utwórz obiekt konfiguracji na potrzeby dołączania zdalnego obiektu docelowego obliczeniowego.

Dołączanie maszyny wirtualnej przy użyciu publicznego adresu IP maszyny wirtualnej nie jest już obsługiwane. Zamiast tego użyj identyfikatora resourceId maszyny wirtualnej. Identyfikator resourceId maszyny wirtualnej można utworzyć przy użyciu następującego formatu ciągu: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

Można również użyć subscription_id, resource_group i vm_name bez konstruowania identyfikatora resourceId. Aby uzyskać więcej informacji, zobacz 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='')

Parametry

Nazwa Opis
username
Wymagane
str

Nazwa użytkownika wymagana do uzyskania dostępu do zasobu.
subscription_id
str

Identyfikator subskrypcji platformy Azure, w którym znajduje się maszyna wirtualna.

Domyślna wartość: None
resource_group
str

Nazwa grupy zasobów, w której znajduje się maszyna wirtualna.

Domyślna wartość: None
vm_name
str

Nazwa maszyny wirtualnej.

Domyślna wartość: None
resource_id
str

Identyfikator zasobu usługi Azure Resource Manager (ARM) dla istniejącego zasobu.

Domyślna wartość: None
address
str

Adres istniejącego zasobu.

Domyślna wartość: None
ssh_port
int

Uwidoczniony port zasobu. Wartość domyślna to 22.

Domyślna wartość: 22
password
Wymagane
str

Hasło potrzebne do uzyskania dostępu do zasobu.
private_key_file
Wymagane
str

Ścieżka do pliku zawierającego klucz prywatny zasobu.
private_key_passphrase
Wymagane
str

Fraza klucza prywatnego potrzebna do uzyskania dostępu do zasobu.

Zwraca

Typ Opis
RemoteComputeAttachConfiguration

Obiekt konfiguracji, który ma być używany podczas dołączania obiektu obliczeniowego.

delete

Usuwanie nie jest obsługiwane dla obiektu RemoteCompute. Użyj detach zamiast tego.

delete()

Wyjątki

Typ Opis
ComputeTargetException

deserialize

Przekonwertuj obiekt JSON na obiekt RemoteCompute.

static deserialize(workspace, object_dict)

Parametry

Nazwa Opis
workspace
Wymagane
Workspace

Obiekt obszaru roboczego, z który jest skojarzony obiekt RemoteCompute.
object_dict
Wymagane
dict

Obiekt JSON do konwersji na obiekt RemoteCompute.

Zwraca

Typ Opis
RemoteCompute

Reprezentacja remoteCompute podanego obiektu JSON.

Wyjątki

Typ Opis
ComputeTargetException

Uwagi

Zgłasza wartość , ComputeTargetException jeśli podany obszar roboczy nie jest obszarem roboczym skojarzonym z usługą Compute.

detach

Odłącz obiekt RemoteCompute od skojarzonego z nim obszaru roboczego.

Bazowe obiekty w chmurze nie są usuwane, a skojarzenie jest usuwane.

detach()

Wyjątki

Typ Opis
ComputeTargetException

get_credentials

Pobierz poświadczenia dla obiektu docelowego RemoteCompute.

get_credentials()

Zwraca

Typ Opis
dict

Poświadczenia obiektu docelowego RemoteCompute.

Wyjątki

Typ Opis
ComputeTargetException

refresh_state

Przeprowadź aktualizację w miejscu właściwości obiektu.

Ta metoda aktualizuje właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu obliczeniowego.

refresh_state()

serialize

Przekonwertuj ten obiekt RemoteCompute na słownik serializowany JSON.

serialize()

Zwraca

Typ Opis
dict

Reprezentacja JSON tego obiektu RemoteCompute.