Creare tutorial privati in Cloud Shell

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

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

Ospitare tutorial privati

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

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

  1. Avvia il terminale Cloud Shell. Per una sessione di 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 repository locale:

    cd REPO_NAME

  6. Aggiungi il tutorial da eseguire:

    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. Utilizzando il comando git push, aggiungi 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

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 il modo in cui 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, devi definire il parametro cloudshell_git_repo con l'URL del repository.

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 formattare questo link come pulsante da incorporare nella documentazione per consentire agli utenti di 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 l'esperienza del tutorial privato fornendo agli utenti strumenti personalizzati per lavorare con il tutorial.

Per farlo, puoi creare un'immagine Docker che funga da ambiente Cloud Shell personalizzato con tutti i pacchetti aggiuntivi e le configurazioni personalizzate che vuoi rendere disponibili per l'utente.