Use recursos externos no Amazon SageMaker Studio Lab

Com o Amazon SageMaker Studio Lab, você pode integrar recursos externos, como notebooks e dados Jupyter, dos repositórios Git e do Amazon S3. Você também pode adicionar um botão Abrir no Studio Lab ao seu GitHub repositório e cadernos. Esse botão permite clonar seus cadernos diretamente do Studio Lab.

Os tópicos a seguir mostram como integrar recursos externos.

Use GitHub recursos

O Studio Lab oferece integração com GitHub. Com essa integração, você pode clonar cadernos e repositórios diretamente no seu projeto do Studio Lab.

Os tópicos a seguir fornecem informações sobre como usar GitHub recursos com o Studio Lab.

Cadernos de exemplo do Studio Lab

Para começar com um repositório de cadernos de exemplos personalizados para o Studio Lab, consulte Cadernos de Exemplo do Studio Lab.

Esse repositório fornece cadernos para os seguintes casos de uso e outros.

• Visão computacional

• Conectando-se a AWS

• Criar ambientes personalizados

• Análise de dados geoespaciais

• Processamento de linguagem natural

• Usando R

Clonar um repositório GitHub

Para clonar um GitHub repositório em seu projeto do Studio Lab, siga estas etapas.

1. Inicie o tempo de execução do seu projeto do Studio Lab. Para obter mais informações sobre como iniciar o tempo de execução do projeto Studio Lab, consulte Inicie o runtime do projeto.

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

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

4. Selecione o ícone do Git ( ) no menu à esquerda para abrir um novo menu suspenso.

5. Escolha Clonar um repositório.

6. Cole o repositório no repositório URL Git (.git)URL.

7. Selecione Clonar.

Clone cadernos individuais de GitHub

Para abrir um caderno no Studio Lab, você deve ter acesso ao repositório no qual o caderno está. Os exemplos a seguir descrevem o comportamento relacionado à permissão do Studio Lab em várias situações.

• Se um repositório for público, você poderá clonar automaticamente o caderno em seu projeto a partir da página de pré-visualização do Studio Lab.

• Se um repositório for privado, você será solicitado a entrar na página de pré-visualização GitHub do Studio Lab. Se você tiver acesso a um repositório privado, poderá clonar o caderno em seu projeto.

• Se você não tiver acesso a um repositório privado, não poderá clonar o caderno na página de pré-visualização do Studio Lab.

As seções a seguir mostram duas opções para você copiar um GitHub caderno em seu projeto do Studio Lab. Essas opções dependem se o caderno tem um botão Abrir no Studio Lab.

Opção 1: Copiar caderno com um botão Abrir no Studio Lab

O procedimento a seguir mostra como copiar um caderno que tenha um botão Abrir no Studio Lab. Se você quiser adicionar esse botão ao seu caderno, consulte Adicione um botão Abrir no Studio Lab ao seu caderno.

1. Faça login no Studio Lab seguindo as etapas em Faça login no Studio Lab..

2. Em uma nova guia do navegador, navegue até o GitHub notebook que você deseja clonar.

3. No caderno, selecione o botão Abrir no Studio Lab para abrir uma nova página no Studio Lab com uma prévia do caderno.

4. Se o tempo de execução do seu projeto ainda não estiver em execução, inicie-o escolhendo o botão Iniciar tempo de execução na parte superior da página de pré-visualização. Aguarde até que o tempo de execução come antes de prosseguir para a próxima etapa.

5. Depois que o tempo de execução do seu projeto for iniciado, selecione Copiar para o projeto para abrir o tempo de execução do seu projeto em uma nova guia do navegador.

6. Na cópia de GitHub? caixa de diálogo, selecione Copiar somente caderno. Isso copia o arquivo do caderno para o seu projeto.

Opção 2: clonar qualquer notebook GitHub

O procedimento a seguir mostra como copiar qualquer notebook do GitHub.

1. Navegue até o notebook em GitHub.

2. Na barra de endereço do navegador, modifique o notebook URL da seguinte forma.

   # Original URL
   https://github.com/<PATH_TO_NOTEBOOK>
   
   # Modified URL 
   https://studiolab.sagemaker.aws/import/github/<PATH_TO_NOTEBOOK>

3. Navegue até o modificadoURL. Isso abre uma prévia do caderno no Studio Lab.

4. Se o tempo de execução do seu projeto ainda não estiver em execução, inicie-o escolhendo o botão Iniciar tempo de execução na parte superior da página de pré-visualização. Aguarde até que o tempo de execução come antes de prosseguir para a próxima etapa.

5. Depois que o tempo de execução do seu projeto for iniciado, selecione Copiar para o projeto para abrir o tempo de execução do seu projeto em uma nova guia do navegador.

6. Na cópia de GitHub? caixa de diálogo, selecione Copiar caderno somente para copiar o arquivo do caderno para o seu projeto.

Adicione um botão Abrir no Studio Lab ao seu caderno

Quando você adiciona o botão Abrir no Studio Lab aos seus cadernos, outras pessoas podem clonar seus cadernos ou repositórios diretamente para projetos do Studio Lab delas. Se você estiver compartilhando seu caderno em um GitHub repositório público, seu conteúdo será legível publicamente. Não compartilhe conteúdo privado, como chaves de AWS acesso ou AWS Identity and Access Management credenciais, em seu notebook.

Para adicionar o botão de funcionalidade Abrir no Studio Lab ao seu caderno ou repositório Jupyter, adicione o seguinte markdown na parte superior do seu caderno ou repositório.

[![Open In SageMaker Studio Lab](https://studiolab.sagemaker.aws/studiolab.svg)](https://studiolab.sagemaker.aws/import/github/<PATH_TO_YOUR_NOTEBOOK_ON_GITHUB>)

Importe arquivos do seu computador

As etapas a seguir mostram como importar arquivos do seu computador para o projeto do Studio Lab. 

1. Abra o runtime do projeto do Studio Lab

2. Abra o painel Navegador de arquivos.

3. Na barra de ações do painel Navegador de arquivos, selecione o botão Carregar arquivos.

4. Selecione os arquivos que deseja carregar da sua máquina local.

5. Selecione Abrir.

Como alternativa, é possível arrastar e soltar arquivos do computador para o painel do Navegador de arquivos.

Conectar-se ao Amazon S3

AWS CLI Isso permite a AWS integração em seu projeto do Studio Lab. Com essa integração, você pode extrair recursos do Amazon S3 para usar com seus blocos de anotação Jupyter.

Para usar AWS CLI com o Studio Lab, conclua as etapas a seguir. Para um notebook que descreve essa integração, consulte Usando o Studio Lab com AWS recursos.

1. Instale as etapas a AWS CLI seguir em Instalando ou atualizando a versão mais recente do AWS CLI.

2. Configure suas AWS credenciais seguindo as etapas em Configuração rápida. A função da sua AWS conta deve ter permissões para acessar o bucket do Amazon S3 do qual você está copiando dados.

3. Do seu bloco de anotações Jupyter, clone recursos do bucket do Amazon S3, conforme necessário. O comando a seguir mostra como clonar todos os recursos de um caminho do Amazon S3 para seu projeto. Para obter mais informações, consulte Referência de comandos da AWS CLI.

   !aws s3 cp s3://<BUCKET_NAME>/<PATH_TO_RESOURCES>/ <PROJECT_DESTINATION_PATH>/ --recursive