設定 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,應用程式預設憑證程式庫支援使用的環境變數,用於定義專案 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 啟動時執行一次 (而非每次登入 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 網址,以 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