Guarde um bloco de notas no GitHub

Esta página descreve como pode guardar os ficheiros de blocos de notas da instância do Vertex AI Workbench no GitHub através da extensão jupyterlab-git. Pode fazê-lo para criar uma cópia de segurança do bloco de notas ou para disponibilizar o bloco de notas a outras pessoas.

Nas instâncias do Vertex AI Workbench, pode usar a extensão jupyterlab-git para ajudar com o controlo de versões. Para saber mais, consulte o artigo jupyterlab-git no GitHub.

Crie um repositório do GitHub

Se ainda não tiver um repositório do GitHub, tem de criar um.

Quando criar o seu repositório do GitHub, certifique-se de que o repositório do GitHub pode ser clonado selecionando a caixa de verificação Initialize this repository with a README.

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

Clone o seu repositório do GitHub na instância do Vertex AI Workbench

Para clonar o seu repositório GitHub na instância do Vertex AI Workbench, conclua os seguintes passos:

  1. No seu repositório do GitHub, clique no botão Code e, de seguida, clique no separador Local.

  2. Copie o URL HTTPS.

  3. Na Google Cloud consola, aceda à página Instâncias.

    Aceda a Instâncias

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

  5. No JupyterLab  explorador de ficheiros, selecione a pasta onde quer clonar o repositório do GitHub. Por exemplo, a pasta inicial.

    O explorador de ficheiros do JupyterLab no Vertex AI Workbench, realçando a pasta inicial onde é possível clonar um repositório do GitHub.

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

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

    Caixa de diálogo que mostra o campo para o URL do repositório e as opções para submódulos e transferência do repositório.

  8. Se lhe for pedido, introduza as suas credenciais.

    • Se usar um nome de utilizador e uma palavra-passe do GitHub, introduza o seu nome de utilizador e palavra-passe do GitHub.

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

  9. Clique em Clonar.

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

    O explorador de ficheiros do JupyterLab no Vertex AI Workbench, com o botão Atualizar lista de ficheiros realçado.

Configure a sua instância com as informações de utilizador do GitHub

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

  2. Selecione Git > Abrir repositório Git no terminal para abrir uma janela de terminal do Git.

  3. Na janela do terminal Git, introduza os seguintes comandos para configurar o seu nome de utilizador e email do Git:

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

    Substitua o seguinte:

    • USERNAME: o seu nome de utilizador do GitHub
    • EMAIL_ADDRESS: o endereço de email da sua conta do GitHub

  4. Se a sua conta do GitHub exigir autenticação SSH, conclua os seguintes passos para associar a sua conta:

    1. No terminal Git na instância do Vertex AI Workbench, siga as instruções da 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 do terminal Git.

Adicione os ficheiros consolidados ao seu repositório do GitHub

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

  2. Adicione um novo bloco de notas.

  3. Selecione o separador Git. O novo bloco de notas é apresentado no agrupamento Não monitorizado.

  4. Para adicionar o novo notebook como um ficheiro para o seu repositório do GitHub, clique com o botão direito do rato no novo notebook e selecione Monitorizar. No separador Git, o seu notebook é agora adicionado ao agrupamento Staged.

  5. Para confirmar o novo bloco de notas no seu repositório do GitHub, no separador Git, no campo Resumo, adicione um comentário de confirmação e, de seguida, clique em Confirmar.

  6. Selecione Git > Enviar para remoto.

    • Se usar um nome de utilizador e uma palavra-passe do GitHub, quando lhe for pedido, introduza o seu nome de utilizador e palavra-passe do GitHub.

    • Se usar a autenticação de dois fatores com o GitHub, introduza o seu nome de utilizador do GitHub e token de acesso pessoal.

    Após a conclusão do comando git push, os ficheiros consolidados encontram-se no repositório do GitHub.

O que se segue?