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

Compartilhar via

RemoteCompute Classe

Construtor

Parâmetros

Comentários

Métodos

attach

Parâmetros

Retornos

Exceções

attach_configuration

Parâmetros

Retornos

Exceções

delete

Exceções

deserialize

Parâmetros

Retornos

Exceções

Comentários

detach

Exceções

get_credentials

Retornos

Exceções

refresh_state

Exceções

serialize

Retornos

Exceções

Comentários

Recursos adicionais