RemoteCompute Clase

Referencia

Administra un destino de proceso remoto para su uso en Azure Machine Learning.

Azure Machine Learning admite el uso de la asociación de un recurso de proceso remoto al área de trabajo. El recurso remoto puede ser una máquina virtual de Azure, un servidor remoto de su organización o el entorno local, siempre y cuando dicho recurso sea accesible para Azure Machine Learning. Para más información, consulte ¿Qué son los destinos de proceso en Azure Machine Learning?

Constructor ComputeTarget de clase.

Recupere una representación en la nube de un objeto Compute asociado al área de trabajo proporcionada. Devuelve una instancia de una clase secundaria correspondiente al tipo específico del objeto Compute recuperado.

Herencia: ComputeTarget

RemoteCompute

Constructor

RemoteCompute(workspace, name)

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto de área de trabajo que contiene el objeto RemoteCompute que se recuperará.
name Requerido	str Nombre del objeto RemoteCompute que se recuperará.
workspace Requerido	Workspace Objeto de área de trabajo que contiene el objeto Compute que se recuperará.
name Requerido	str Nombre del objeto Compute que se va a recuperar.

Comentarios

Las siguientes regiones de Azure no admiten el uso de la dirección IP pública de una máquina virtual o de un clúster de HDInsight para asociar el destino de proceso.

Este de EE. UU.
Oeste de EE. UU. 2
Centro y Sur de EE. UU.

En su lugar, use el identificador de Azure Resource Manager de la máquina virtual o del clúster de HDInsight. El identificador de recurso de la máquina virtual se puede crear con el identificador de suscripción, el nombre del grupo de recursos y el nombre de la máquina virtual usando el siguiente formato de cadena: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

En el ejemplo siguiente se muestra cómo crear y asociar una instancia de Data Science Virtual Machine (DSVM) como destino de proceso.


   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)

El ejemplo completo está disponible en https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb.

Métodos

attach	EN DESUSO. Use el método `attach_configuration` en su lugar. Asocia un recurso de proceso remoto existente al área de trabajo proporcionada.
attach_configuration	Crea un objeto de configuración para asociar un destino de proceso remoto. Ya no se admite la asociación de una máquina virtual con la dirección IP pública de la máquina virtual. En su lugar, use el elemento resourceId de la máquina virtual. El elemento resourceId de la máquina virtual se puede construir con el formato de cadena siguiente: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>". También puede usar subscription_id, resource_group y vm_name sin construir resourceId. Para obtener más información, vea https://aka.ms/azureml-compute-vm.
delete	No se admite la eliminación para un objeto RemoteCompute. En su lugar, use detach.
deserialize	Convierte un objeto JSON en un objeto RemoteCompute.
detach	Desasocia el objeto RemoteCompute de su área de trabajo asociada. Los objetos de nube subyacentes no se eliminan, solo se quita la asociación.
get_credentials	Recupera las credenciales del destino de RemoteCompute.
refresh_state	Realiza una actualización local de las propiedades del objeto. Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Se usa principalmente para el sondeo manual del estado de proceso.
serialize	Convierte este objeto RemoteCompute en un diccionario serializado JSON.

attach

EN DESUSO. Use el método attach_configuration en su lugar.

Asocia un recurso de proceso remoto existente al área de trabajo proporcionada.

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

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto de área de trabajo con el que se asociará el recurso de proceso.
name Requerido	str Nombre que se asociará al recurso de proceso dentro del área de trabajo proporcionada. No tiene que coincidir con el nombre del recurso de proceso que se va a asociar.
username Requerido	str Nombre de usuario necesario para acceder al recurso.
address Requerido	str Dirección del recurso que se va a asociar.
ssh_port	int Puerto expuesto para el recurso. El valor predeterminado es 22. Valor predeterminado: 22
password Requerido	str Contraseña necesaria para acceder al recurso.
private_key_file Requerido	str Ruta de acceso a un archivo que contiene la clave privada del recurso.
private_key_passphrase Requerido	str Frase de clave privada necesaria para acceder al recurso.

Devoluciones

Tipo	Description
RemoteCompute	Representación del objeto RemoteCompute del objeto de proceso.

Excepciones

Tipo	Description
ComputeTargetException

attach_configuration

Crea un objeto de configuración para asociar un destino de proceso remoto.

Ya no se admite la asociación de una máquina virtual con la dirección IP pública de la máquina virtual. En su lugar, use el elemento resourceId de la máquina virtual. El elemento resourceId de la máquina virtual se puede construir con el formato de cadena siguiente: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

También puede usar subscription_id, resource_group y vm_name sin construir resourceId. Para obtener más información, vea 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='')

Parámetros

Nombre	Description
username Requerido	str Nombre de usuario necesario para acceder al recurso.
subscription_id	str Identificador de suscripción de Azure en el que se encuentra la máquina virtual. Valor predeterminado: None
resource_group	str Nombre del grupo de recursos en el que se encuentra la máquina virtual. Valor predeterminado: None
vm_name	str Nombre de la máquina virtual. Valor predeterminado: None
resource_id	str Identificador de recurso de Azure Resource Manager (ARM) del recurso existente. Valor predeterminado: None
address	str Dirección del recurso existente. Valor predeterminado: None
ssh_port	int Puerto expuesto para el recurso. El valor predeterminado es 22. Valor predeterminado: 22
password Requerido	str Contraseña necesaria para acceder al recurso.
private_key_file Requerido	str Ruta de acceso a un archivo que contiene la clave privada del recurso.
private_key_passphrase Requerido	str Frase de clave privada necesaria para acceder al recurso.

Devoluciones

Tipo	Description
RemoteComputeAttachConfiguration	Objeto de configuración que se usará al asociar un objeto Compute.

Excepciones

Tipo	Description
ComputeTargetException

delete

No se admite la eliminación para un objeto RemoteCompute. En su lugar, use detach.

delete()

Excepciones

Tipo	Description
ComputeTargetException

deserialize

Convierte un objeto JSON en un objeto RemoteCompute.

static deserialize(workspace, object_dict)

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto de área de trabajo al que está asociado el objeto RemoteCompute.
object_dict Requerido	dict Objeto JSON que se convierte en un objeto RemoteCompute.

Devoluciones

Tipo	Description
RemoteCompute	Representación de RemoteCompute del objeto JSON proporcionado.

Excepciones

Tipo	Description
ComputeTargetException

Comentarios

Genera una excepción ComputeTargetException si el área de trabajo proporcionada no es el área de trabajo a la que está asociado el proceso.

detach

Desasocia el objeto RemoteCompute de su área de trabajo asociada.

Los objetos de nube subyacentes no se eliminan, solo se quita la asociación.

detach()

Excepciones

Tipo	Description
ComputeTargetException

get_credentials

Recupera las credenciales del destino de RemoteCompute.

get_credentials()

Devoluciones

Tipo	Description
dict	Credenciales del destino de RemoteCompute.

Excepciones

Tipo	Description
ComputeTargetException

refresh_state

Realiza una actualización local de las propiedades del objeto.

Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Se usa principalmente para el sondeo manual del estado de proceso.

refresh_state()

Excepciones

Tipo	Description
ComputeTargetException

serialize

Convierte este objeto RemoteCompute en un diccionario serializado JSON.

serialize()

Devoluciones

Tipo	Description
dict	Representación JSON de este objeto RemoteCompute.

Excepciones

Tipo	Description
ComputeTargetException

Compartir a través de

RemoteCompute Clase

Constructor

Parámetros

Comentarios

Métodos

attach

Parámetros

Devoluciones

Excepciones

attach_configuration

Parámetros

Devoluciones

Excepciones

delete

Excepciones

deserialize

Parámetros

Devoluciones

Excepciones

Comentarios

detach

Excepciones

get_credentials

Devoluciones

Excepciones

refresh_state

Excepciones

serialize

Devoluciones

Excepciones

Comentarios

Recursos adicionales