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.
Per creare un repository Cloud Source Repositories per ospitare il tuo tutorial privato:
- Avvia il terminale Cloud Shell. Per una sessione Cloud Shell autonoma, utilizza shell.cloud.google.com.
Crea un repository privato:
gcloud source repos create REPO_NAME
Clona il repository in Cloud Shell:
gcloud source repos clone REPO_NAME
Sposta il file del tutorial nel repository creato localmente:
mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL
Vai al tuo repository locale:
cd REPO_NAME
Aggiungi il tutorial al commit:
git add .
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"
Utilizza il comando
git push
per aggiungere i contenuti del repository locale a Cloud Source Repositories:git push origin master
Visualizza il repository e i relativi contenuti nella console Google Cloud:
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:
[](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.