RemoteCompute Classe
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
-
RemoteCompute
Construtor
RemoteCompute(workspace, name)
Parâmetros
- workspace
- Workspace
O objeto de workspace que contém o objeto RemoteCompute 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 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
- name
- 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.
Retornos
Uma representação de objeto RemoteCompute do objeto de computação.
Tipo de retorno
Exceções
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
- subscription_id
- str
A ID da assinatura do Azure na qual a máquina virtual está localizada.
- resource_group
- str
O nome do grupo de recursos no qual a máquina virtual está localizada.
- resource_id
- str
A ID de recurso do ARM (Azure Resource Manager) para o recurso existente.
Retornos
Um objeto de configuração a ser usado ao anexar um objeto de computação.
Tipo de retorno
Exceções
delete
deserialize
Converte um objeto JSON em um objeto RemoteCompute.
static deserialize(workspace, object_dict)
Parâmetros
- workspace
- Workspace
O objeto de workspace ao qual o objeto RemoteCompute está associado.
Retornos
A representação RemoteCompute do objeto JSON fornecido.
Tipo de retorno
Exceções
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
get_credentials
Recupera as credenciais para o destino RemoteCompute.
get_credentials()
Retornos
As credenciais para o destino RemoteCompute.
Tipo de retorno
Exceções
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
serialize
Converte esse objeto RemoteCompute em um dicionário serializado JSON.
serialize()
Retornos
A representação JSON desse objeto RemoteCompute.
Tipo de retorno
Exceções
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de