RemoteCompute Clase
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
-
RemoteCompute
Constructor
RemoteCompute(workspace, name)Parámetros
- workspace
- Workspace
Objeto de área de trabajo que contiene el objeto RemoteCompute que se recuperará.
- workspace
- Workspace
Objeto de área de trabajo que contiene el objeto Compute que se 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 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
- workspace
- Workspace
Objeto de área de trabajo con el que se asociará el recurso de proceso.
- name
- 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.
- ssh_port
- int
Puerto expuesto para el recurso. El valor predeterminado es 22.
- private_key_file
- str
Ruta de acceso a un archivo que contiene la clave privada del recurso.
Devoluciones
Representación del objeto RemoteCompute del objeto de proceso.
Tipo de valor devuelto
Excepciones
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
- subscription_id
- str
Identificador de suscripción de Azure en el que se encuentra la máquina virtual.
- resource_group
- str
Nombre del grupo de recursos en el que se encuentra la máquina virtual.
- resource_id
- str
Identificador de recurso de Azure Resource Manager (ARM) del recurso existente.
- ssh_port
- int
Puerto expuesto para el recurso. El valor predeterminado es 22.
- private_key_file
- str
Ruta de acceso a un archivo que contiene la clave privada del recurso.
Devoluciones
Objeto de configuración que se usará al asociar un objeto Compute.
Tipo de valor devuelto
Excepciones
delete
No se admite la eliminación para un objeto RemoteCompute. En su lugar, use detach.
delete()Excepciones
deserialize
Convierte un objeto JSON en un objeto RemoteCompute.
static deserialize(workspace, object_dict)Parámetros
- workspace
- Workspace
Objeto de área de trabajo al que está asociado el objeto RemoteCompute.
Devoluciones
Representación de RemoteCompute del objeto JSON proporcionado.
Tipo de valor devuelto
Excepciones
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
get_credentials
Recupera las credenciales del destino de RemoteCompute.
get_credentials()Devoluciones
Credenciales del destino de RemoteCompute.
Tipo de valor devuelto
Excepciones
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
serialize
Convierte este objeto RemoteCompute en un diccionario serializado JSON.
serialize()Devoluciones
Representación JSON de este objeto RemoteCompute.
Tipo de valor devuelto
Excepciones
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de