RemoteCompute Classe

Gerencia um destino de computação remoto para uso no Aprendizado de Máquina do Azure.

O Azure Machine Learning dá suporte ao uso da anexação de um recurso de computação remota ao seu espaço de trabalho. O recurso remoto pode ser uma VM do Azure, um servidor remoto na 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?

Classe ComputeTarget construtor.

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

Construtor

RemoteCompute(workspace, name)

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto de espaço de trabalho que contém o objeto RemoteCompute a ser recuperado.
name Necessário	str O nome do objeto RemoteCompute a ser recuperado.
workspace Necessário	Workspace O objeto de espaço de trabalho que contém o objeto Compute a ser recuperado.
name Necessário	str O nome do objeto Compute a ser recuperado.

Observações

As seguintes regiões do Azure não suportam o uso do endereço IP público de uma máquina virtual ou cluster 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, 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 máquina virtual de ciência de dados (DSVM) 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)

A amostra completa 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 `attach_configuration` método em vez disso. Associe um recurso de computação remota existente ao espaço de trabalho fornecido.
attach_configuration	Crie um objeto de configuração para anexar um destino de computação remoto. Não há mais suporte para anexar uma máquina virtual usando o endereço IP público da VM. Em vez disso, use o resourceId da VM. O resourceId da VM pode ser construído 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 Delete para um objeto RemoteCompute. Utilize detach em substituição.
deserialize	Converter um objeto JSON em um objeto RemoteCompute.
detach	Desanexe o objeto RemoteCompute de seu espaço de trabalho associado. Os 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. Este 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 este objeto RemoteCompute em um dicionário serializado JSON.

attach

PRETERIDO. Use o attach_configuration método em vez disso.

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

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

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto de espaço de trabalho ao qual associar o recurso de computação.
name Necessário	str O nome a ser associado ao recurso de computação dentro do espaço de trabalho fornecido. Não precisa corresponder ao nome do recurso de computação a ser anexado.
username Necessário	str O nome de usuário necessário para acessar o recurso.
address Necessário	str O endereço do recurso a anexar.
ssh_port	int A porta exposta para o recurso. O padrão é 22. Default value: 22
password Necessário	str A senha necessária para acessar o recurso.
private_key_file Necessário	str Caminho para um arquivo que contém a chave privada para o recurso.
private_key_passphrase Necessário	str Frase-chave privada necessária para acessar o recurso.

Devoluções

Tipo	Description
RemoteCompute	Uma representação do 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 remoto.

Não há mais suporte para anexar uma máquina virtual usando o endereço IP público da VM. Em vez disso, use o resourceId da VM. O resourceId da VM pode ser construído 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

Name	Description
username Necessário	str O nome de usuário necessário para acessar o recurso.
subscription_id	str A ID de assinatura do Azure na qual a máquina virtual está localizada. Default value: None
resource_group	str O nome do grupo de recursos no qual a máquina virtual está localizada. Default value: None
vm_name	str O nome da máquina virtual. Default value: None
resource_id	str A ID de recurso do Azure Resource Manager (ARM) para o recurso existente. Default value: None
address	str O endereço do recurso existente. Default value: None
ssh_port	int A porta exposta para o recurso. O padrão é 22. Default value: 22
password Necessário	str A senha necessária para acessar o recurso.
private_key_file Necessário	str Caminho para um arquivo que contém a chave privada para o recurso.
private_key_passphrase Necessário	str A frase-chave privada necessária para acessar o recurso.

Devoluções

Tipo	Description
RemoteComputeAttachConfiguration	Um objeto de configuração a ser usado ao anexar um objeto Compute.

delete

Não há suporte para Delete para um objeto RemoteCompute. Utilize detach em substituição.

delete()

Exceções

Tipo	Description
ComputeTargetException

deserialize

Converter um objeto JSON em um objeto RemoteCompute.

static deserialize(workspace, object_dict)

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto de espaço de trabalho ao qual o objeto RemoteCompute está associado.
object_dict Necessário	dict Um objeto JSON para converter em um objeto RemoteCompute.

Devoluções

Tipo	Description
RemoteCompute	A representação RemoteCompute do objeto JSON fornecido.

Exceções

Tipo	Description
ComputeTargetException

Observações

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

detach

Desanexe o objeto RemoteCompute de seu espaço de trabalho associado.

Os 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()

Devoluções

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.

Este 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 este objeto RemoteCompute em um dicionário serializado JSON.

serialize()

Devoluções

Tipo	Description
dict	A representação JSON deste objeto RemoteCompute.

Feedback

Esta página foi útil?

Partilhar via

RemoteCompute Classe

Construtor

Parâmetros

Observações

Métodos

attach

Parâmetros

Devoluções

Exceções

attach_configuration

Parâmetros

Devoluções

delete

Exceções

deserialize

Parâmetros

Devoluções

Exceções

Observações

detach

Exceções

get_credentials

Devoluções

Exceções

refresh_state

serialize

Devoluções

Feedback