Salvataggio di un blocco note in GitHub

Questa pagina descrive come salvare i file dei blocchi note dell'istanza di Vertex AI Workbench su GitHub utilizzando l'estensione jupyterlab-git. Puoi eseguire questa operazione per creare un backup del blocco note o per renderlo disponibile ad altri.

Nelle istanze Vertex AI Workbench, puoi utilizzare l'estensione jupyterlab-git per aiutarti con il controllo della versione. Per saperne di più, consulta jupyterlab-git su GitHub.

Creare un repository GitHub

Se non hai già un repository GitHub, devi crearne uno.

Quando crei il tuo repository GitHub, assicurati che possa essere clonato selezionando la casella di controllo Inizializza questo repository con un file README.

Inizializza un repository GitHub con un file README.

Clona il repository GitHub nell'istanza Vertex AI Workbench

Per clonare il repository GitHub nell'istanza di Vertex AI Workbench, compila i seguenti passaggi:

  1. Nel repository GitHub, fai clic sul pulsante Codice, quindi sulla scheda Locale.

  2. Copia l'URL HTTPS.

  3. Nella console Google Cloud, vai alla pagina Istanze.

    Vai a Istanze

  4. Fai clic su Apri JupyterLab per aprire la tua istanza di Vertex AI Workbench.

  5. Nel  browser di file di JupyterLab, seleziona la cartella in cui vuoi clonare il repository GitHub. Ad esempio, la home directory.

    Il browser dei file di JupyterLab in Vertex AI Workbench, che evidenzia la home directory in cui è possibile clonare un repository GitHub.

  6. In JupyterLab, seleziona Git > Clona un repository.

  7. Nella finestra di dialogo Clona un repository, incolla l'URL HTTPS del tuo repository GitHub.

    Finestra di dialogo che mostra il campo per l'URL del repository e le opzioni per i sottomoduli e il download del repository.

  8. Se richiesto, inserisci le tue credenziali.

    • Se utilizzi un nome utente e una password GitHub, inserisci il nome utente e la password GitHub.

    • Se utilizzi l'autenticazione a due fattori con GitHub, crea e utilizza un token di accesso personale.

  9. Fai clic su Clona.

  10. L'istanza di Vertex AI Workbench mostra il repository come nuova cartella. Se non vedi il repository GitHub clonato come cartella, fai clic sul pulsante Aggiorna elenco file.

    Il browser dei file di JupyterLab in Vertex AI Workbench, con il pulsante Aggiorna elenco file evidenziato.

Configura l'istanza di Vertex AI Workbench con i tuoi dati utente di GitHub

  1. In JupyterLab, apri la cartella in cui si trova il tuo repository.

  2. Seleziona Git > Apri repository Git nel terminale per aprire una finestra del terminale Git.

  3. Nella finestra del terminale Git, inserisci i seguenti comandi per configurare il tuo nome utente e il tuo indirizzo email Git:

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

    Sostituisci quanto segue:

    • USERNAME: il tuo nome utente GitHub
    • EMAIL_ADDRESS: l'indirizzo email del tuo account GitHub
  4. Se il tuo account GitHub richiede l'autenticazione SSH, completa i seguenti passaggi per collegarlo:

    1. Dal terminale Git nell'istanza Vertex AI Workbench, segui le istruzioni di GitHub per generare una nuova chiave SSH.

    2. Segui le istruzioni per aggiungere la chiave SSH al tuo account GitHub.

  5. Chiudi la finestra del terminale Git.

Aggiungere i file committati al repository GitHub

  1. In JupyterLab, apri la cartella in cui si trova il tuo repository.

  2. Aggiungi un nuovo blocco note.

  3. Seleziona la scheda Git. Il nuovo notebook è elencato nel gruppo Non monitorato.

  4. Per aggiungere il nuovo notebook come file per il tuo repository GitHub, fai clic con il tasto destro del mouse sul nuovo notebook e seleziona Monitora. Nella scheda Git, il tuo notebook è stato aggiunto al raggruppamento In fase di staging.

  5. Per eseguire il commit del nuovo notebook nel repository GitHub, nella scheda Git, nel campo Riepilogo, aggiungi un commento al commit e poi fai clic su Commit.

  6. Seleziona Git > Push to Remote.

    • Se utilizzi un nome utente e una password GitHub, quando richiesto, inserisci il nome utente e la password GitHub.

    • Se utilizzi l'autenticazione a due fattori con GitHub, inserisci il tuo nome utente GitHub e il tuo token di accesso personale.

    Al termine dell'esecuzione del comando git push, i file sottoposti a commit si trovano nel tuo repository GitHub.