設定 Cloud Shell

Cloud Shell 可讓您根據偏好自訂開發環境。您可以設定永久環境變數、定義 gcloud CLI 偏好設定、執行自訂指令碼來初始化各工作階段的工具,以及調整使用統計資料收集。

Cloud Shell 主目錄中的設定檔

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

預先設定的環境變數

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

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 啟動時執行一次 (而非每次登入殼層時執行一次)。

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

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

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

.customize_environment 指令碼的執行記錄位於 /var/log/customize_environment。.customize_environment 指令碼會做為背景程序執行,並在成功執行後觸發 /google/devshell/customize_environment_done。由於套件安裝作業與登入作業會同時執行,因此在您看到登入提示後,可能需要稍等片刻,才能使用已安裝的套件。

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

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