RemoteCompute Classe

  • Referência

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

O Azure Machine Learning dá suporte à 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 para o Azure Machine Learning. Para obter mais informações, confira 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 Compute associado ao workspace fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto Compute recuperado.

Herança
ComputeTarget
RemoteCompute

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 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 criada usando a ID da assinatura, o grupo de recursos e o nome da VM, com o seguinte formato de cadeia de caracteres: /subscriptions/<id_da_assinatura>/resourceGroups/<grupo_de_recursos>/ providers/Microsoft.Compute/virtualMachines/<nome_da_vm>.

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

PRETERIDO. Use o método attach_configuration em seu lugar.

Associa um recurso de computação remota existente com o workspace fornecido.
attach_configuration

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

Não há mais suporte para a anexação de 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 criada usando o seguinte formato de cadeia de caracteres: "/subscriptions/<id_da_assinatura>/resourceGroups/<grupo_de_recursos>/ providers/Microsoft.Compute/virtualMachines/<nome_da_vm>".

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

Não há suporte para delete para um objeto RemoteCompute. Use detach em vez disso.
deserialize

Converte um objeto JSON em um objeto RemoteCompute.
detach

Desconecta o objeto RemoteCompute do workspace associado a ele.

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

Recupera as credenciais para o destino RemoteCompute.
refresh_state

Executar uma atualização local 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

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

attach

PRETERIDO. Use o método attach_configuration em seu lugar.

Associa um recurso de computação remota existente com o 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. Esse nome 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. Usa 22 como o valor padrão.

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
RemoteCompute

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

Exceções

Tipo Description
ComputeTargetException

attach_configuration

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

Não há mais suporte para a anexação de 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 criada usando o seguinte formato de cadeia de caracteres: "/subscriptions/<id_da_assinatura>/resourceGroups/<grupo_de_recursos>/ providers/Microsoft.Compute/virtualMachines/<nome_da_vm>".

Você também pode usar id_da_assinatura, grupo_de_recursos e nome_da_vm 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. Usa 22 como o valor padrão.

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 de computação.

Exceções

Tipo Description
ComputeTargetException

delete

Não há suporte para delete para um objeto RemoteCompute. Use detach em vez disso.

delete()

Exceções

Tipo Description
ComputeTargetException

deserialize

Converte 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 objeto RemoteCompute.

Retornos

Tipo Description
RemoteCompute

A representação RemoteCompute do objeto JSON fornecido.

Exceções

Tipo Description
ComputeTargetException

Comentários

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

detach

Desconecta o objeto RemoteCompute do workspace associado a ele.

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

detach()

Exceções

Tipo Description
ComputeTargetException

get_credentials

Recupera 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

Executar uma atualização local 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()

Exceções

Tipo Description
ComputeTargetException

serialize

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

serialize()

Retornos

Tipo Description
dict

A representação JSON desse objeto RemoteCompute.

Exceções

Tipo Description
ComputeTargetException