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

Name	Description
workspace Necessário	Workspace O objeto da área de trabalho que contém o objeto RemoteCompute a obter.
name Necessário	str O nome do objeto RemoteCompute a obter.
workspace Necessário	Workspace O objeto da área de trabalho que contém o objeto Computação a obter.
name Necessário	str 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

Name	Description
workspace Necessário	Workspace O objeto da área de trabalho ao qual associar o recurso de computação.
name Necessário	str 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 Necessário	str O nome de utilizador necessário para aceder ao recurso.
address Necessário	str O endereço do recurso a anexar.
ssh_port	int A porta exposta do recurso. A predefinição é 22. Default value: 22
password Necessário	str A palavra-passe necessária para aceder ao recurso.
private_key_file Necessário	str Caminho para um ficheiro que contém a chave privada do recurso.
private_key_passphrase Necessário	str Expressão-chave privada necessária para aceder ao recurso.

Devoluções

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 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

Name	Description
username Necessário	str O nome de utilizador necessário para aceder ao recurso.
subscription_id	str O ID de subscrição do Azure no 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 O 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 do recurso. A predefinição é 22. Default value: 22
password Necessário	str A palavra-passe necessária para aceder ao recurso.
private_key_file Necessário	str Caminho para um ficheiro que contém a chave privada do recurso.
private_key_passphrase Necessário	str A expressão-chave privada necessária para aceder ao recurso.

Devoluções

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

Exceções

Tipo	Description
ComputeTargetException

delete

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

delete()

Exceções

Tipo	Description
ComputeTargetException

deserialize

Converta um objeto JSON num objeto RemoteCompute.

static deserialize(workspace, object_dict)

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto de área de trabalho ao que o objeto RemoteCompute está associado.
object_dict Necessário	dict Um objeto JSON para converter num 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 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

Tipo	Description
ComputeTargetException

get_credentials

Obtenha as credenciais do destino RemoteCompute.

get_credentials()

Devoluções

Tipo	Description
dict	As credenciais do destino RemoteCompute.

Exceções

Tipo	Description
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

Tipo	Description
ComputeTargetException

serialize

Converta este objeto RemoteCompute num dicionário serializado JSON.

serialize()

Devoluções

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

Exceções

Tipo	Description
ComputeTargetException

Partilhar via

RemoteCompute Classe

Construtor

Parâmetros

Observações

Métodos

attach

Parâmetros

Devoluções

Exceções

attach_configuration

Parâmetros

Devoluções

Exceções

delete

Exceções

deserialize

Parâmetros

Devoluções

Exceções

Observações

detach

Exceções

get_credentials

Devoluções

Exceções

refresh_state

Exceções

serialize

Devoluções

Exceções

Comentários

Recursos adicionais