Exportar um ambiente do Amazon SageMaker Studio Lab para o Amazon SageMaker Studio Classic

O Amazon SageMaker Studio Classic oferece muitos recursos para fluxos de trabalho de aprendizado de máquina e aprendizado profundo que não estão disponíveis no Amazon SageMaker Studio Lab. Esta página mostra como migrar um ambiente do Studio Lab para o Studio Classic para aproveitar mais capacidade computacional, armazenamento e recursos. No entanto, talvez você queira se familiarizar com os contêineres pré-construídos do Studio Classic, que são otimizados para o pipeline MLOP completo. Para obter mais informações, consulte Laboratório Amazon SageMaker Studio.

Para migrar seu ambiente do Studio Lab para o Studio Classic, você deve primeiro integrar-se ao Studio Classic seguindo as etapas apresentadas. Visão geral SageMaker do domínio da Amazon

Etapa 1: exportar seu ambiente conda do Studio Lab

Você pode exportar um ambiente conda e adicionar bibliotecas ou pacotes ao ambiente seguindo as etapas emGerenciar seu ambiente. O exemplo a seguir demonstra o uso do default ambiente a ser exportado para o Studio Classic.

1. Abra o terminal do Studio Lab no painel Navegador de arquivos ( ), escolha o sinal de adição (+) no menu na parte superior do navegador de arquivos para abrir o Inicializador e escolha Terminal. No terminal do Studio Lab, liste os ambientes conda executando o seguinte.

   conda env list

   Esse comando gera uma lista dos ambientes conda e suas localizações no sistema de arquivos. Ao se integrar ao Studio Lab, você ativa automaticamente o ambiente conda studiolab.

   # conda environments: #
              default                  /home/studio-lab-user/.conda/envs/default
              studiolab             *  /home/studio-lab-user/.conda/envs/studiolab
              studiolab-safemode       /opt/amazon/sagemaker/safemode-home/.conda/envs/studiolab-safemode
              base                     /opt/conda

   Recomendamos que você não exporte os ambientes studiolab, studiolab-safemode, e base. Esses ambientes não podem ser usados no Studio Classic pelos seguintes motivos:

   • studiolab: Isso configura o JupyterLab ambiente para o Studio Lab. O Studio Lab executa uma versão principal diferente JupyterLab do Studio Classic, portanto, não pode ser usado no Studio Classic.

   • studiolab-safemode: Isso também configura o JupyterLab ambiente para o Studio Lab. O Studio Lab executa uma versão principal diferente JupyterLab do Studio Classic, portanto, não pode ser usado no Studio Classic.

   • base: Esse ambiente vem com conda por padrão. O base ambiente no Studio Lab e o base ambiente no Studio Classic têm versões incompatíveis de muitos pacotes.

2. Para o ambiente conda que você deseja migrar para o Studio Classic, primeiro ative o ambiente conda. O default ambiente é então alterado quando novas bibliotecas são instaladas ou removidas dele. Para obter o estado exato do ambiente, exporte-o para um arquivo YAML usando a linha de comando. As linhas de comando a seguir exportam o ambiente padrão para um arquivo YAML, criando um arquivo chamado myenv.yml.

   conda activate default
   conda env export > ~/myenv.yml

Etapa 2: Salve seus artefatos do Studio Lab

Agora que você salvou seu ambiente em um arquivo YAML, você pode mover o arquivo de ambiente para qualquer plataforma.

Save to a local machine using Studio Lab GUI

nota

Faça download de um diretório da GUI do Studio Lab clicando com o botão direito do mouse no diretório que está indisponível no momento. Se você quiser exportar um diretório, siga as etapas usando a aba Salvar no repositório Git.

Uma opção é salvar o ambiente em sua máquina local. Para fazer isso, use o procedimento a seguir.

1. No Studio Lab, escolha o ícone Navegador de arquivos ( ) no menu esquerdo para que o painel Navegador de arquivos seja exibido à esquerda.

2. Navegue até seu diretório de usuário escolhendo o ícone de arquivo abaixo da barra de pesquisa de arquivos.

3. Escolha (clique com o botão direito do mouse) o arquivo myenv.yml e escolha Download. Você pode repetir esse processo para outros arquivos que deseja importar para o Studio Classic.

Save to a Git repository

Outra opção é salvar seu ambiente em um repositório Git. Essa opção usa GitHub como exemplo. Essas etapas exigem uma GitHub conta e um repositório. Para obter mais informações, acesse GitHub. O procedimento a seguir mostra como sincronizar seu conteúdo GitHub usando o terminal do Studio Lab.

1. No terminal do Studio Lab, navegue até seu diretório de usuário e crie um novo diretório para conter os arquivos que você deseja exportar.

   cd ~
   mkdir <NEW_DIRECTORY_NAME>

2. Depois de criar um novo diretório, copie qualquer arquivo ou diretório que você deseja exportar para <NEW_DIRECTORY_NAME>.

   Copie um arquivo usando o seguinte formato de código:

   cp <FILE_NAME> <NEW_DIRECTORY_NAME>

   Por exemplo, substituindo <FILE_NAME> por myenv.yml.

   Copie um diretório usando o seguinte formato de código:

   cp -r <DIRECTORY_NAME> <NEW_DIRECTORY_NAME>

   Por exemplo, substitua <DIRECTORY_NAME> por qualquer nome de diretório em seu diretório de usuário.

3. Navegue até o novo diretório e inicialize o diretório como um repositório Git usando o comando a seguir. Para obter mais informações, consulte a documentação de git-init.

   cd <NEW_DIRECTORY_NAME>
   git init

4. Usando o Git, adicione todos os arquivos relevantes e, em seguida, confirme suas alterações.

   git add .
   git commit -m "<COMMIT_MESSAGE>"

   Por exemplo, substituindo <COMMIT_MESSAGE> por Add Amazon SageMaker Studio Lab artifacts to GitHub repository to migrate to Amazon SageMaker Studio Classic .

5. Envie a confirmação para o repositório remoto. Esse repositório tem o formato https://github.com/<GITHUB_USERNAME>/ <REPOSITORY_NAME>.git em que <GITHUB_USERNAME> está seu nome de GitHub usuário e o <REPOSITORY_NAME> nome do seu repositório remoto. Crie uma ramificação <BRANCH_NAME> para enviar o conteúdo para o GitHub repositório.

   git branch -M <BRANCH_NAME>
   git remote add origin https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git
   git push -u origin <BRANCH_NAME>

Etapa 3: importar seus artefatos do Studio Lab para o Studio Classic

O procedimento a seguir mostra como importar artefatos para o Studio Classic. As instruções sobre como usar a Feature Store por meio do console dependem de você ter habilitado o Studio ou o Studio Classic como sua experiência padrão. Para obter informações sobre como acessar o Studio Classic por meio do console, consulteInicie o Studio Classic se o Studio for sua experiência padrão.

No Studio Classic, você pode importar arquivos da sua máquina local ou de um repositório Git. Você pode fazer isso usando a GUI ou o terminal do Studio Classic. O procedimento a seguir usa os exemplos de Etapa 2: Salve seus artefatos do Studio Lab.

Import using the Studio Classic GUI

Se você salvou os arquivos em sua máquina local, poderá importá-los para o Studio Classic usando as etapas a seguir.

1. Abra o painel Navegador de arquivos ( ) no canto superior esquerdo do Studio Classic.

2. Escolha o ícone Carregar arquivos ( ) no menu na parte superior do painel Navegador de arquivos.

3. Navegue até o arquivo que você deseja importar e escolha Abrir.

nota

Para importar um diretório para o Studio Classic, primeiro compacte o diretório em sua máquina local em um arquivo. Em um Mac, clique com o botão direito do mouse no diretório e escolha Compactar "<DIRECTORY_NAME>". No Windows, clique com o botão direito do mouse no diretório e escolha Enviar para e, então, selecione Pasta compactada (zipada). Depois que o diretório for compactado, importe o arquivo compactado usando as etapas anteriores. Descompacte o arquivo compactado navegando até o terminal do Studio Classic e executando o comando. <DIRECTORY_NAME>.zip

Import using a Git repository

Este exemplo fornece duas opções de como clonar um GitHub repositório no Studio Classic. Você pode usar a GUI do Studio Classic escolhendo a guia Git () no lado esquerdo do Studio Classic. Escolha Clonar um repositório e cole a URL do seu GitHub repositório. Etapa 2: Salve seus artefatos do Studio Lab Outra opção é usar o terminal Studio Classic usando o procedimento a seguir.

1. Abra o Studio Classic Launcher. Para obter mais informações sobre como abrir o Launcher, consulte Amazon SageMaker Studio Classic Launcher.

2. No Inicializador, na seção Cadernos e recursos de computação, escolha Alterar ambiente.

3. No Studio Classic, abra o Launcher. Para abrir o Launcher, escolha Amazon SageMaker Studio Classic no canto superior esquerdo do Studio Classic.

   Para saber mais sobre todas as formas disponíveis para abrir o Inicializador, consulte Use o Amazon SageMaker Studio Classic Launcher.

4. Na caixa de diálogo Alterar ambiente, use a lista suspensa Imagem para selecionar a imagem da Ciência de Dados e escolha Selecionar. Essa imagem vem com o conda pré-instalado.

5. No Studio Classic Launcher, escolha Abrir terminal de imagem.

6. No terminal de imagem, execute o seguinte comando para clonar o repositório. Esse comando cria um diretório com o nome <REPOSITORY_NAME> de sua instância do Studio Classic e clona seus artefatos nesse repositório.

   git clone https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git

Etapa 4: instalar seus ambientes Studio Lab conda no Studio Classic

Agora você pode recriar seu ambiente conda usando seu arquivo YAML na sua instância do Studio Classic. Abra o Studio Classic Launcher. Para obter mais informações sobre como abrir o Launcher, consulte Amazon SageMaker Studio Classic Launcher. No Inicializador, escolha Abrir terminal de imagem. No terminal, navegue até o diretório que contém o arquivo YAML e execute os seguintes comandos.

conda env create --file <ENVIRONMENT_NAME>.yml
conda activate <ENVIRONMENT_NAME>

Depois que esses comandos forem concluídos, você poderá selecionar seu ambiente como kernel para as instâncias do notebook Studio Classic. Para ver o ambiente disponível, execute conda env list. Para ativar seu ambiente, execute conda activate <ENVIRONMENT_NAME>.