Salvataggio di un blocco note in GitHub

Salvataggio di un blocco note in GitHub

I blocchi note gestiti da Vertex AI Workbench sono ritratti. Il 30 gennaio 2025 verrà interrotto il supporto per i notebook gestiti e la possibilità di creare istanze di notebook gestiti verrà rimossa. Le istanze esistenti continueranno a funzionare, ma patch, aggiornamenti e upgrade non saranno disponibili. Per continuare a utilizzare Vertex AI Workbench, ti consigliamo di eseguire la migrazione delle tue istanze di notebook gestite alle istanze Vertex AI Workbench.

Per eseguire il backup dell'istanza di Notebook gestiti e renderla disponibile per altri, salva i contenuti dell'istanza di Notebook gestiti su GitHub.

Creare un repository GitHub

Se non hai ancora 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.

Clona il repository GitHub nell'istanza di Notebook gestiti

Per clonare il repository GitHub nell'istanza di Notebook gestiti:

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

   Vai a Blocchi note gestiti

4. Fai clic su Apri JupyterLab per aprire la tua istanza di blocchi note gestiti.

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

   

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 nome utente e la 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 con i tuoi dati 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 tuo nome utente e il tuo indirizzo email 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 collegarlo:

   1. Dal terminale Git nell'istanza dei blocchi note gestiti, 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 committati al repository GitHub

1. L'istanza di Notebook gestiti mostra il tuo 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.

   Per aggiungere un file del notebook, 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 blocco note, ad esempio Python 3, quindi fai clic su Seleziona.

      Si apre il nuovo file del blocco note.

   Avvio applicazioni

   1. Per aggiungere un nuovo file del notebook dal programma di avvio, seleziona File > Nuovo > Avvio.

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

      

      Si apre il nuovo file del blocco note.

4. Rinomina il nuovo file del notebook.

   Menu

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

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

   3. Fai clic su Rinomina.

   Avvio applicazioni

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

   2. Nel campo Nuovo nome, sostituisci 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 gruppo Non monitorato.

6. 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 blocco note è stato aggiunto al raggruppamento In fase di staging.

7. Per eseguire il commit del nuovo notebook 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 richiesto, inserisci il nome utente e la password GitHub.

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

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