Creare 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.

Organizzare 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 attivare la fatturazione nel tuo progetto. Per informazioni dettagliate sul costo dell'utilizzo di Cloud Source Repositories, consulta la guida ai prezzi di Cloud Source Repositories.

Per creare un repository Cloud Source Repositories per ospitare il tuo tutorial privato:

1. Avvia il terminale Cloud Shell. Per una sessione Cloud Shell autonoma, 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 localmente:

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

5. Vai al tuo repository locale:

   cd REPO_NAME
   

6. Aggiungi il tutorial al commit:

   git add .
   

7. Esegui il commit dei file nel repository con un commento che descriva la 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 relativi contenuti nella console Google Cloud:

   Apri Cloud Source Repositories

Creare 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 informazioni dettagliate su come personalizzare il link, consulta la guida Apri in Cloud Shell.

Per un tutorial ospitato in un repository Cloud Source Repositories, dovrai 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)

Personalizzare 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.

A tale scopo, puoi creare un'immagine Docker che funzioni come un ambiente Cloud Shell personalizzato con tutti i pacchetti aggiuntivi e le configurazioni personalizzate che vuoi rendere disponibili per l'utente. Per informazioni dettagliate su come creare un'immagine container personalizzata e aggiornare il link Apri in Cloud Shell per fare riferimento a questa immagine container, consulta la guida alla personalizzazione delle immagini container.