設定 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 設定可在每個分頁中自訂,但又要自訂預設設定,您可以將 gcloud 設定指令 (例如 gcloud config set compute/region us-central1 可設定預設區域) 新增至 $HOME/.bashrc 檔案的結尾。

    這可確保每個新分頁都會繼承您的 Google Cloud 主控台專案和自訂的預設設定,同時也能讓您進一步自訂每個分頁的設定。

  • 如要一律使用相同的 gcloud CLI 設定,請將 export CLOUDSDK_CONFIG=$HOME/.config/gcloud 新增至 .bashrc 檔案的結尾,然後執行 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 會使用已登入的預設帳戶開啟。舉例來說,您可以使用網址 [email protected][email protected] 的身份登入 Cloud Shell。

容器映像檔自訂

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

與環境自訂設定不同,容器映像檔自訂設定不會影響預設的 Cloud Shell 體驗。您可以使用「Open in Cloud Shell」連結使用及分享自訂圖片。

tmux 支援

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

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

使用統計資料

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

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

如要隨時變更指標收集偏好設定,請在「設定」選單中選取「Terminal Usage Statistics」設定按鈕。您在「設定」選單中所做的任何偏好設定變更,都會在下一個工作階段生效。如要啟用或停用指標收集功能,請在變更後關閉分頁並開啟另一個分頁。

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

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

gcloud config set disable_usage_reporting true