RemoteCompute Classe

  • Referência

Gere um destino de computação remoto para utilização no Azure Machine Learning.

O Azure Machine Learning suporta a utilização da anexação de um recurso de computação remota à sua área de trabalho. O recurso remoto pode ser uma VM do Azure, um servidor remoto na sua organização ou no local, desde que o recurso esteja acessível ao Azure Machine Learning. Para obter mais informações, veja O que são os destinos de computação no Azure Machine Learning?

Construtor Class ComputeTarget.

Obtenha uma representação na cloud de um objeto de Computação associado à área de trabalho fornecida. Devolve uma instância de uma classe subordinada correspondente ao tipo específico do objeto de Computação obtido.

Herança
ComputeTarget
RemoteCompute

Construtor

RemoteCompute(workspace, name)

Parâmetros

workspace
Workspace
Necessário

O objeto da área de trabalho que contém o objeto RemoteCompute a obter.

name
str
Necessário

O nome do objeto RemoteCompute a obter.

workspace
Workspace
Necessário

O objeto da área de trabalho que contém o objeto Computação a obter.

name
str
Necessário

O nome do objeto Computação a obter.

Observações

As seguintes regiões do Azure não suportam a utilização do endereço IP público de uma máquina virtual ou cluster do HDInsight para anexar o destino de computação.

  • E.U.A Leste

  • E.U.A. Oeste 2

  • E.U.A. Centro-Sul

Em vez disso, utilize o ID de Resource Manager do Azure da VM ou do cluster do HDInsight. O ID de recurso da VM pode ser construído com o ID da subscrição, o nome do grupo de recursos e o nome da VM com o seguinte formato de cadeia: /subscriptions/<subscription_id/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>>.

O exemplo seguinte mostra como criar e anexar um Máquina Virtual de Ciência de Dados (DSVM) como destino de computação.


   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)

O exemplo completo está disponível a partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Métodos

attach

PRETERIDO. Em alternativa, utilize o attach_configuration método .

Associe um recurso de computação remota existente à área de trabalho fornecida.
attach_configuration

Crie um objeto de configuração para anexar um destino de computação remoto.

A anexação de uma máquina virtual com o endereço IP público da VM já não é suportada. Em vez disso, utilize o resourceId da VM. O resourceId da VM pode ser construído com o seguinte formato de cadeia: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

Também pode utilizar subscription_id, resource_group e vm_name sem construir resourceId. Para obter mais informações, consulte https://aka.ms/azureml-compute-vm.
delete

A eliminação não é suportada para um objeto RemoteCompute. Em vez disso, utilize detach.
deserialize

Converta um objeto JSON num objeto RemoteCompute.
detach

Desanexe o objeto RemoteCompute da área de trabalho associada.

Os objetos de cloud subjacentes não são eliminados, apenas a associação é removida.
get_credentials

Obtenha as credenciais do destino RemoteCompute.
refresh_state

Efetue uma atualização no local das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de cloud correspondente. Isto é utilizado principalmente para consultas manuais do estado de computação.
serialize

Converta este objeto RemoteCompute num dicionário serializado JSON.

attach

PRETERIDO. Em alternativa, utilize o attach_configuration método .

Associe um recurso de computação remota existente à área de trabalho fornecida.

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

Parâmetros

workspace
Workspace
Necessário

O objeto da área de trabalho ao qual associar o recurso de computação.

name
str
Necessário

O nome a associar ao recurso de computação dentro da área de trabalho fornecida. Não tem de corresponder ao nome do recurso de computação a anexar.

username
str
Necessário

O nome de utilizador necessário para aceder ao recurso.

address
str
Necessário

O endereço do recurso a anexar.

ssh_port
int
valor predefinido: 22

A porta exposta do recurso. A predefinição é 22.

password
str
Necessário

A palavra-passe necessária para aceder ao recurso.

private_key_file
str
Necessário

Caminho para um ficheiro que contém a chave privada do recurso.

private_key_passphrase
str
Necessário

Expressão-chave privada necessária para aceder ao recurso.

Devoluções

Uma representação de objeto RemoteCompute do objeto de computação.

Tipo de retorno

RemoteCompute

Exceções

ComputeTargetException

attach_configuration

Crie um objeto de configuração para anexar um destino de computação remoto.

A anexação de uma máquina virtual com o endereço IP público da VM já não é suportada. Em vez disso, utilize o resourceId da VM. O resourceId da VM pode ser construído com o seguinte formato de cadeia: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

Também pode utilizar subscription_id, resource_group e vm_name sem construir resourceId. Para obter mais informações, 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

username
str
Necessário

O nome de utilizador necessário para aceder ao recurso.

subscription_id
str
valor predefinido: None

O ID de subscrição do Azure no qual a máquina virtual está localizada.

resource_group
str
valor predefinido: None

O nome do grupo de recursos no qual a máquina virtual está localizada.

vm_name
str
valor predefinido: None

O nome da máquina virtual.

resource_id
str
valor predefinido: None

O ID de recurso do Azure Resource Manager (ARM) para o recurso existente.

address
str
valor predefinido: None

O endereço do recurso existente.

ssh_port
int
valor predefinido: 22

A porta exposta do recurso. A predefinição é 22.

password
str
Necessário

A palavra-passe necessária para aceder ao recurso.

private_key_file
str
Necessário

Caminho para um ficheiro que contém a chave privada do recurso.

private_key_passphrase
str
Necessário

A expressão-chave privada necessária para aceder ao recurso.

Devoluções

Um objeto de configuração a ser utilizado ao anexar um objeto de Computação.

Tipo de retorno

RemoteComputeAttachConfiguration

Exceções

ComputeTargetException

delete

A eliminação não é suportada para um objeto RemoteCompute. Em vez disso, utilize detach.

delete()

Exceções

ComputeTargetException

deserialize

Converta um objeto JSON num objeto RemoteCompute.

static deserialize(workspace, object_dict)

Parâmetros

workspace
Workspace
Necessário

O objeto de área de trabalho ao que o objeto RemoteCompute está associado.

object_dict
dict
Necessário

Um objeto JSON para converter num objeto RemoteCompute.

Devoluções

A representação RemoteCompute do objeto JSON fornecido.

Tipo de retorno

RemoteCompute

Exceções

ComputeTargetException

Observações

Gera um ComputeTargetException se a área de trabalho fornecida não for a área de trabalho à que a Computação está associada.

detach

Desanexe o objeto RemoteCompute da área de trabalho associada.

Os objetos de cloud subjacentes não são eliminados, apenas a associação é removida.

detach()

Exceções

ComputeTargetException

get_credentials

Obtenha as credenciais do destino RemoteCompute.

get_credentials()

Devoluções

As credenciais do destino RemoteCompute.

Tipo de retorno

dict

Exceções

ComputeTargetException

refresh_state

Efetue uma atualização no local das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de cloud correspondente. Isto é utilizado principalmente para consultas manuais do estado de computação.

refresh_state()

Exceções

ComputeTargetException

serialize

Converta este objeto RemoteCompute num dicionário serializado JSON.

serialize()

Devoluções

A representação JSON deste objeto RemoteCompute.

Tipo de retorno

dict

Exceções

ComputeTargetException