Iniciar Visual Studio Code integrado ao Azure Machine Learning

Neste artigo, você aprende a fazer inicialização do Visual Studio Code remotamente conectado a uma instância de computação do Azure Machine Learning. Use o VS Code como seu ambiente de desenvolvimento integrado (IDE) com o poder dos recursos do Azure Machine Learning. Use o VS Code no navegador com o VS Code para a Web ou use o aplicativo para desktop do VS Code.

Há duas maneiras de se conectar a uma instância de computação pelo Visual Studio Code. Recomendamos a primeira abordagem.

1. Use o VS Code como seu ambiente de desenvolvimento integrado (IDE) do workspace. Essa opção fornece um ambiente de desenvolvimento completo para a criação de projetos de aprendizado de máquina.

   • Você pode abrir o VS Code em seu workspace no VS Code para a Web do navegador ou no VS Code Desktop do aplicativo para desktop.
   • Recomendamos o VS Code para a Web, pois você pode fazer todo o trabalho de aprendizado de máquina diretamente do navegador e sem nenhuma instalação obrigatória ou dependências.

2. Servidor do Jupyter Notebook remoto. Essa opção permite que você defina uma instância de computação como um servidor do Jupyter Notebook remoto. Essa opção só está disponível no VS Code (Desktop).

Importante

Para se conectar a uma instância de computação protegida por um firewall, consulte Configurar o tráfego de rede de entrada e saída.

Pré-requisitos

Antes de começar, você precisa do:

1. Um workspace do Azure Machine Learning e uma instância de computação. Conclua Criar recursos necessários para começar para criá-los.
2. Entre no estúdio e selecione seu workspace, caso ainda não esteja aberto.

Usar o VS Code como seu IDE do workspace

Use uma dessas opções para conectar o VS Code à instância de computação e aos arquivos do workspace.

Studio –> VS Code (Web)

O VS Code para a Web fornece um ambiente de desenvolvimento completo para criar seus projetos de aprendizado de máquina, todos a partir do navegador e sem instalações obrigatórias ou dependências. E, ao conectar sua instância de computação do Azure Machine Learning, você obtém as ofertas avançadas e integradas de experiência de desenvolvimento do VS Code, aprimoradas pelo poder do Azure Machine Learning.

Faça a inicialização do VS Code para a Web com uma seleção a partir do Estúdio do Azure Machine Learning e continue perfeitamente seu trabalho.

Entre no Estúdio do Azure Machine Learning e siga as etapas para fazer a inicialização de uma guia do navegador para o VS Code (Web), conectada à instância de computação do Azure Machine Learning.

Você pode criar a conexão na seção Notebooks ou Computação do Estúdio do Azure Machine Learning.

• Notebooks

  1. Selecione a guia Notebooks.

  2. Na guia Notebooks, selecione o arquivo que deseja editar.

  3. Se a instância de computação for interrompida, selecione Iniciar computação e aguarde até que ela esteja em execução.

     

  4. Selecione Editores > Editar no VS Code (Web).

  

• Computação

  1. Selecione a guia Computação
  2. Se a instância de computação que você deseja usar for interrompida, selecione-a e, em seguida, selecione Iniciar.
  3. Depois que a instância de computação estiver em execução, na coluna Aplicativos , selecione VS Code (Web).

  

Se você não vir essas opções, certifique-se de habilitar a versão prévia do recurso Conectar instâncias de computação ao Visual Studio Code para a Web, conforme mostrado na seção Pré-requisitos.

Studio –> VS Code (Desktop)

Esta opção inicia o aplicativo para desktop do VS Code, conectado à instância de computação.

Na conexão inicial, você poderá ser solicitado a instalar a extensão do Visual Studio Code do Azure Machine Learning, se ainda não a tiver. Para obter mais informações, consulte Guia de configuração da extensão do Visual Studio Code do Azure Machine Learning.

Importante

Para se conectar à instância de computação remota do Visual Studio Code, verifique se a conta na qual está conectado no Azure Machine Learning Studio é a mesma que usa no Visual Studio Code.

Navegue até ml.azure.com

Você pode criar a conexão na seção Notebooks ou Computação do Estúdio do Azure Machine Learning.

• Notebooks

  1. Selecione a guia Notebooks

  2. Na guia Notebooks, selecione o arquivo que deseja editar.

  3. Se a instância de computação for interrompida, selecione Iniciar computação e aguarde até que ela esteja em execução.

     

  4. Selecione Editar no VS Code (Desktop).

     

  5. Você também pode iniciar o VS Code (Web) sem abrir um notebook, na barra de comandos do explorador de arquivos ou no menu de ação em uma pasta no explorador de arquivos

     

• Computação

  1. Selecione a guia Computação.
  2. Se a instância de computação que você deseja usar for interrompida, selecione-a e, em seguida, selecione Iniciar.
  3. Depois que a instância de computação estiver em execução, na coluna Aplicativosexecução, selecione VS Code (Web).

  

A partir do VS Code

Esta opção conecta a sua sessão atual do VS Code a uma instância de computação remota. Para se conectar à instância de computação a partir do VS Code, você precisa instalar a extensão do Visual Studio Code do Azure Machine Learning. Para obter mais informações, consulte Guia de configuração da extensão do Visual Studio Code do Azure Machine Learning.

Extensão do Azure Machine Learning

1. No VS Code, inicie a extensão do Azure Machine Learning.
2. Expanda o nó Instâncias de computação em sua extensão.
3. Clique com o botão direito do mouse na instância de computação à qual deseja se conectar e selecione Conectar à Instância de computação.

Paleta de Comandos

1. No VS Code, abra a paleta de comandos selecionando Exibição > Paleta de Comandos.
2. Insira na caixa de texto AzureML: Conectar-se à Instância de Computação.
3. Selecione sua assinatura.
4. Selecione o workspace.
5. Selecione sua instância de computação ou crie uma.

Se você escolher uma das experiências de clique, uma nova janela do VS Code será aberta, e uma tentativa de conexão com a instância de computação remota será feita. Ao tentar fazer essa conexão, as etapas a seguir serão realizadas:

1. Autorização. Algumas verificações são executadas para garantir que o usuário que está tentando estabelecer uma conexão esteja autorizado a usar a instância de computação.
2. O servidor remoto VS Code está instalado na instância de computação.
3. Uma conexão WebSocket é estabelecida para interação em tempo real.

Depois que a conexão é estabelecida, ela é persistida. Um token é emitido no início da sessão, que é atualizada automaticamente para manter a conexão com a instância de computação.

Depois de se conectar à instância de computação remota, use o editor para:

• Criar e gerenciar arquivos na instância de computação remota ou compartilhar arquivos.
• Usar o terminal integrado do VS Code para executar comandos e aplicativos na instância de computação remota.
• Depurar scripts e aplicativos
• Usar VS Code para gerenciar repositórios Git

Servidor do Jupyter Notebook remoto

Essa opção permite que você use uma instância de computação como um servidor de Jupyter Notebook remoto de Visual Studio Code (Desktop). Essa opção se conecta somente à instância de computação, não ao restante do workspace. Você não verá seus arquivos do workspace no VS Code ao usar essa opção.

Para configurar uma instância de computação como um servidor de Jupyter Notebook remoto, primeiramente instale:

• Extensão do Azure Machine Learning para Visual Studio Code. Para obter mais informações, consulte Guia de configuração da extensão do Visual Studio Code do Azure Machine Learning.

Para conectar-se a uma instância de computação:

1. Abra um Jupyter Notebook no Visual Studio Code.

2. Quando a experiência do notebook integrado for carregada, escolha Selecionar Kernel.

   

   Como alternativa, use a paleta de comandos:

   1. Selecione Exibição > Paleta de Comandos na barra de menus para abrir a paleta de comandos.
   2. Digite AzureML: Connect to Compute instance Jupyter server na caixa de texto.

3. Escolha Azure ML Compute Instances na lista de opções do servidor Jupyter.

4. Selecione sua assinatura na lista de assinaturas. Se o workspace do Azure Machine Learning padrão tiver sido configurado anteriormente, essa etapa será ignorada.

5. Selecione o workspace.

6. Selecione a instância de computação na lista. Caso não tenha uma, selecione Criar Instância de Computação do Azure Machine Learning e siga os avisos para criar uma.

7. Para que as alterações entrem em vigor, é necessário recarregar o Visual Studio Code.

8. Abra um Jupyter Notebook e execute uma célula.

Importante

É NECESSÁRIO executar uma célula para estabelecer a conexão.

Neste ponto, é possível continuar a executar células no Jupyter Notebook.

Dica

Também é possível trabalhar com arquivos de script do Python (.py) que contêm células de código do tipo Jupyter. Para obter mais informações, consulte a documentação interativa do Visual Studio Code Python.

Próximas etapas

Agora que você iniciou o Visual Studio Code conectado remotamente a uma instância de computação, você pode preparar seus dados, editar e depurar seu código e enviar trabalhos de treinamento com a extensão do Azure Machine Learning.

Para saber mais sobre como aproveitar ao máximo o VS Code integrado ao Azure Machine Learning, confira Trabalhar no VS Code conectado remotamente a uma instância de computação (versão prévia).