RemoteCompute Kelas
Mengelola target komputasi jarak jauh untuk digunakan di Azure Machine Learning.
Azure Machine Learning mendukung penggunaan melampirkan sumber daya komputasi jarak jauh ke ruang kerja Anda. Sumber daya jarak jauh dapat berupa mesin virtual Azure, server jarak jauh di organisasi Anda, atau lokal, selama sumber daya dapat diakses oleh Azure Machine Learning. Untuk informasi selengkapnya, lihat Apa itu target komputasi di Azure Machine Learning?
Konstruktor Class ComputeTarget.
Ambil representasi cloud dari objek Komputasi yang terkait dengan ruang kerja yang disediakan. Mengembalikan instans kelas anak yang sesuai dengan jenis tertentu dari objek Komputasi yang diambil.
- Warisan
-
RemoteCompute
Konstruktor
RemoteCompute(workspace, name)
Parameter
Nama | Deskripsi |
---|---|
workspace
Diperlukan
|
Objek ruang kerja yang berisi objek RemoteCompute untuk diambil. |
name
Diperlukan
|
Nama objek RemoteCompute untuk diambil. |
workspace
Diperlukan
|
Objek ruang kerja yang berisi objek Azure Compute yang akan diambil. |
name
Diperlukan
|
Nama objek Komputasi yang akan diambil. |
Keterangan
Wilayah Azure berikut tidak mendukung penggunaan alamat IP publik dari mesin virtual atau kluster HDInsight untuk melampirkan target komputasi.
AS Timur
AS Barat 2
US Selatan Tengah
Sebagai gantinya, gunakan ID Azure Resource Manager dari kluster VM atau HDInsight. ID sumber daya VM dapat dibangun menggunakan ID langganan, nama grup sumber daya, dan nama mesin virtual menggunakan format string berikut: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.
Contoh berikut menunjukkan cara membuat dan melampirkan Data Science Virtual Machine (DSVM) sebagai target komputasi.
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)
Sampel lengkap tersedia dari https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb
Metode
attach |
TIDAK DIGUNAKAN LAGI. Gunakan metode Kaitkan sumber daya komputasi jarak jauh yang ada dengan ruang kerja yang disediakan. |
attach_configuration |
Buat objek konfigurasi untuk melampirkan target komputasi jarak jauh. Melampirkan mesin virtual menggunakan alamat IP publik VM tidak lagi didukung. Sebagai gantinya, gunakan resourceId VM. ResourceId VM dapat dibangun menggunakan format string berikut: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>". Anda juga dapat menggunakan subscription_id, resource_group, dan vm_name tanpa membangun resourceId. Untuk informasi selengkapnya, lihat https://aka.ms/azureml-compute-vm. |
delete |
Hapus tidak didukung untuk objek RemoteCompute. Gunakan detach sebagai gantinya. |
deserialize |
Ubah objek JSON menjadi objek RemoteCompute. |
detach |
Copot objek RemoteCompute dari ruang kerja terkaitnya. Objek cloud yang mendasarinya tidak dihapus, hanya asosiasi yang dihapus. |
get_credentials |
Ambil informasi masuk untuk target RemoteCompute. |
refresh_state |
Lakukan pembaruan di tempat dari properti objek. Metode ini memperbarui properti berdasarkan status objek cloud yang sesuai saat ini. Ini terutama digunakan untuk polling manual status komputasi. |
serialize |
Ubah objek RemoteCompute ini menjadi kamus serial JSON. |
attach
TIDAK DIGUNAKAN LAGI. Gunakan metode attach_configuration
sebagai gantinya.
Kaitkan sumber daya komputasi jarak jauh yang ada dengan ruang kerja yang disediakan.
static attach(workspace, name, username, address, ssh_port=22, password='', private_key_file='', private_key_passphrase='')
Parameter
Nama | Deskripsi |
---|---|
workspace
Diperlukan
|
Objek ruang kerja untuk mengasosiasikan sumber daya komputasi. |
name
Diperlukan
|
Nama yang akan diasosiasikan dengan sumber daya komputasi di dalam ruang kerja yang disediakan. Tidak harus cocok dengan nama sumber daya komputasi yang akan dihubungkan. |
username
Diperlukan
|
Nama pengguna diperlukan untuk mengakses sumber daya. |
address
Diperlukan
|
Alamat sumber daya yang akan dilampirkan. |
ssh_port
|
Port yang terbuka untuk sumber daya. Default ke 22. Nilai default: 22
|
password
Diperlukan
|
Kata sandi yang diperlukan untuk mengakses sumber daya. |
private_key_file
Diperlukan
|
Jalur ke file yang berisi kunci privat untuk sumber daya. |
private_key_passphrase
Diperlukan
|
Frasa kunci privat diperlukan untuk mengakses sumber daya. |
Mengembalikan
Jenis | Deskripsi |
---|---|
Representasi objek RemoteCompute dari objek komputasi. |
Pengecualian
Jenis | Deskripsi |
---|---|
attach_configuration
Buat objek konfigurasi untuk melampirkan target komputasi jarak jauh.
Melampirkan mesin virtual menggunakan alamat IP publik VM tidak lagi didukung. Sebagai gantinya, gunakan resourceId VM. ResourceId VM dapat dibangun menggunakan format string berikut: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".
Anda juga dapat menggunakan subscription_id, resource_group, dan vm_name tanpa membangun resourceId. Untuk informasi selengkapnya, lihat 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='')
Parameter
Nama | Deskripsi |
---|---|
username
Diperlukan
|
Nama pengguna diperlukan untuk mengakses sumber daya. |
subscription_id
|
ID langganan Azure tempat mesin virtual berada. Nilai default: None
|
resource_group
|
Nama grup sumber daya tempat mesin virtual berada. Nilai default: None
|
vm_name
|
Nama mesin virtual. Nilai default: None
|
resource_id
|
ID sumber daya Azure Resource Manager (ARM) untuk sumber daya yang ada. Nilai default: None
|
address
|
Alamat untuk sumber daya yang ada. Nilai default: None
|
ssh_port
|
Port yang terbuka untuk sumber daya. Default ke 22. Nilai default: 22
|
password
Diperlukan
|
Kata sandi yang diperlukan untuk mengakses sumber daya. |
private_key_file
Diperlukan
|
Jalur ke file yang berisi kunci privat untuk sumber daya. |
private_key_passphrase
Diperlukan
|
Frasa kunci privat diperlukan untuk mengakses sumber daya. |
Mengembalikan
Jenis | Deskripsi |
---|---|
Objek konfigurasi yang akan digunakan saat melampirkan objek Azure Compute. |
Pengecualian
Jenis | Deskripsi |
---|---|
delete
Hapus tidak didukung untuk objek RemoteCompute. Gunakan detach sebagai gantinya.
delete()
Pengecualian
Jenis | Deskripsi |
---|---|
deserialize
Ubah objek JSON menjadi objek RemoteCompute.
static deserialize(workspace, object_dict)
Parameter
Nama | Deskripsi |
---|---|
workspace
Diperlukan
|
Objek ruang kerja yang dikaitkan dengan objek RemoteCompute. |
object_dict
Diperlukan
|
Objek JSON untuk dikonversi ke objek RemoteCompute. |
Mengembalikan
Jenis | Deskripsi |
---|---|
Representasi RemoteCompute dari objek JSON yang disediakan. |
Pengecualian
Jenis | Deskripsi |
---|---|
Keterangan
Mengajukan ComputeTargetException jika ruang kerja yang disediakan bukan ruang kerja yang dikaitkan dengan Azure Compute.
detach
Copot objek RemoteCompute dari ruang kerja terkaitnya.
Objek cloud yang mendasarinya tidak dihapus, hanya asosiasi yang dihapus.
detach()
Pengecualian
Jenis | Deskripsi |
---|---|
get_credentials
Ambil informasi masuk untuk target RemoteCompute.
get_credentials()
Mengembalikan
Jenis | Deskripsi |
---|---|
Informasi masuk untuk target RemoteCompute. |
Pengecualian
Jenis | Deskripsi |
---|---|
refresh_state
Lakukan pembaruan di tempat dari properti objek.
Metode ini memperbarui properti berdasarkan status objek cloud yang sesuai saat ini. Ini terutama digunakan untuk polling manual status komputasi.
refresh_state()
Pengecualian
Jenis | Deskripsi |
---|---|
serialize
Ubah objek RemoteCompute ini menjadi kamus serial JSON.
serialize()
Mengembalikan
Jenis | Deskripsi |
---|---|
Representasi JSON dari objek RemoteCompute ini. |
Pengecualian
Jenis | Deskripsi |
---|---|