Compartilhar via

Gerenciar workspaces do Azure Machine Learning usando o Azure PowerShell

  • Artigo

Use o módulo Azure PowerShell do Azure Machine Learning para criar e gerenciar seus workspaces do Azure Machine Learning. Para obter uma lista completa dos cmdlets Azure PowerShell para Azure Machine Learning, confira a documentação de referência Az.MachineLearningServices.

Você também pode gerenciar workspaces usando a CLI do Azure, o portal do Azure e o SDK do Python ou por meio da extensão do VS Code.

Pré-requisitos

Entrar no Azure

Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.

Connect-AzAccount

Se você não sabe qual localização deseja usar, você pode listar as localizações disponíveis. Exiba a lista de locais usando o seguinte exemplo de código e encontrar aquele que você deseja usar. Esse exemplo usa eastus. Armazene o local em uma variável e use a variável para que você possa alterá-la em um único local.

Get-AzLocation | Select-Object -Property Location
$Location = 'eastus'

Criar um grupo de recursos

Crie um grupo de recursos do Azure com New-AzResourceGroup. Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.

$ResourceGroup = 'MyResourceGroup'
New-AzResourceGroup -Name $ResourceGroup -Location $Location

Criar recursos de dependência

Um workspace do Azure Machine Learning depende dos seguintes recursos do Azure:

  • Application Insights
  • Cofre de Chave do Azure
  • Conta de Armazenamento do Azure

Use os seguintes comandos a fim de criar esses recursos e recuperar a ID do Azure Resource Manager para cada um deles:

Observação

O provedor de recursos Microsoft.Insights precisa ser registrado na sua assinatura antes de executar os comandos a seguir. Esse é um registro único. Use Register-AzResourceProvider -ProviderNamespace Microsoft.Insights para executar o registro.

  1. Crie a instância do Application Insights:

    $AppInsights = 'MyAppInsights'
New-AzApplicationInsights -Name $AppInsights -ResourceGroupName $ResourceGroup -Location $Location
$appid = (Get-AzResource -Name $AppInsights -ResourceGroupName $ResourceGroup).ResourceId

  2. Crie o Azure Key Vault:

    Importante

    Cada cofre de chaves deve ter um nome exclusivo. Substitua MyKeyVault pelo nome do cofre de chaves no exemplo a seguir.

    $KeyVault = 'MyKeyVault'
New-AzKeyVault -Name $KeyVault -ResourceGroupName $ResourceGroup -Location $Location
$kvid = (Get-AzResource -Name $KeyVault -ResourceGroupName $ResourceGroup).ResourceId

  3. Crie a conta do Armazenamento do Azure:

    Importante

    Cada conta de armazenamento deve ter um nome exclusivo. Substitua MyStorage pelo nome da sua conta de armazenamento no exemplo a seguir. Você pode usar Get-AzStorageAccountNameAvailability -Name 'YourUniqueName' para verificar o nome antes de executar o exemplo a seguir.

    $Storage = 'MyStorage'

$storageParams = @{
  Name = $Storage
  ResourceGroupName = $ResourceGroup
  Location = $Location
  SkuName = 'Standard_LRS'
  Kind = 'StorageV2'
}
New-AzStorageAccount @storageParams

$storeid = (Get-AzResource -Name $Storage -ResourceGroupName $ResourceGroup).ResourceId

Criar um workspace

Observação

O provedor de recursos Microsoft.MachineLearningServices precisa ser registrado na sua assinatura antes de executar os comandos a seguir. Esse é um registro único. Use Register-AzResourceProvider -ProviderNamespace Microsoft.MachineLearningServices para executar o registro.

O comando a seguir cria o workspace e o configura para usar os serviços criados anteriormente. Ele também configura o workspace para usar uma identidade gerenciada atribuída pelo sistema, que é usada para acessar esses serviços. Para saber mais sobre como usar identidades gerenciadas com o Azure Machine Learning, confira o artigo Configurar autenticação para outros serviços.

$Workspace = 'MyWorkspace'
$mlWorkspaceParams = @{
  Name = $Workspace
  ResourceGroupName = $ResourceGroup
  Location = $Location
  ApplicationInsightID = $appid
  KeyVaultId = $kvid
  StorageAccountId = $storeid
  IdentityType = 'SystemAssigned'
}
New-AzMLWorkspace @mlWorkspaceParams

Obter informações do workspace

Para recuperar uma lista de workspaces, use o seguinte comando:

Get-AzMLWorkspace

Para recuperar informações sobre um workspace específico, forneça as informações de nome e grupo de recursos:

Get-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

Excluir um workspace

Aviso

Se a exclusão reversível estiver habilitada para o workspace, ele pode ser recuperado após a exclusão. Se a exclusão reversível não estiver habilitada ou se você selecionar a opção para excluir o workspace permanentemente, ele não poderá ser recuperado. Para mais informações, consulte Recuperar um workspace excluído.

Para excluir um workspace depois que ele não for mais necessário, use o seguinte comando:

Remove-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

Importante

A exclusão de um workspace não exclui o Application Insights, a conta de armazenamento, o cofre de chaves nem o registro de contêiner usado pelo workspace.

Exclua também o grupo de recursos, o que exclui o workspace e todos os outros recursos do Azure no grupo de recursos. Para excluir o grupo de recursos, use o seguinte comando:

Remove-AzResourceGroup -Name $ResourceGroup

Próximas etapas

Para verificar se há problemas com seu espaço de trabalho, confira Como usar o diagnóstico de espaço de trabalho.

Para saber como mover um workspace para uma nova assinatura do Azure, confira Como mover um workspace.

Para obter informações sobre como manter o Azure Machine Learning atualizado com as últimas atualizações de segurança, confira Gerenciamento de vulnerabilidades.

Para saber como treinar um modelo de ML com seu workspace, confira o tutorial Azure Machine Learning em um dia.