Salvar um notebook no GitHub

Nesta página, descrevemos como salvar os arquivos de notebook da instância do Vertex AI Workbench no GitHub usando a extensão jupyterlab-git. Isso pode ser feito para criar um backup do notebook ou disponibilizá-lo para outras pessoas.

Nas instâncias do Vertex AI Workbench, é possível usar a extensão jupyterlab-git para ajudar você com o controle de versões. Para saber mais, consulte jupyterlab-git no GitHub.

Crie um repositório do GitHub

Se você ainda não tiver um repositório do GitHub, crie um.

Ao criar um repositório do GitHub, verifique se o repositório do GitHub pode ser clonado marcando a caixa de seleção Inicializar este repositório com um README.

Inicialize um repositório do GitHub com um arquivo README.

Clonar o repositório do GitHub na sua instância do Vertex AI Workbench

Para clonar o repositório do GitHub na sua instância do Vertex AI Workbench, siga estas etapas:

  1. No seu repositório do GitHub, clique no botão Code e na guia Local.

  2. Copie o URL em HTTPS.

  3. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  4. Clique em Abrir JupyterLab para abrir sua instância do Vertex AI Workbench.

  5. No  Navegador de arquivos do JupyterLab, selecione a pasta em que você quer clonar o repositório do GitHub. Por exemplo, a pasta inicial.

    O navegador de arquivos do JupyterLab no Vertex AI Workbench, destacando a pasta principal em que um repositório do GitHub pode ser clonado.

  6. No JupyterLab, selecione Git > Clonar um repositório.

  7. Na caixa de diálogo Clonar um repo, cole o URL HTTPS do seu repositório do GitHub.

    Caixa de diálogo mostrando o campo do URL do repositório e opções para submódulos e repositório de download.

  8. Se solicitado, digite suas credenciais.

    • Se você usa um nome de usuário e uma senha do GitHub, digite-os.

    • Se você usa a autenticação de dois fatores com o GitHub, crie e use um token de acesso pessoal.

  9. Clique em Clone.

  10. Sua instância do Vertex AI Workbench mostra o repositório como uma nova pasta. Se você não vir o repositório clonado do GitHub como uma pasta, clique no botão Atualizar lista de arquivos.

    Navegador de arquivos do JupyterLab no Vertex AI Workbench, com o botão "Refresh File List" destacado.

Configurar sua instância do Vertex AI Workbench com as informações do usuário do GitHub

  1. No JupyterLab, abra a pasta em que o repositório está localizado.

  2. Selecione Git > Open Git Repository in Terminal para abrir uma janela do terminal do Git.

  3. Na janela do terminal do Git, digite os seguintes comandos para configurar o nome de usuário e o e-mail do Git:

    git config --global user.name "USERNAME"
    git config --global user.email "EMAIL_ADDRESS"

    Substitua:

    • USERNAME: seu nome de usuário do GitHub
    • EMAIL_ADDRESS: o endereço de e-mail da sua conta do GitHub
  4. Se a conta do GitHub exigir autenticação SSH, siga estas etapas para conectar a conta:

    1. No terminal do Git na sua instância do Vertex AI Workbench, siga as instruções do GitHub para gerar uma nova chave SSH.

    2. Siga as instruções para adicionar essa chave SSH à sua conta do GitHub.

  5. Feche a janela de terminal do Git.

Adicionar seus arquivos confirmados ao repositório do GitHub

  1. No JupyterLab, abra a pasta em que o repositório está localizado.

  2. Adicione um novo notebook.

  3. Selecione a guia Git. O novo notebook é apresentado no grupo Não rastreado.

  4. Para adicionar o novo notebook como um arquivo no repositório do GitHub, clique com o botão direito do mouse no novo notebook e selecione Rastrear. Na guia Git, o notebook será adicionado ao agrupamento Staged.

  5. Para fazer commit do seu novo notebook no repositório do GitHub, na guia Git, no campo Resumo, adicione um comentário de commit e clique em Commit.

  6. Selecione Git > Push to Remote.

    • Se você usar um nome de usuário e uma senha do GitHub, quando solicitado, digite o nome de usuário e a senha do GitHub.

    • Se você usa a autenticação de dois fatores com o GitHub, insira seu nome de usuário e token de acesso pessoal do GitHub.

    Quando o comando git push for concluído, seus arquivos com commit estarão no repositório do GitHub.