La funzionalità Apri in Cloud Shell ti consente di pubblicare un link apre la console Google Cloud con un repository Git clonato in Cloud Shell e/o avvia Cloud Shell con dell'immagine. Puoi anche stampare istruzioni sul terminale per aiutare gli utenti a interagire con i contenuti.
I link Apri in Cloud Shell aiutano gli sviluppatori a fare esperimenti con il tuo codice esempi e API senza dover scaricare Google Cloud CLI, installare o cercare i file di origine pertinenti. Questa pagina illustra come aggiungere un link Apri in Cloud Shell al repository Git.
Parametri URL
Un link Apri in Cloud Shell, incorporato facoltativamente in un'immagine del pulsante, può essere aggiunto al file README.md di qualsiasi directory nel repository Git. La consigliata per questo link è il file README.md principale del vostro repository repository Git.
Parametro URL obbligatorio
Per creare questo link, utilizza l'URL di base shell.cloud.google.com (o qualsiasi pagina in
la console Google Cloud che inizia con console.cloud.google.com) con
il seguente parametro URL obbligatorio:
| Parametro URL | Descrizione | Valori supportati |
|---|---|---|
cloudshell_git_repo |
URL del repository Git da clonare. Dopo la clonazione del repository, la radice della cartella del progetto viene aperta, visualizzando i relativi contenuti nel riquadro di navigazione a sinistra. |
URL valido per un repository Git. Questo URL è costituito da un dominio consentito (GitHub o Bitbucket) e un percorso. Le seguenti caratteri sono consentiti: lettere maiuscole e minuscole, numeri trattini bassi (_), trattini (-), punti (.) e barre (/). |
Parametri URL facoltativi
Puoi anche specificare uno qualsiasi dei seguenti parametri facoltativi:
| Parametro URL | Descrizione | Valori supportati |
|---|---|---|
cloudshell_git_branch
|
Ramo dal repository Git da clonare. Applicabile solo quando è specificato cloudshell_git_repo. Il ramo predefinito è principale. | Qualsiasi ramo valido nel repository. I seguenti caratteri sono consentiti: lettere maiuscole e minuscole, cifre, tildi (~), trattini bassi (_), trattini (-), punti (.), barre (/) e I due punti (:). |
cloudshell_image
|
Immagine Docker personalizzata che esegue ambiente personalizzato durante la sessione. Ciò ti consente di fornire strumenti personalizzati Cloud Shell che gli utenti possono utilizzare per lavorare con il repository. Apertura di un repository in Cloud Shell con questo parametro specificato crea un ambiente temporaneo con una home directory scratchpad che viene eliminato al termine della sessione. |
URL di un'immagine Docker ospitata in e Container Registry. L'immagine Docker deve essere basata sull'immagine Cloud Shell di base ed essere accessibili pubblicamente. Per creare un'immagine valida, segui il tutorial sulla creazione di immagini personalizzate può essere avviato eseguendo questo comando in Cloud Shell:
Tieni presente che il download delle immagini di grandi dimensioni nel VM Cloud Shell all'apertura dell'URL. |
cloudshell_open_in_editor
|
File da aprire nell'editor di Cloud Shell. Può essere ripetuto per specificare più file da aprire. Se vengono specificati più parametri, essere aperti nell'ordine fornito. Il file specificato viene aperto nelle schede dell'editor a destra, uno per ogni file nel progetto aperto. I percorsi dei file sono relativi alla directory corrente. Se Viene fornito il parametro working_dir, il percorso di questi file viene trattato come relativo a working_dir. |
Qualsiasi percorso file valido composto dai seguenti elementi consentiti caratteri: lettere maiuscole e minuscole, cifre, tildi (~), trattini bassi (_), trattini (-), punti (.), barre (/) e I due punti (:). |
cloudshell_print
|
File nel repository Git, generalmente costituito da istruzioni stampata sul terminale per guidare i passaggi successivi dell'utente. Il percorso del file è rispetto alla directory corrente. Se viene fornito il parametro working_dir, il percorso di questo file è trattati come relativi a working_dir. |
Qualsiasi percorso file valido composto dai seguenti elementi consentiti caratteri: lettere maiuscole e minuscole, cifre, tildi (~), trattini bassi (_), trattini (-), punti (.), barre (/) e I due punti (:). |
cloudshell_tutorial
|
File Markdown per i tutorial in il repository Git composto da istruzioni da avviare come tutorial per guidare gli utenti attraverso un progetto. Il percorso del file è relativo allo stato attuale . |
Qualsiasi file Markdown del tutorial in formato corretto con un nome file valido. |
cloudshell_working_dir (deprecato)
|
Questo parametro è obsoleto. Utilizza le funzionalità di
|
Qualsiasi percorso file valido composto dai seguenti elementi consentiti caratteri: lettere maiuscole e minuscole, cifre, tildi (~), trattini bassi (_), trattini (-), punti (.), barre (/) e I due punti (:). |
cloudshell_workspace
|
Directory di lavoro per Cloud Shell. Il terminale si apre nel specificata. L'editor di Cloud Shell apre la directory come file workspace. | Qualsiasi percorso di file valido relativo al repository clonato. Puoi abbandonare
il valore parametro è vuoto oppure usa . per specificare la radice di
il repository clonato. Se non viene specificato alcun repository, il percorso è
rispetto alla home directory di Cloud Shell. Le seguenti
caratteri sono consentiti: lettere maiuscole e minuscole, numeri
tildi (~), trattini bassi (_), trattini (-), punti (.),
barre (/) e due punti (:).
|
ephemeral |
Apertura di un repository in Cloud Shell con questo parametro specificato crea un ambiente temporaneo con una home directory scratchpad che viene eliminato al termine della sessione. Per ulteriori informazioni, vedi Scelta della modalità temporanea. |
|
show
|
Apri solo con il terminale, solo con l'editor di Cloud Shell o entrambe le cose. |
|
Esempi
Per incorporare un pulsante per aprire un repository Git di esempio in Cloud Shell, includi il seguente Markdown nel file README.md del tuo repository:
[](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git)
Per incorporare la stessa funzionalità in un sito web, utilizza questo codice HTML equivalente snippet:
<a href="https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git">
<img alt="Open in Cloud Shell" src ="https://gstatic.com/cloudssh/images/open-btn.svg">
</a>
Apri nel generatore di link di Cloud Shell
Per definire il comportamento del link Apri in Cloud Shell In particolare, puoi utilizzare il modulo riportato di seguito per sperimentare i parametri necessari e apri il repository in Cloud Shell.