設定 Cloud Shell

本頁面說明如何設定 Cloud Shell,打造專屬體驗。

Cloud Shell 主目錄中的設定檔

Cloud Shell 提供 5 GB 的免費永久磁碟儲存空間,在虛擬機器執行個體上掛接為您的 $HOME 目錄。即使換了工作階段,系統仍會保留您儲存在主目錄中的所有檔案,包括已安裝的軟體、指令碼以及 .bashrc.vimrc 等使用者設定檔。由於 .bashrc 會在工作階段間持續存在,因此非常適合用來自訂 Cloud Shell 行為。同樣地,如要保留安裝項目,可以將套件安裝到主目錄。

預先設定的環境變數

啟動 Cloud Shell 時,系統會將 Cloud Shell 中的現有專案套用至 Cloud Shell 中的 gcloud 設定,方便您立即使用。應用程式預設憑證程式庫支援使用的環境變數 GOOGLE_CLOUD_PROJECT 也會設為指向 Cloud Shell 中的現用專案,以定義專案 ID。

CLOUD_SHELL 環境變數設為 true。應用程式可以檢查這個變數,判斷應用程式是否在 Cloud Shell 中執行。

gcloud CLI 偏好設定

使用 Cloud Shell 時,系統會將 gcloud CLI 偏好設定儲存在暫時的 tmp 資料夾中,且僅適用於目前的索引標籤,不會跨工作階段保留。

如要讓 gcloud CLI 設定保持不變,可以使用下列任一方法設定:

  • 如要讓每個分頁都能自訂 gcloud CLI 設定,但自訂預設設定本身,可以在 $HOME/.bashrc 檔案結尾新增 gcloud 設定指令 (例如 gcloud config set compute/region us-central1,用於設定預設區域)。

    這樣一來,每個新分頁都會沿用您的 Google Cloud 控制台專案和自訂預設設定,但您也可以進一步自訂每個分頁的設定。

  • 如要一律使用相同的 gcloud CLI 設定,請在 .bashrc 檔案結尾加上 export CLOUDSDK_CONFIG=$HOME/.config/gcloud,然後執行 gcloud config configurations create CONFIG_NAME,建立要使用的設定。

常見屬性

如要設定要處理的專案,請執行:

gcloud config set project [PROJECT_NAME]

命令提示字元會更新,以反映目前有效的專案,並遵守以下格式:[USERNAME]@cloudshell:~ ([PROJECT_NAME])$

如要選取偏好的區域,請執行下列指令:

gcloud config set compute/region us-east1

上述指令是您可以設定的 gcloud CLI 設定範例。如需完整清單及設定屬性的詳細資訊,請參閱 gcloud CLI 屬性指南

自訂環境

環境自訂功能可讓您在 Cloud Shell 環境啟動時,將其他套件安裝至該環境。

環境自訂指令碼

執行個體啟動時,Cloud Shell 會自動執行指令碼 $HOME/.customize_environment。與 .profile.bashrc 不同,這個指令碼會在 Cloud Shell 啟動時執行一次 (而不是每次登入 Shell 時執行一次)。

這個指令碼會以根身分執行,您可以使用 Debian 套件管理指令,在每個 Cloud Shell 工作階段中安裝任何想使用的套件。

舉例來說,如果您想在 Cloud Shell 上安裝 Erlang,.customize_environment 檔案會如下所示:

#!/bin/sh
apt-get update
apt-get -y install erlang

您可以在 /var/log/customize_environment 找到 .customize_environment 指令碼的執行記錄。.customize_environment 指令碼會以背景程序的形式執行,成功執行後會觸發 /google/devshell/customize_environment_done。由於套件安裝作業會與登入作業並行執行,因此登入提示出現後,安裝的套件可能需要過一會兒才會生效。

使用指定使用者帳戶開啟 Cloud Shell

authuser 參數可讓您指定要搭配 Cloud Shell 使用的使用者帳戶。你必須使用指定的使用者帳戶登入。 如果沒有登入指定帳戶,Cloud Shell 會以預設登入帳戶開啟。舉例來說,您可以使用網址 shell.cloud.google.com?authuser=client1@example.com 開啟 Cloud Shell,並以 client1@example.com 身分登入。

自訂容器映像檔

您可以自訂容器映像檔,建立 Docker 映像檔做為自訂 Cloud Shell 環境,並指定其他套件和自訂設定。Docker 映像檔必須以基本 Cloud Shell 映像檔為基礎,並託管在 Artifact Registry 中。

與環境自訂不同,容器映像檔自訂不會影響預設的 Cloud Shell 體驗。您可以透過「Open in Cloud Shell」(在 Cloud Shell 中開啟) 連結使用及分享自訂映像檔。

tmux 支援

Cloud Shell 使用 tmux,因此能提升瀏覽器分頁工作階段的持續性。舉例來說,如果您在分頁中重新整理Google Cloud 控制台,或從其他電腦連線至 Cloud Shell,工作階段狀態不會遺失。

Cloud Shell 支援預設的 tmux 按鍵繫結。舉例來說,假設您依序按下 Ctrl+b%tmux 會將目前的工作階段視窗分割為左右兩個窗格,這項功能在除錯時相當實用。

使用統計資料

Cloud Shell 會針對在 Cloud Shell 終端機中執行的指令,收集經過匿名處理的使用統計資料。系統只會針對預先安裝於 Cloud Shell 的指令收集統計資料。這些指標無法連結回您的帳戶。

我們不會針對任何個人識別資訊 (例如傳送給這些指令的引數) 收集指標。

如要隨時變更指標收集偏好設定,請在「設定」選單中選取「終端機使用統計資料」設定按鈕。在「設定」選單中變更偏好設定後,系統會在下一個工作階段套用變更。如要啟用或停用指標收集功能,請關閉分頁,然後在變更後開啟另一個分頁。

附註:終端機使用統計資料與 gcloud 使用統計資料不同,後者在 Cloud Shell 中預設為啟用。

如要停用 gcloud CLI 指標收集功能,請在 Cloud Shell 工作階段中執行下列指令:

gcloud config set disable_usage_reporting true