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
Name | Description |
---|---|
workspace
Vyžadováno
|
Objekt pracovního prostoru obsahující objekt RemoteCompute, který se má načíst. |
name
Vyžadováno
|
Název objektu RemoteCompute, který se má načíst. |
workspace
Vyžadováno
|
Objekt pracovního prostoru obsahující objekt Compute, který se má načíst. |
name
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 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
Name | Description |
---|---|
workspace
Vyžadováno
|
Objekt pracovního prostoru, ke kterým chcete přidružit výpočetní prostředek. |
name
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
Vyžadováno
|
Uživatelské jméno potřebné pro přístup k prostředku. |
address
Vyžadováno
|
Adresa prostředku, který se má připojit. |
ssh_port
|
Vystavený port pro prostředek. Výchozí hodnota je 22. Default value: 22
|
password
Vyžadováno
|
Heslo potřebné pro přístup k prostředku. |
private_key_file
Vyžadováno
|
Cesta k souboru obsahujícímu privátní klíč prostředku |
private_key_passphrase
Vyžadováno
|
Fráze privátního klíče potřebná pro přístup k prostředku |
Návraty
Typ | Description |
---|---|
Reprezentace objektu RemoteCompute výpočetního objektu. |
Výjimky
Typ | Description |
---|---|
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
Name | Description |
---|---|
username
Vyžadováno
|
Uživatelské jméno potřebné pro přístup k prostředku. |
subscription_id
|
ID předplatného Azure, ve kterém se nachází virtuální počítač. Default value: None
|
resource_group
|
Název skupiny prostředků, ve které se nachází virtuální počítač. Default value: None
|
vm_name
|
Název virtuálního počítače. Default value: None
|
resource_id
|
ID prostředku Azure Resource Manager (ARM) pro existující prostředek. Default value: None
|
address
|
Adresa existujícího prostředku. Default value: None
|
ssh_port
|
Vystavený port pro prostředek. Výchozí hodnota je 22. Default value: 22
|
password
Vyžadováno
|
Heslo potřebné pro přístup k prostředku. |
private_key_file
Vyžadováno
|
Cesta k souboru obsahujícímu privátní klíč prostředku |
private_key_passphrase
Vyžadováno
|
Fráze privátního klíče potřebná pro přístup k prostředku |
Návraty
Typ | Description |
---|---|
Objekt konfigurace, který se má použít při připojování výpočetního objektu. |
Výjimky
Typ | Description |
---|---|
delete
Objekt RemoteCompute nepodporuje odstranění. Místo toho použijte detach.
delete()
Výjimky
Typ | Description |
---|---|
deserialize
Převeďte objekt JSON na objekt RemoteCompute.
static deserialize(workspace, object_dict)
Parametry
Name | Description |
---|---|
workspace
Vyžadováno
|
Objekt pracovního prostoru, ke které je přidružen objekt RemoteCompute. |
object_dict
Vyžadováno
|
Objekt JSON, který se má převést na objekt RemoteCompute. |
Návraty
Typ | Description |
---|---|
Reprezentace RemoteCompute poskytnutého objektu JSON. |
Výjimky
Typ | Description |
---|---|
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
Typ | Description |
---|---|
get_credentials
Načtěte přihlašovací údaje pro cíl RemoteCompute.
get_credentials()
Návraty
Typ | Description |
---|---|
Přihlašovací údaje pro cíl RemoteCompute. |
Výjimky
Typ | Description |
---|---|
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
Typ | Description |
---|---|
serialize
Převeďte tento objekt RemoteCompute na serializovaný slovník JSON.
serialize()
Návraty
Typ | Description |
---|---|
Reprezentace JSON tohoto objektu RemoteCompute. |
Výjimky
Typ | Description |
---|---|