Compartilhar via

RemoteCompute Classe

Gerencia um destino de computação remota para uso no Azure Machine Learning.

O Azure Machine Learning dá suporte ao uso da anexação de um recurso de computação remota ao seu workspace. O recurso remoto pode ser uma VM do Azure, um servidor remoto em sua organização ou local, desde que o recurso esteja acessível ao Azure Machine Learning. Para obter mais informações, consulte O que são destinos de computação no Azure Machine Learning?

Construtor computeTarget de classe.

Recupere uma representação na nuvem de um objeto de computação associado ao workspace fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto compute recuperado.

Construtor

RemoteCompute(workspace, name)

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto de workspace que contém o objeto RemoteCompute a ser recuperado.
name
Obrigatório
str

O nome do objeto RemoteCompute a ser recuperado.
workspace
Obrigatório
Workspace

O objeto de workspace que contém o objeto Compute a ser recuperado.
name
Obrigatório
str

O nome do objeto Compute a ser recuperado.

Comentários

As regiões do Azure a seguir não dão suporte ao uso do endereço IP público de uma máquina virtual ou cluster HDInsight para anexar o destino de computação.

  • Leste dos EUA

  • Oeste dos EUA 2

  • Centro-Sul dos EUA

Em vez disso, use a ID do Azure Resource Manager da VM ou do cluster HDInsight. A ID do recurso da VM pode ser construída usando a ID da assinatura, o nome do grupo de recursos e o nome da VM usando o seguinte formato de cadeia de caracteres: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

O exemplo a seguir mostra como criar e anexar uma DSVM (Máquina Virtual de Ciência de Dados) como um 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 em https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Métodos

attach

DEPRECADO. Em vez disso, use o attach_configuration método.

Associe um recurso de computação remota existente ao workspace fornecido.
attach_configuration

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

Não há mais suporte para anexar uma máquina virtual usando o endereço IP público da VM. Em vez disso, use a resourceId da VM. A resourceId da VM pode ser construída usando o seguinte formato de cadeia de caracteres: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>".

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

Não há suporte para Exclusão para um objeto RemoteCompute. Use detach em seu lugar.
deserialize

Converta um objeto JSON em um objeto RemoteCompute.
detach

Desanexe o objeto RemoteCompute de seu workspace associado.

Objetos de nuvem subjacentes não são excluídos, apenas a associação é removida.
get_credentials

Recupere as credenciais para o destino RemoteCompute.
refresh_state

Execute uma atualização in-loco das propriedades do objeto.

Esse método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é usado principalmente para sondagem manual do estado de computação.
serialize

Converta esse objeto RemoteCompute em um dicionário serializado JSON.

attach

DEPRECADO. Em vez disso, use o attach_configuration método.

Associe um recurso de computação remota existente ao workspace fornecido.

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

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto de workspace ao qual associar o recurso de computação.
name
Obrigatório
str

O nome a ser associado ao recurso de computação dentro do workspace fornecido. Não precisa corresponder ao nome do recurso de computação a ser anexado.
username
Obrigatório
str

O nome de usuário necessário para acessar o recurso.
address
Obrigatório
str

O endereço do recurso a ser anexado.
ssh_port
int

A porta exposta para o recurso. O padrão é 22.

Valor padrão: 22
password
Obrigatório
str

A senha necessária para acessar o recurso.
private_key_file
Obrigatório
str

Caminho para um arquivo que contém a chave privada para o recurso.
private_key_passphrase
Obrigatório
str

Frase-chave privada necessária para acessar o recurso.

Retornos

Tipo Description
RemoteCompute

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

Exceções

Tipo Description
ComputeTargetException

attach_configuration

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

Não há mais suporte para anexar uma máquina virtual usando o endereço IP público da VM. Em vez disso, use a resourceId da VM. A resourceId da VM pode ser construída usando o seguinte formato de cadeia de caracteres: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>".

Você também pode usar 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

Nome Description
username
Obrigatório
str

O nome de usuário necessário para acessar o recurso.
subscription_id
str

A ID da assinatura do Azure na qual a máquina virtual está localizada.

Valor padrão: None
resource_group
str

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

Valor padrão: None
vm_name
str

O nome da máquina virtual.

Valor padrão: None
resource_id
str

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

Valor padrão: None
address
str

O endereço do recurso existente.

Valor padrão: None
ssh_port
int

A porta exposta para o recurso. O padrão é 22.

Valor padrão: 22
password
Obrigatório
str

A senha necessária para acessar o recurso.
private_key_file
Obrigatório
str

Caminho para um arquivo que contém a chave privada para o recurso.
private_key_passphrase
Obrigatório
str

A frase-chave privada necessária para acessar o recurso.

Retornos

Tipo Description
RemoteComputeAttachConfiguration

Um objeto de configuração a ser usado ao anexar um objeto compute.

delete

Não há suporte para Exclusão para um objeto RemoteCompute. Use detach em seu lugar.

delete()

Exceções

Tipo Description
ComputeTargetException

deserialize

Converta um objeto JSON em um objeto RemoteCompute.

static deserialize(workspace, object_dict)

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto de workspace ao qual o objeto RemoteCompute está associado.
object_dict
Obrigatório
dict

Um objeto JSON a ser convertido em um objeto RemoteCompute.

Retornos

Tipo Description
RemoteCompute

A representação RemoteCompute do objeto JSON fornecido.

Exceções

Tipo Description
ComputeTargetException

Comentários

Gera um ComputeTargetException se o workspace fornecido não for o workspace ao qual a computação está associada.

detach

Desanexe o objeto RemoteCompute de seu workspace associado.

Objetos de nuvem subjacentes não são excluídos, apenas a associação é removida.

detach()

Exceções

Tipo Description
ComputeTargetException

get_credentials

Recupere as credenciais para o destino RemoteCompute.

get_credentials()

Retornos

Tipo Description
dict

As credenciais para o destino RemoteCompute.

Exceções

Tipo Description
ComputeTargetException

refresh_state

Execute uma atualização in-loco das propriedades do objeto.

Esse método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é usado principalmente para sondagem manual do estado de computação.

refresh_state()

serialize

Converta esse objeto RemoteCompute em um dicionário serializado JSON.

serialize()

Retornos

Tipo Description
dict

A representação JSON deste objeto RemoteCompute.