在 Cloud Shell 中開啟

有了「在 Cloud Shell 中開啟」功能,您就能發佈可開啟 Cloud 主控台的連結,系統也會自動將 Git 存放區複製到 Cloud Shell。另外,使用者也可以透過這項功能在自有裝置上顯示操作說明,藉此與內容進行互動。

「在 Cloud Shell 中開啟」 功能可協助開發人員測試程式碼範例和 API,而且不必擔心下載 Cloud SDK、安裝所需依附元件,或是搜尋相關來源檔案等問題。本頁面說明如何將這項功能新增至您的 Git 存放區。

系統目前僅開放 GitHub 和 Bitbucket 存放區使用這項功能。如想增加其他存放區選項,請告訴我們您希望搭配「在 Cloud Shell 中開啟」功能使用的存放區類型。

網址參數

您可以自行選擇是否將「在 Cloud Shell 中開啟」連結嵌入按鈕圖片,也可以將這類連結新增至 Git 存放區中任一目錄的 README.md。不過一般來說,我們會建議您將這個連結放置於 Git 存放區的根 README.md。

如要將特定功能新增至「在 Cloud Shell 中開啟」互動元件,您可以使用下列網址參數:

網址參數 說明 支援的值
cloudshell_git_repo

要複製的 Git 存放區網址。

系統會複製您指定的存放區並開啟專案資料夾的根目錄,其內容會顯示在左側導覽窗格中。

有效的 Git 存放區網址。

包含系統允許的網域 (GitHub 或 Bitbucket),以及由有效字元 (a 至 z、A 至 Z、0 至 9、_、-、. 和 /) 組成的路徑。

cloudshell_git_branch

(選用)

要複製的 Git 存放區特定分支版本,預設分支版本為「主要」 存放區中的任何有效分支版本,僅可包含下列字元:a 至 z、A 至 Z、0 至 9、~、_、-、.、/ 和 :。

cloudshell_working_dir

(選用)

將使用者帶往指令列的工作目錄。 任何有效的檔案路徑,僅可包含下列字元:a 至 z、A 至 Z、0 至 9、~、_、-、.、/ 和 :。

cloudshell_open_in_editor

(選用)

要在已整合的 Orion 編輯器中開啟的檔案。您可以重複使用這項參數來指定多個要開啟的檔案。如果您指定了多個檔案,系統會依據您提供的順序開啟檔案。

在開啟的專案畫面中,系統會在右側的編輯器分頁中顯示您指定的檔案,一個檔案一個分頁。

檔案路徑與目前的目錄有關。如果您提供了「working_dir」參數,系統會將這些檔案的路徑視為與「working_dir」有關。

任何有效的檔案路徑,僅可包含下列字元:a 至 z、A 至 Z、0 至 9、~、_、-、.、/ 和 :。

cloudshell_print

(選用)

Git 存放區中的檔案,通常包含要顯示在使用者裝置的操作說明,以便他們瞭解後續步驟。檔案路徑與目前的目錄有關。

如果您提供「working_dir」參數,系統會將連至該檔案的路徑視為與「working_dir」有關。

任何有效的檔案路徑,僅可包含下列字元:a 至 z、A 至 Z、0 至 9、~、_、-、.、/ 和 :。

cloudshell_tutorial

(選用)

Git 存放區中的教學課程 Markdown 檔案,包含要以教學課程的形式啟用的操作說明,可讓使用者瞭解專案的所有工作流程。檔案路徑與目前的目錄有關。

任何格式正確、檔案名稱有效的教學課程 Markdown 檔案。

cloudshell_image

(選用)

指定在工作階段期間執行自訂環境的自訂 Docker 映像檔。這可讓您在 Cloud Shell 中提供使用存放區的自訂工具。請注意,這會建立一個臨時環境,當中包含一個會在工作階段結束時刪除的暫存主目錄。

Google Container Registry. 中託管的 Docker 映像檔網址。 Docker 映像檔必須以基本 Cloud Shell 映像檔為基礎。

範例

如要提供可在 Cloud Shell 中開啟範例 Git 存放區的連結,您必須使用如同下列程式碼片段的 Markdown,將連結嵌入存放區的 README.md:

[![Open in Cloud Shell](http://gstatic.com/cloudssh/images/open-btn.svg)](https://console.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git)

如果您想要將這項功能嵌入網站,HTML 即為上方的程式碼片段:

<a href="https://console.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git"><img alt="Open in Cloud Shell" src ="http://gstatic.com/cloudssh/images/open-btn.svg"></a>
本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Shell