Crea tutorial privati in Cloud Shell

Cloud Shell supporta la creazione di tutorial privati, che ti consentono di progettare tutorial specifici per il tuo pubblico.

Dopo aver scritto i tutorial utilizzando la guida Composizione dei tutorial in Cloud Shell e aver seguito le best practice descritte nella Guida allo stile dei tutorial, puoi ospitare il tutorial in un repository Git privato per renderlo disponibile ai tuoi utenti.

Ospita tutorial privati

Per rendere privato il tutorial, devi avere un repository Git privato in cui ospitarlo. Puoi utilizzare qualsiasi servizio di hosting di repository Git che preferisci. Questa guida utilizza Cloud Source Repositories, ovvero repository Git privati ospitati su Google Cloud.

Nota: per utilizzare Cloud Source Repositories, devi abilitare la fatturazione nel tuo progetto. Per maggiori dettagli sul costo dell'utilizzo di Cloud Source Repositories, consulta Guida ai prezzi di Cloud Source Repositories.

Per creare un repository Cloud Source Repositories per ospitare la tua sessione privata tutorial:

1. Avvia il terminale Cloud Shell. Per una sessione autonoma di Cloud Shell, utilizza shell.cloud.google.com.

2. Crea un repository privato:

   gcloud source repos create REPO_NAME
   

3. Clona il repository in Cloud Shell:

   gcloud source repos clone REPO_NAME
   

4. Sposta il file del tutorial nel repository creato in locale:

   mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL
   

5. Vai al tuo repository locale:

   cd REPO_NAME
   

6. Aggiungi il tutorial per eseguire il commit:

   git add .
   

7. Esegui il commit dei file nel repository con un commento che descriva cronologia di questa azione:

   git commit -m "Add private tutorial to Cloud Source Repositories"
   

8. Utilizza il comando git push per aggiungere i contenuti del repository locale a Cloud Source Repositories:

   git push origin master
   

9. Visualizza il repository e i suoi contenuti nella console Google Cloud:

   Apri Cloud Source Repositories

Crea un link Apri in Cloud Shell

Per aiutare gli utenti a raggiungere il tuo tutorial, puoi utilizzare la funzionalità Apri in Cloud Shell di Cloud Shell che ti consente di definire in che modo gli utenti accedono al tutorial. Per i dettagli su come personalizzare Consulta la guida Apri in Cloud Shell.

Per un tutorial ospitato in Cloud Source Repositories, ti serviranno per definire il parametro cloudshell_git_repo con l'URL del repository.

Un esempio di link con cloudshell_git_repo definito:

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name

Puoi impostare lo stile di questo link come pulsante da incorporare nella documentazione in modo che gli utenti possano trovarlo facilmente:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name)

Personalizza i tutorial con gli strumenti dei componenti aggiuntivi

Puoi personalizzare ulteriormente la tua esperienza di tutorial privato fornendo ai tuoi utenti strumenti personalizzati per lavorare con il tutorial.

Per farlo, puoi creare un'immagine Docker che funzioni come un'immagine dell'ambiente Cloud Shell con tutti i pacchetti aggiuntivi e le configurazioni che vuoi rendere disponibili all'utente. Per i dettagli su come creare un'immagine container personalizzata e aggiornare il comando Apri in Cloud Shell per fare riferimento a questa immagine container, consulta Guida alla personalizzazione dell'immagine container.