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 local, siempre y cuando el 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.
Constructor
RemoteCompute(workspace, name)
Parámetros
| Nombre | Description |
|---|---|
|
workspace
Requerido
|
Objeto de área de trabajo que contiene el objeto RemoteCompute que se va a recuperar. |
|
name
Requerido
|
Nombre del objeto RemoteCompute que se va a recuperar. |
|
workspace
Requerido
|
Objeto de área de trabajo que contiene el objeto Compute que se va a recuperar. |
|
name
Requerido
|
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 un clúster de HDInsight para asociar el destino de proceso.
Este de EE. UU.
Oeste de EE. UU. 2
Centro-sur de EE. UU.
En su lugar, use el identificador de Azure Resource Manager de la máquina virtual o el clúster de HDInsight. El identificador de recurso de la máquina virtual se puede construir mediante el identificador de suscripción, el nombre del grupo de recursos y el nombre de la máquina virtual con 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 adjuntar 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 |
OBSOLESCENTE. Use el Asocie un recurso de proceso remoto existente al área de trabajo proporcionada. |
| attach_configuration |
Cree un objeto de configuración para asociar un destino de proceso remoto. Ya no se admite la conexión de una máquina virtual mediante la dirección IP pública de la máquina virtual. En su lugar, use el resourceId de la máquina virtual. El resourceId de la máquina virtual se puede construir con el siguiente formato de cadena: "/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, consulte https://aka.ms/azureml-compute-vm. |
| delete |
La eliminación no se admite para un objeto RemoteCompute. En su lugar, use detach. |
| deserialize |
Convierta un objeto JSON en un objeto RemoteCompute. |
| detach |
Desasocie el objeto RemoteCompute de su área de trabajo asociada. Los objetos en la nube subyacentes no se eliminan, solo se quita la asociación. |
| get_credentials |
Recupere las credenciales del destino RemoteCompute. |
| refresh_state |
Realice 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. Esto se usa principalmente para el sondeo manual del estado de proceso. |
| serialize |
Convierta este objeto RemoteCompute en un diccionario serializado JSON. |
attach
OBSOLESCENTE. Use el attach_configuration método en su lugar.
Asocie 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
|
Objeto de área de trabajo al que se va a asociar el recurso de proceso. |
|
name
Requerido
|
Nombre que se va a 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
|
Nombre de usuario necesario para acceder al recurso. |
|
address
Requerido
|
Dirección del recurso que se va a adjuntar. |
|
ssh_port
|
Puerto expuesto para el recurso. El valor predeterminado es 22. Valor predeterminado: 22
|
|
password
Requerido
|
Contraseña necesaria para acceder al recurso. |
|
private_key_file
Requerido
|
Ruta de acceso a un archivo que contiene la clave privada del recurso. |
|
private_key_passphrase
Requerido
|
Frase de clave privada necesaria para acceder al recurso. |
Devoluciones
| Tipo | Description |
|---|---|
|
Representación de objeto RemoteCompute del objeto compute. |
Excepciones
| Tipo | Description |
|---|---|
attach_configuration
Cree un objeto de configuración para asociar un destino de proceso remoto.
Ya no se admite la conexión de una máquina virtual mediante la dirección IP pública de la máquina virtual. En su lugar, use el resourceId de la máquina virtual. El resourceId de la máquina virtual se puede construir con el siguiente formato de cadena: "/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, consulte 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
|
Nombre de usuario necesario para acceder al recurso. |
|
subscription_id
|
Identificador de suscripción de Azure en el que se encuentra la máquina virtual. Valor predeterminado: None
|
|
resource_group
|
Nombre del grupo de recursos en el que se encuentra la máquina virtual. Valor predeterminado: None
|
|
vm_name
|
Nombre de la máquina virtual. Valor predeterminado: None
|
|
resource_id
|
Identificador de recurso de Azure Resource Manager (ARM) para el recurso existente. Valor predeterminado: None
|
|
address
|
Dirección del recurso existente. Valor predeterminado: None
|
|
ssh_port
|
Puerto expuesto para el recurso. El valor predeterminado es 22. Valor predeterminado: 22
|
|
password
Requerido
|
Contraseña necesaria para acceder al recurso. |
|
private_key_file
Requerido
|
Ruta de acceso a un archivo que contiene la clave privada del recurso. |
|
private_key_passphrase
Requerido
|
Frase de clave privada necesaria para acceder al recurso. |
Devoluciones
| Tipo | Description |
|---|---|
|
Objeto de configuración que se va a usar al adjuntar un objeto Compute. |
delete
La eliminación no se admite para un objeto RemoteCompute. En su lugar, use detach.
delete()
Excepciones
| Tipo | Description |
|---|---|
deserialize
Convierta un objeto JSON en un objeto RemoteCompute.
static deserialize(workspace, object_dict)
Parámetros
| Nombre | Description |
|---|---|
|
workspace
Requerido
|
Objeto de área de trabajo al que está asociado el objeto RemoteCompute. |
|
object_dict
Requerido
|
Objeto JSON que se va a convertir en un objeto RemoteCompute. |
Devoluciones
| Tipo | Description |
|---|---|
|
Representación RemoteCompute del objeto JSON proporcionado. |
Excepciones
| Tipo | Description |
|---|---|
Comentarios
Genera un ComputeTargetException si el área de trabajo proporcionada no es el área de trabajo a la que está asociado el proceso.
detach
Desasocie el objeto RemoteCompute de su área de trabajo asociada.
Los objetos en la nube subyacentes no se eliminan, solo se quita la asociación.
detach()
Excepciones
| Tipo | Description |
|---|---|
get_credentials
Recupere las credenciales del destino RemoteCompute.
get_credentials()
Devoluciones
| Tipo | Description |
|---|---|
|
Credenciales del destino RemoteCompute. |
Excepciones
| Tipo | Description |
|---|---|
refresh_state
Realice 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. Esto se usa principalmente para el sondeo manual del estado de proceso.
refresh_state()
serialize
Convierta este objeto RemoteCompute en un diccionario serializado JSON.
serialize()
Devoluciones
| Tipo | Description |
|---|---|
|
Representación JSON de este objeto RemoteCompute. |