Salvar um notebook no GitHub

Para fazer backup da instância de notebooks gerenciada pelo usuário e disponibilizá-la para outras pessoas, salve o conteúdo dessa instância 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.

Clone o repositório do GitHub na instância dos notebooks gerenciados pelo usuário

Para clonar o repositório do GitHub na instância de notebooks gerenciados pelo usuário, conclua as seguintes 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 Notebooks gerenciados pelo usuário.

    Acesse Notebooks gerenciados pelo usuário

  4. Clique em Abrir o JupyterLab para abrir a instância de notebooks gerenciados pelo usuário.

  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.

    Pasta inicial do notebook.

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

  7. 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.

  8. Na caixa de diálogo Clone o repo, cole o URL HTTPS do seu repositório do GitHub.

    Cole o URL do repositório e clone.

  9. Clique em Clone.

Configure a instância de notebooks gerenciados pelo usuário com as informações do usuário do GitHub

  1. No JupyterLab, selecione Git > Open Git Repository in Terminal para abrir uma janela de terminal do Git.

  2. 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 "YOUR_NAME"
    git config --global user.email "YOUR_EMAIL"
    
  3. Se a conta do GitHub exigir autenticação SSH, siga estas etapas para conectar a conta:

    1. No terminal do Git na instância dos notebooks gerenciados pelo usuário, siga as instruções do GitHub para gerar uma nova chave SSH.

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

  4. Feche a janela de terminal do Git.

Adicionar seus arquivos confirmados ao repositório do GitHub

  1. Sua instância de notebooks gerenciados pelo usuário mostra o repositório como uma nova pasta. Se você não vir seu repositório clonado do GitHub como uma pasta, clique no botão Atualizar lista de arquivos.

    Botão "Atualizar lista de arquivos".

  2. Clique duas vezes na pasta do repositório para abri-la.

  3. Adicione um novo notebook à instância de notebooks gerenciados pelo usuário.

    Para adicionar um arquivo do notebook, use o menu ou o acesso rápido.

    1. Para adicionar um novo arquivo de notebook no menu, selecione Arquivo > Novo > Notebook.

      Adicionar um arquivo de notebook

    2. Na caixa de diálogo Selecionar kernel, selecione o kernel do novo notebook, como o Python 3, e clique em Selecionar.

      O novo arquivo do notebook será aberto.

    Launcher

    1. Para adicionar um novo arquivo de notebook no acesso rápido, selecione File > New > Launcher.

    2. Clique no bloco para o kernel que você quer usar.

      Adicionar um arquivo de notebook

      O novo arquivo do notebook será aberto.

  4. Renomeie o novo arquivo do notebook.

    1. Selecione Arquivo > Renomear notebook. A caixa de diálogo Rename file é aberta.

    2. No campo Novo nome, altere Untitled.ipynb para algo significativo, como install.ipynb.

    3. Clique em Renomear.

    Launcher

    1. Clique com o botão direito do mouse na guia Untitled.ipynb e clique em Renomear notebook. A caixa de diálogo Rename file é aberta.

    2. No campo Novo nome, altere Untitled.ipynb para algo significativo, como install.ipynb.

    3. Clique em Renomear.

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

  6. 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.

  7. Para enviar o novo notebook ao repositório do GitHub, na guia Git, adicione um comentário de confirmação e clique em Confirmar.

  8. Para abrir uma janela de terminal do Git, selecione Git > Abrir repositório Git no terminal.

  9. Na janela de terminal do Git, digite o comando git push.

    • 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, crie um token de acesso pessoal para usar.

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