Use recursos externos no Amazon SageMaker Studio Lab - SageMaker IA da Amazon
Use os recursos do GitHubAdicione um botão Abrir no Studio Lab ao seu cadernoImporte arquivos do seu computadorConectar-se ao Amazon S3

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use recursos externos no Amazon SageMaker Studio Lab

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

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

Use os recursos do GitHub

O Studio Lab oferece integração com o 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 os recursos do GitHub 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

  • Como se conectar ao AWS

  • Criar ambientes personalizados

  • Análise de dados geoespaciais

  • Processamento de linguagem natural

  • Usando R

Clonar um repositório do GitHub.

Para clonar um repositório do GitHub 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 ( Black square icon representing a placeholder or empty image. ) 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 ( Black square icon representing a placeholder or empty image. ) no menu à esquerda para abrir um novo menu suspenso.

  5. Escolha Clonar um repositório.

  6. Cole a URL do repositório na URL do repositório Git (.git).

  7. Selecione Clonar.

Clone cadernos individuais do 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 no GitHub a partir da página de pré-visualização 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 caderno do GitHub 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 caderno do GitHub 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 projeto em uma nova guia do navegador.

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

Opção 2: clonar qualquer caderno do GitHub

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

  1. Navegue até o caderno no GitHub.

  2. Na barra de endereço do navegador, modifique a URL do caderno 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é a URL modificada. 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 caixa de diálogo Copiar do GitHub?, 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 repositório público do GitHub, seu conteúdo será legível publicamente. Não compartilhe conteúdo privado em seu caderno, como chaves de acesso AWS ou credenciais AWS Identity and Access Management.

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

O AWS CLI permite a integração AWS 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.

Conclua as etapas a seguir para usar AWS CLI com o Studio Lab. Para um caderno que resume essa integração, consulte Usando o Studio Lab com recursos AWS.

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

  2. Configure suas credenciais AWS seguindo as etapas em Configuração rápida. A função da sua conta AWS 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