Gerenciar workspaces do Azure Machine Learning usando o Azure PowerShell

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

• Uma assinatura do Azure. Se você não tiver uma, experimente a versão paga ou gratuita do Azure Machine Learning.

• O módulo Azure PowerShell. Para verificar se você tem a versão mais recente, confira Instalar o módulo Azure PowerShell.

  Importante

  Enquanto o módulo Az.MachineLearningServices do PowerShell estiver em versão prévia, você precisará instalá-lo separadamente usando o cmdlet Install-Module.

  Install-Module -Name Az.MachineLearningServices -Scope CurrentUser -Repository PSGallery -Force
  

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:

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

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

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

Remove-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

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.