Cloud Code for VS Code 擴充功能可為 VS Code 新增 Google Cloud 開發支援。
事前準備
安裝 Cloud Code 前,請確認下列工具已安裝並設定完成:
- 在電腦上安裝並設定 Visual Studio Code。
安裝並設定語言支援。
Cloud Code 擴充功能最適合以下語言:
安裝 Git。 您必須使用 Git,才能將範例複製到電腦。
安裝 Docker 用戶端,然後將其新增至
PATH
環境變數:- 如果您只使用 Cloud Build 或 Jib 建構,可以略過安裝 Docker。
- 如果您使用 WSL 但無法安裝 Docker Desktop,請改用 minikube 搭配 Cloud Code 進行本機開發。
如果您使用 Google Cloud,請建立 Google Cloud 專案,然後啟用計費功能。
專案可讓您將單一應用程式的所有相關資源收集在同一位置、管理 API、啟用 Google Cloud 服務、新增及移除協作者,以及管理 Google Cloud 資源的權限。
安裝 Cloud Code
從 Visual Studio Code Marketplace 安裝 Google Cloud Code 擴充功能。
或者,您也可以在 VS Code 中開啟「Extensions」檢視畫面:
按一下
「擴充功能」,或按下
Ctrl
/Cmd
+Shift
+X
。搜尋
Google Cloud Code
。按一下 [安裝]。
如果系統提示,請重新啟動 VS Code。
擴充功能安裝完成後,活動列會新增 Cloud Code 圖示,即可開始使用。您可以使用頂層應用程式工作列指定偏好設定,進一步設定 Cloud Code 安裝作業:依序前往「Code」 >「Settings」 >「Settings」 >「Extensions」,然後搜尋
Gemini Code Assist + Google Cloud Code
。
自訂版本的依附元件
根據預設,Cloud Code 會開啟「自動依附元件」,並自動為您安裝部分指令列依附元件。如果關閉自動依附元件,您可以使用自訂版本的依附元件,但必須自行安裝依附元件,Cloud Code 才能運作。
如要使用自訂版本的 Cloud Code 依附元件,請按照下列步驟操作:
依序點選「設定」>「管理」>「設定」,然後將「自動依附元件」(
cloudcode.autoDependencies
) 設為off
。在
PATH
上安裝下列依附元件:
安裝 Google Cloud CLI
首次使用需要 gcloud CLI 的功能時,系統會提供選項,讓您瞭解如何從 IDE 安裝 CLI、使用現有安裝項目,或繼續使用受管理依附元件。如要手動安裝 gcloud CLI,請參閱「安裝 gcloud CLI」。
選用:使用 VsixSignTool 驗證 Cloud Code vsix
如要使用 VsixSignTool 驗證 Cloud Code vsix,請按照下列步驟操作:
請確認你使用的是下列項目:
- NuGet 套件管理員
- Windows 作業系統
- Cloud Code 的正式版
安裝 Microsoft VsixSignTool,並記下安裝路徑。
開啟 VS Code,然後依序前往「擴充功能」
>「Cloud Code」。
在「詳細資料」分頁的「擴充功能資源」下方,按一下「Marketplace」。
在瀏覽器的 Marketplace 頁面中,按一下「資源」下方的「下載擴充功能」,即可下載 Cloud Code 的封裝版本。系統會將 Cloud Code 的封裝版本 (副檔名為
.vsix
) 下載到預設下載目錄。如要驗證最新版本以外的版本,請按一下「版本記錄」分頁,然後選取要下載的其他版本。
下載完成後,開啟終端機視窗並執行下列指令:
PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
確認輸出內容如下所示:
VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.
驗證「 Google Cloud」的憑證
為協助您使用 Google Cloud API 開發應用程式,登入 gcloud CLI 時,系統會更新應用程式預設憑證。
登入 Google Cloud
如果尚未登入 Google Cloud,請按照下列步驟登入:
- 在 Cloud Code 狀態列中,按一下「Cloud Code - Sign in」。
如果是首次在 IDE 中連線至 Google Cloud ,系統會提示您將
https://accounts.google.com
新增至信任的網域。在隨即顯示的對話方塊中,按一下「設定信任網域」:按照畫面上的提示,使用網路瀏覽器登入帳戶。
系統提示您允許 Cloud Code 存取 Google 帳戶時,請按一下「允許」。
已知問題:Edge 瀏覽器會在驗證回呼時重新導向至 HTTPS
使用 Microsoft Edge 瀏覽器驗證憑證時,您可能會發現 Edge 瀏覽器將網址 http://localhost:3000
重新導向至 https://localhost:3000
。這會導致下列失敗訊息:
The connection for this site is not secure. localhost sent an invalid response.
Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.
如要解決這個問題,請從重新導向中排除 localhost
:
在 Edge 瀏覽器的網址列中輸入
edge://net-internals/#hsts
。前往「刪除網域安全性政策」部分。
輸入
localhost
,然後按一下「刪除」。
登出 Google Cloud
- 按一下
「Cloud Code」,然後展開「說明與意見回饋」。
- 按一下「Sign Out of Google Cloud」(登出 Google Cloud),然後在系統提示時選取「Sign-out」(登出)。
- 或者,您也可以使用指令區塊面板登出。按下
Ctrl
/Cmd
+Shift
+P
鍵,或依序點選「View」(瀏覽) >「Command Palette」(指令面板),然後點選「Sign out of all accounts in Google Cloud SDK」(登出 Google Cloud SDK 中的所有帳戶)。
變更有效 Google Cloud 專案
在 Cloud Code 狀態列中,按一下有效專案名稱。
在隨即顯示的「快速挑選」選單中,選取「sync_alt」sync_alt「切換專案」。
選取專案,或在搜尋列中輸入關鍵字來篩選專案。
驗證憑證,以便在本機對應用程式偵錯
除了「登入 Google Cloud」一節中的驗證步驟外,您還需要驗證憑證,才能在 IDE 中偵錯會發出 Google API 呼叫的本機應用程式。
如果您未驗證應用程式的偵錯憑證,嘗試執行/偵錯會呼叫 Google API 的本機應用程式時,IDE 會顯示錯誤訊息。
如要驗證憑證,以便在本機上對應用程式進行偵錯,請按照下列步驟操作:
如果尚未在電腦上安裝 gcloud,請先完成這項程序。
執行下列指令:
gcloud auth application-default login
完成本機除錯後,您可以執行下列指令登出:
gcloud auth application-default revoke
如要進一步瞭解應用程式預設憑證和 Google API,請參閱「使用用戶端程式庫向 Cloud 服務進行驗證」。