Salvataggio di un blocco note in GitHub

Salvataggio di un blocco note in GitHub

I notebook gestiti dall'utente di Vertex AI Workbench sono deprecati. Il 14 aprile 2025, il supporto per i blocchi note gestiti dall'utente terminerà e la possibilità di creare istanze di blocchi note gestiti dall'utente verrà rimossa. Le istanze esistenti continueranno a funzionare, ma non saranno disponibili patch, aggiornamenti e upgrade. Per continuare a utilizzare Vertex AI Workbench, ti consigliamo di eseguire la migrazione delle istanze di notebook gestiti dall'utente alle istanze Vertex AI Workbench.

Per eseguire il backup dell'istanza di blocchi note gestiti dall'utente e renderla disponibile ad altri, salva i contenuti dell'istanza di blocchi note gestiti dall'utente su GitHub.

Creare un repository GitHub

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

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

Clona il repository GitHub nell'istanza di blocchi note gestiti dall'utente

Per clonare il repository GitHub nell'istanza di blocchi note gestiti dall'utente, completa i seguenti passaggi:

1. Nel repository GitHub, fai clic sul pulsante Code (Codice) e poi sulla scheda Local (Locale).

2. Copia l'URL HTTPS.

3. Nella console Google Cloud , vai alla pagina Notebook gestiti dall'utente.

   Vai a Notebook gestiti dall'utente

4. Fai clic su Apri JupyterLab per aprire l'istanza di blocchi note gestiti dall'utente.

5. In JupyterLab  File Browser, seleziona la cartella in cui vuoi clonare il repository GitHub. Ad esempio, la cartella Home.

   

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

7. Se richiesto, inserisci le tue credenziali.

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

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

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

   

9. Fai clic su Clona.

Configurare l'istanza di notebook gestiti dall'utente con le informazioni utente di GitHub

1. In JupyterLab, seleziona Git > Apri repository Git nel terminale per aprire una finestra del terminale Git.

2. Nella finestra del terminale Git, inserisci i seguenti comandi per configurare il nome utente e l'email di Git:

   git config --global user.name "YOUR_NAME"
   git config --global user.email "YOUR_EMAIL"

3. Se il tuo account GitHub richiede l'autenticazione SSH, completa i seguenti passaggi per collegare il tuo account:

   1. Dal terminale Git nell'istanza dei blocchi note gestiti dall'utente, segui le istruzioni di GitHub per generare una nuova chiave SSH.

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

4. Chiudi la finestra del terminale Git.

Aggiungere i file di cui è stato eseguito il commit al repository GitHub

1. L'istanza di blocchi note gestiti dall'utente mostra il repository come nuova cartella. Se non vedi il repository GitHub clonato come cartella, fai clic sul pulsante Aggiorna elenco file.

   

2. Fai doppio clic sulla cartella del repository per aprirla.

3. Aggiungi un nuovo notebook all'istanza di blocchi note gestiti dall'utente.

   Per aggiungere un file del blocco note, puoi utilizzare il menu o Avvio app.

   Menu

   1. Per aggiungere un nuovo file del blocco note dal menu, seleziona File > Nuovo > Blocco note.

      

   2. Nella finestra di dialogo Seleziona kernel, seleziona il kernel per il nuovo notebook, ad esempio Python 3, quindi fai clic su Seleziona.

      Si apre il nuovo file del notebook.

   Launcher

   1. Per aggiungere un nuovo file di blocco note da Avvio app, seleziona File > Nuovo > Avvio app.

   2. Fai clic sul riquadro del kernel che vuoi utilizzare.

      

      Si apre il nuovo file del notebook.

4. Rinomina il nuovo file del notebook.

   Menu

   1. Seleziona File > Rinomina blocco note. Viene visualizzata la finestra di dialogo Rinomina file.

   2. Nel campo Nuovo nome, modifica Untitled.ipynb con un nome significativo, ad esempio install.ipynb.

   3. Fai clic su Rinomina.

   Launcher

   1. Fai clic con il tasto destro del mouse sulla scheda Untitled.ipynb e poi fai clic su Rinomina blocco note. Viene visualizzata la finestra di dialogo Rinomina file.

   2. Nel campo Nuovo nome, modifica Untitled.ipynb con un nome significativo, ad esempio install.ipynb.

   3. Fai clic su Rinomina.

5. Seleziona la scheda Git. Il nuovo notebook è elencato nel raggruppamento Non monitorati.

6. Per aggiungere il nuovo notebook come file per il repository GitHub, fai clic con il tasto destro del mouse sul nuovo notebook e seleziona Monitora. Nella scheda Git, il notebook viene ora aggiunto al raggruppamento In staging.

7. Per eseguire il commit del nuovo blocco note nel repository GitHub, nella scheda Git, aggiungi un commento al commit e fai clic su Commit.

8. Per aprire una finestra del terminale Git, seleziona Git > Apri repository Git nel terminale.

9. Nella finestra del terminale Git, inserisci il comando git push.

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

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

   Al termine del comando git push, i file di cui è stato eseguito il commit si trovano nel repository GitHub.