Acesse um terminal de instância de computação em seu espaço de trabalho

Acesse o terminal de uma instância de computação em seu workspace para:

• Usar arquivos do Git e da criar versão de meus arquivos. Esses arquivos são armazenados em seu sistema de arquivos do workspace, não restritos a uma única instância de computação.
• Instale pacotes na instância de computação.
• Crie kernels extras na instância de computação.

Pré-requisitos

• Uma assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
• Um Workspace do Machine Learning. Confira Criar recursos de workspace.

Acessar um terminal

Para acessar o terminal:

1. Abra seu workspace no Azure Machine Learning Studio.

2. No lado esquerdo, selecione Notebooks.

3. Selecione a imagem Abrir terminal.

   

4. Quando uma instância de computação está em execução, a janela do terminal dessa instância de computação é exibida.

5. Quando nenhuma instância de computação estiver em execução, use a seção Computação à direita para iniciar ou criar uma instância de computação.

Além das etapas acima, você também pode acessar o terminal de:

• RStudio ou Posit Workbench (anteriormente denominado RStudio Workbench) (consulte Adicionar aplicativos personalizados, como RStudio ou Posit Workbench)): selecione a guia Terminal no canto superior esquerdo.
• Jupyter Lab: selecione o bloco Terminal no cabeçalho Outro na guia Iniciador.
• Jupyter Lab: selecione Novo>Terminal no canto superior direito na guia Arquivos.
• SSH para o computador, se você habilitar o acesso SSH quando a instância de computação foi criada.

Copie e colar no terminal

• Windows: use Ctrl-Insert para copiar e Ctrl-Shift-v ou Shift-Insert para colar.
• Mac OS: Cmd-c para copiar e Cmd-v para colar.
• Talvez o FireFox/IE não dê suporte apropriado a permissões de área de transferência.

Usar arquivos do Git e da criar versão de meus arquivos

Acesse todas as operações do Git no terminal. Todos os arquivos e pastas do Git serão armazenados no sistema de arquivos do workspace. Esse armazenamento permite que você use esses arquivos de qualquer instância de computação em seu workspace.

Observação

Adicione seus arquivos e pastas em qualquer lugar na pasta ~/cloudfiles/code/Users para que eles fiquem visíveis em todos os seus ambientes do Jupyter.

Para integrar o Git ao workspace do Azure Machine Learning, confira Integração do Git para o Azure Machine Learning.

Instalar Pacotes

Instalar pacotes de uma janela do terminal. Instale pacotes no kernel que você deseja usar para executar seus notebooks. O kernel padrão é o python310-sdkv2.

Ou instale pacotes diretamente no Jupyter Notebook, RStudio ou Posit Workbench (anteriormente denominado RStudio Workbench):

• RStudio ou Posit Workbench (consulte Adicionar aplicativos personalizados, como RStudio ou Posit Workbench): use a guia Pacotes na parte inferior direita ou a guia Console no canto superior esquerdo.
• Python: Adicione o código de instalação e execute em uma célula do Jupyter notebook.

Observação

Para o gerenciamento de pacotes em um notebook do Python, use funções magic %pip ou %conda para instalar automaticamente pacotes no kernel atualmente em execução, em vez de !pip ou !conda, que se refere a todos os pacotes (incluindo pacotes fora do kernel atualmente em execução)

Adicionar novos kernels

Aviso

Ao personalizar a instância de computação, não exclua ambientes do conda ou kernels do jupyter que você não criou. Isso poderá danificar a funcionalidade do Jupyter/JupyterLab.

Para adicionar um novo kernel Jupyter à instância de computação:

1. Use a janela do terminal para criar um ambiente. Por exemplo, o código abaixo cria newenv:

   conda create --name newenv
   

2. Ative o ambiente. Por exemplo, depois de criar newenv:

   conda activate newenv
   

3. Instalar o pacote pip e ipykernel no novo ambiente e criar um kernel para esse env conda

   conda install pip
   conda install ipykernel
   python -m ipykernel install --user --name newenv --display-name "Python (newenv)"
   

Qualquer um dos Kernels do Jupyter disponíveis pode ser instalado.

Para adicionar um novo kernel R à instância de computação:

1. Use a janela do terminal para criar um ambiente. Por exemplo, o código abaixo cria r_env:

   conda create -n r_env r-essentials r-base
   

2. Ative o ambiente. Por exemplo, depois de criar r_env:

   conda activate r_env
   

3. Execute o R no novo ambiente:

   R
   

4. No prompt do R, execute IRkernel:

   IRkernel::installspec(name = 'irenv', displayname = 'New R Env')
   

5. Saia da sessão do R.

   q()
   

Levará alguns minutos até que o novo kernel R esteja pronto para ser usado. Se você receber um erro dizendo que é inválido, aguarde e tente novamente.

Para obter mais informações sobre o conda, consulte Usando a linguagem R com o Anaconda. Para obter mais informações sobre o IRkernel, consulte Kernel R nativo para Jupyter.

Remover kernels adicionados

Aviso

Ao personalizar a instância de computação, não exclua ambientes do conda ou kernels do jupyter que você não criou.

Para remover um kernel Jupyter adicionado da instância de computação, você deve remover o kernelspec e (opcionalmente) o ambiente conda. Você também pode optar por manter o ambiente conda. Você deve remover o kernelspec, caso contrário, o kernel ainda será selecionável e causará um comportamento inesperado.

Para remover o kernelspec:

1. Use a janela do terminal para listar e localizar o kernelspec:

   jupyter kernelspec list
   

2. Remova o kernelspec, substituindo UNWANTED_KERNEL pelo kernel que você gostaria de remover:

   jupyter kernelspec uninstall UNWANTED_KERNEL
   

Para remover o ambiente conda também:

1. Use a janela do terminal para listar e localizar o ambiente do conda:

   conda env list
   

2. Remova o ambiente conda, substituindo ENV_NAME pelo ambiente conda que você gostaria de remover:

   conda env remove -n ENV_NAME
   

Após a atualização, a lista de kernel na exibição de notebooks deve refletir as alterações feitas.

Gerenciar sessões de terminal

As sessões de terminal poderão permanecer ativas se as guias do terminal não forem fechadas corretamente. O excesso de sessões de terminal ativas pode afetar o desempenho da instância de computação.

Selecione Gerenciar sessões ativas na barra de ferramentas do terminal para ver uma lista de todas as sessões de terminal ativas e desligue as sessões que você não precisa mais.

Saiba mais sobre como gerenciar sessões em execução na computação em Gerenciar sessões de notebook e de terminal.

Aviso

Lembre-se de fechar as sessões que você não precisa mais para preservar os recursos da instância de computação e otimizar o desempenho.