Sdílet prostřednictvím


RemoteCompute Třída

Spravuje cíl vzdálených výpočetních prostředků pro použití ve službě Azure Machine Learning.

Azure Machine Learning podporuje připojení vzdáleného výpočetního prostředku k pracovnímu prostoru. Vzdáleným prostředkem může být virtuální počítač Azure, vzdálený server ve vaší organizaci nebo místní, pokud je prostředek přístupný službě Azure Machine Learning. Další informace najdete v tématu Co jsou výpočetní cíle ve službě Azure Machine Learning?

Třída ComputeTarget – konstruktor.

Načtěte cloudovou reprezentaci výpočetního objektu přidruženého k poskytnutému pracovnímu prostoru. Vrátí instanci podřízené třídy odpovídající konkrétnímu typu načteného objektu Compute.

Dědičnost
RemoteCompute

Konstruktor

RemoteCompute(workspace, name)

Parametry

workspace
Workspace
Vyžadováno

Objekt pracovního prostoru obsahující objekt RemoteCompute, který se má načíst.

name
str
Vyžadováno

Název objektu RemoteCompute, který se má načíst.

workspace
Workspace
Vyžadováno

Objekt pracovního prostoru obsahující objekt Compute, který se má načíst.

name
str
Vyžadováno

Název objektu Compute, který se má načíst.

Poznámky

Následující oblasti Azure nepodporují použití veřejné IP adresy virtuálního počítače nebo clusteru HDInsight k připojení cílového výpočetního objektu.

  • USA – východ

  • USA – západ 2

  • USA (střed) – jih

Místo toho použijte ID azure Resource Manager virtuálního počítače nebo clusteru HDInsight. ID prostředku virtuálního počítače je možné vytvořit pomocí ID předplatného, názvu skupiny prostředků a názvu virtuálního počítače pomocí následujícího formátu řetězce: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

Následující příklad ukazuje, jak vytvořit a připojit Data Science Virtual Machine (DSVM) jako cílový výpočetní objekt.


   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)

Úplná ukázka je k dispozici od https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Metody

attach

ZASTARALÉ. Místo toho použijte metodu attach_configuration .

Přidružte existující vzdálený výpočetní prostředek k poskytnutému pracovnímu prostoru.

attach_configuration

Vytvořte objekt konfigurace pro připojení vzdáleného cílového výpočetního objektu.

Připojení virtuálního počítače pomocí veřejné IP adresy virtuálního počítače se už nepodporuje. Místo toho použijte id prostředku virtuálního počítače. Id prostředku virtuálního počítače je možné vytvořit pomocí následujícího formátu řetězce: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

Můžete také použít subscription_id, resource_group a vm_name bez vytváření resourceId. Další informace naleznete v tématu https://aka.ms/azureml-compute-vm.

delete

Objekt RemoteCompute nepodporuje odstranění. Místo toho použijte detach.

deserialize

Převeďte objekt JSON na objekt RemoteCompute.

detach

Odpojte objekt RemoteCompute od přidruženého pracovního prostoru.

Základní cloudové objekty se neodstraní, odebere se jenom přidružení.

get_credentials

Načtěte přihlašovací údaje pro cíl RemoteCompute.

refresh_state

Proveďte místní aktualizaci vlastností objektu.

Tato metoda aktualizuje vlastnosti na základě aktuálního stavu odpovídajícího cloudového objektu. Primárně se používá pro ruční dotazování stavu výpočetních prostředků.

serialize

Převeďte tento objekt RemoteCompute na serializovaný slovník JSON.

attach

ZASTARALÉ. Místo toho použijte metodu attach_configuration .

Přidružte existující vzdálený výpočetní prostředek k poskytnutému pracovnímu prostoru.

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

Parametry

workspace
Workspace
Vyžadováno

Objekt pracovního prostoru, ke kterým chcete přidružit výpočetní prostředek.

name
str
Vyžadováno

Název, který chcete přidružit k výpočetnímu prostředku v zadaném pracovním prostoru. Nemusí odpovídat názvu připojeného výpočetního prostředku.

username
str
Vyžadováno

Uživatelské jméno potřebné pro přístup k prostředku.

address
str
Vyžadováno

Adresa prostředku, který se má připojit.

ssh_port
int
výchozí hodnota: 22

Vystavený port pro prostředek. Výchozí hodnota je 22.

password
str
Vyžadováno

Heslo potřebné pro přístup k prostředku.

private_key_file
str
Vyžadováno

Cesta k souboru obsahujícímu privátní klíč prostředku

private_key_passphrase
str
Vyžadováno

Fráze privátního klíče potřebná pro přístup k prostředku

Návraty

Reprezentace objektu RemoteCompute výpočetního objektu.

Návratový typ

Výjimky

attach_configuration

Vytvořte objekt konfigurace pro připojení vzdáleného cílového výpočetního objektu.

Připojení virtuálního počítače pomocí veřejné IP adresy virtuálního počítače se už nepodporuje. Místo toho použijte id prostředku virtuálního počítače. Id prostředku virtuálního počítače je možné vytvořit pomocí následujícího formátu řetězce: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

Můžete také použít subscription_id, resource_group a vm_name bez vytváření resourceId. Další informace naleznete v tématu 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

username
str
Vyžadováno

Uživatelské jméno potřebné pro přístup k prostředku.

subscription_id
str
výchozí hodnota: None

ID předplatného Azure, ve kterém se nachází virtuální počítač.

resource_group
str
výchozí hodnota: None

Název skupiny prostředků, ve které se nachází virtuální počítač.

vm_name
str
výchozí hodnota: None

Název virtuálního počítače.

resource_id
str
výchozí hodnota: None

ID prostředku Azure Resource Manager (ARM) pro existující prostředek.

address
str
výchozí hodnota: None

Adresa existujícího prostředku.

ssh_port
int
výchozí hodnota: 22

Vystavený port pro prostředek. Výchozí hodnota je 22.

password
str
Vyžadováno

Heslo potřebné pro přístup k prostředku.

private_key_file
str
Vyžadováno

Cesta k souboru obsahujícímu privátní klíč prostředku

private_key_passphrase
str
Vyžadováno

Fráze privátního klíče potřebná pro přístup k prostředku

Návraty

Objekt konfigurace, který se má použít při připojování výpočetního objektu.

Návratový typ

Výjimky

delete

Objekt RemoteCompute nepodporuje odstranění. Místo toho použijte detach.

delete()

Výjimky

deserialize

Převeďte objekt JSON na objekt RemoteCompute.

static deserialize(workspace, object_dict)

Parametry

workspace
Workspace
Vyžadováno

Objekt pracovního prostoru, ke které je přidružen objekt RemoteCompute.

object_dict
dict
Vyžadováno

Objekt JSON, který se má převést na objekt RemoteCompute.

Návraty

Reprezentace RemoteCompute poskytnutého objektu JSON.

Návratový typ

Výjimky

Poznámky

Vyvolá, ComputeTargetException pokud zadaný pracovní prostor není pracovním prostorem, ke který je přidružen compute.

detach

Odpojte objekt RemoteCompute od přidruženého pracovního prostoru.

Základní cloudové objekty se neodstraní, odebere se jenom přidružení.

detach()

Výjimky

get_credentials

Načtěte přihlašovací údaje pro cíl RemoteCompute.

get_credentials()

Návraty

Přihlašovací údaje pro cíl RemoteCompute.

Návratový typ

Výjimky

refresh_state

Proveďte místní aktualizaci vlastností objektu.

Tato metoda aktualizuje vlastnosti na základě aktuálního stavu odpovídajícího cloudového objektu. Primárně se používá pro ruční dotazování stavu výpočetních prostředků.

refresh_state()

Výjimky

serialize

Převeďte tento objekt RemoteCompute na serializovaný slovník JSON.

serialize()

Návraty

Reprezentace JSON tohoto objektu RemoteCompute.

Návratový typ

Výjimky