Bagikan melalui


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

workspace
Workspace
Diperlukan

Objek ruang kerja yang berisi objek RemoteCompute untuk diambil.

name
str
Diperlukan

Nama objek RemoteCompute untuk diambil.

workspace
Workspace
Diperlukan

Objek ruang kerja yang berisi objek Azure Compute yang akan diambil.

name
str
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 attach_configuration sebagai gantinya.

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

workspace
Workspace
Diperlukan

Objek ruang kerja untuk mengasosiasikan sumber daya komputasi.

name
str
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
str
Diperlukan

Nama pengguna diperlukan untuk mengakses sumber daya.

address
str
Diperlukan

Alamat sumber daya yang akan dilampirkan.

ssh_port
int
nilai default: 22

Port yang terbuka untuk sumber daya. Default ke 22.

password
str
Diperlukan

Kata sandi yang diperlukan untuk mengakses sumber daya.

private_key_file
str
Diperlukan

Jalur ke file yang berisi kunci privat untuk sumber daya.

private_key_passphrase
str
Diperlukan

Frasa kunci privat diperlukan untuk mengakses sumber daya.

Mengembalikan

Representasi objek RemoteCompute dari objek komputasi.

Tipe hasil

Pengecualian

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

username
str
Diperlukan

Nama pengguna diperlukan untuk mengakses sumber daya.

subscription_id
str
nilai default: None

ID langganan Azure tempat mesin virtual berada.

resource_group
str
nilai default: None

Nama grup sumber daya tempat mesin virtual berada.

vm_name
str
nilai default: None

Nama mesin virtual.

resource_id
str
nilai default: None

ID sumber daya Azure Resource Manager (ARM) untuk sumber daya yang ada.

address
str
nilai default: None

Alamat untuk sumber daya yang ada.

ssh_port
int
nilai default: 22

Port yang terbuka untuk sumber daya. Default ke 22.

password
str
Diperlukan

Kata sandi yang diperlukan untuk mengakses sumber daya.

private_key_file
str
Diperlukan

Jalur ke file yang berisi kunci privat untuk sumber daya.

private_key_passphrase
str
Diperlukan

Frasa kunci privat diperlukan untuk mengakses sumber daya.

Mengembalikan

Objek konfigurasi yang akan digunakan saat melampirkan objek Azure Compute.

Tipe hasil

Pengecualian

delete

Hapus tidak didukung untuk objek RemoteCompute. Gunakan detach sebagai gantinya.

delete()

Pengecualian

deserialize

Ubah objek JSON menjadi objek RemoteCompute.

static deserialize(workspace, object_dict)

Parameter

workspace
Workspace
Diperlukan

Objek ruang kerja yang dikaitkan dengan objek RemoteCompute.

object_dict
dict
Diperlukan

Objek JSON untuk dikonversi ke objek RemoteCompute.

Mengembalikan

Representasi RemoteCompute dari objek JSON yang disediakan.

Tipe hasil

Pengecualian

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

get_credentials

Ambil informasi masuk untuk target RemoteCompute.

get_credentials()

Mengembalikan

Informasi masuk untuk target RemoteCompute.

Tipe hasil

Pengecualian

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

serialize

Ubah objek RemoteCompute ini menjadi kamus serial JSON.

serialize()

Mengembalikan

Representasi JSON dari objek RemoteCompute ini.

Tipe hasil

Pengecualian