使用 Cloud Code for VS Code 部署 Kubernetes 應用程式

本頁說明如何快速開始使用 Cloud Code。

您將使用「Hello World」範例應用程式設定新的 Kubernetes 應用程式、建立叢集、在這個叢集上執行應用程式、偵錯執行中的程式碼、查看運作中應用程式的記錄,以及將終端機連線至執行中的容器。

事前準備

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Google Kubernetes Engine API.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Google Kubernetes Engine API.

    Enable the API

  8. 安裝 Git。 您需要使用 Git,才能將範例複製到電腦。
  9. 如果尚未安裝 Cloud Code 外掛程式,請先安裝。

建立應用程式

  1. 開啟指令區塊面板 (按下 Ctrl/Cmd+Shift+P 鍵,或依序點選「View」(瀏覽) >「Command Palette」(指令面板)),然後執行「Cloud Code: New Application」(Cloud Code:建立新應用程式)

  2. 選擇「Kubernetes Application」(Kubernetes 應用程式)

  3. 選擇您偏好的 Hello World 應用程式語言。

    舉例來說,選擇 Node.js: Hello World 會建立入門的 Node.js Hello World 應用程式。

  4. 儲存新應用程式。

    系統會顯示通知,確認已建立應用程式,並開啟含有應用程式的新視窗。

建立 GKE 叢集

如要建立 Standard Google Kubernetes Engine (GKE) 叢集,請按照下列步驟操作:

  1. 按一下 「Cloud Code」,然後展開「Kubernetes」部分。

  2. 按一下「新增」將叢集新增至 KubeConfig,然後在「快速挑選」選單中按一下「Google Kubernetes Engine」

  3. 系統提示啟用 container.googleapis.com 時,請選取「是」

  4. 按一下「+ 建立新的 GKE 叢集」

  5. 選擇「標準」叢集類型。

  6. 按一下「開啟」,允許 Cloud Code 開啟Google Cloud 控制台。

  7. 在 Google Cloud 控制台中,使用您建立的專案,將區域設為 us-central1-a,並將叢集名稱設為 my-first-cluster

  8. 按一下「建立」,叢集建立作業需要幾分鐘才能完成。

  9. 建立叢集後,請在「快速挑選」選單中,按一下「重新整理」

  10. 新叢集名稱顯示在清單中後,請按一下叢集名稱。新叢集會新增至設定,並設為有效環境。

執行及查看應用程式

現在已完成所有設定,可以執行應用程式並即時查看。 Cloud Code 會監看檔案系統的變更,因此您幾乎可以即時編輯及重新執行應用程式。

如要執行應用程式,請按照下列步驟操作:

  1. 在 Cloud Code 狀態列中,按一下有效專案名稱。

    狀態列中的有效專案名稱

  2. 在隨即顯示的「快速挑選」選單中,選取「在 Kubernetes 中執行」

  3. 確認是否要使用目前的叢集環境,或切換至其他環境。

  4. 如果系統顯示提示,請選擇要將映像檔推送至哪個映像檔登錄服務。如果使用 gcr.io/PROJECT_ID 建立新的映像檔登錄檔,請確保映像檔登錄檔與叢集位於同一個專案中。

    輸出視窗會隨即顯示,您可以在此追蹤執行中應用程式的進度。您也會在終端機輸出內容中,看到執行中 Pod 的記錄直播。

  5. 應用程式在 Kubernetes 上執行後,輸出視窗會顯示 IP 位址。如要使用這個已連結的 IP 位址存取應用程式,請按下 Ctrl/Cmd,然後按一下該位址。

疑難排解提示

如果您使用現有叢集,請按照下列步驟將叢集設為作用中,並取得叢集憑證:

  1. 按一下 「Cloud Code」,然後展開「Kubernetes」部分。

  2. 在叢集名稱上按一下滑鼠右鍵,然後點選「設為主動叢集」

對應用程式進行偵錯

如要偵錯應用程式,請按照下列步驟操作:

  1. 在 Cloud Code 狀態列中,按一下有效專案名稱。

    狀態列中的有效專案名稱

  2. 在隨即顯示的「快速挑選」選單中,選取「在 Kubernetes 上偵錯」

  3. 如果系統提示,請驗證憑證,在本機執行及偵錯應用程式

  4. 系統顯示提示時,請確認是否要使用目前的叢集環境,或切換至偏好的環境。

    Cloud Code 會使用 .vscode/launch.json 檔案中的 cloudcode.kubernetes 設定執行應用程式,並將偵錯工具工作階段附加至應用程式。

    Cloud Code 會建構容器、將容器推送至登錄檔、將 Kubernetes 設定套用至叢集,然後傳回可用來瀏覽運作中應用程式的 IP 位址。

  5. 在附加偵錯工具工作階段之前,系統會提示您確認或輸入遠端容器中要偵錯的程式所在目錄,或按 ESC 鍵略過容器偵錯。

  6. 如要在第 9 行新增中斷點,請開啟 src/app.js,然後在編輯器邊緣按一下。

    紅色實心圓圈代表有效中斷點,灰色空心圓圈代表已停用的中斷點。如要更精細地控制中斷點,可以使用 VS Code「Debug」檢視畫面中的「Breakpoints」部分。

    「偵錯檢視」左側面板中的「中斷點」部分,可供新增、移除及停用中斷點

    傳送新要求到應用程式後,偵錯工具會暫停在第一個有效中斷點。

    在下列範例的「Variables」部分中,請注意「Local」下方的 Hello, world!res._contentLength; 值為 13。

    應用程式在中斷點暫停,變數和呼叫堆疊區段填入範圍內的值

  7. 將第 8 行傳送的字串內嵌編輯為 Hello, goodbye!,然後重新啟動「Debug on Kubernetes」(在 Kubernetes 上偵錯) 動作。

    重新建構及重新部署應用程式後,請注意 res._contentLength 的更新值。

    應用程式在中斷點暫停,並顯示更新後的值

偵錯工作階段開始後,「開發工作階段」窗格會顯示結構化記錄檢視畫面。工作開始後,工作會顯示旋轉的半圓形 progress_activity

如果工作成功,步驟旁會顯示勾號 check_circle

如要查看步驟詳細資料,請在「Development session」(開發工作階段) 窗格中點按該步驟。「輸出」窗格會顯示記錄輸出內容中的步驟。

開啟容器的終端機

如要在容器中開啟終端機,請按照下列操作說明執行:

  1. 按一下 「Cloud Code」,然後展開「Kubernetes」部分。

  2. 展開下列各節:

    • 偏好叢集區段
    • 「Namespaces」(命名空間) 區段,然後是您偏好的命名空間區段
    • 「Pod」部分,然後是偏好 Pod 的部分
    • 「容器」部分

      Cloud Code Pod

  3. 在要開啟終端機的容器上按一下滑鼠右鍵,然後點選「Get Terminal」(取得終端機)

    這會啟動終端機。現在您可以存取執行中容器內的殼層。

清除所用資源

停止應用程式後,系統會自動刪除執行期間部署的所有 Kubernetes 資源。

如要避免系統向您的帳戶收取本快速入門指南中所用其他資源的相關費用,請務必刪除專案或您建立的叢集 (如要重複使用專案)。

如要刪除叢集:

  1. 按一下 「Cloud Code」,然後展開「Kubernetes」探索工具。
  2. 將指標懸停在叢集名稱上,然後按一下「open_in_new」open_in_new「在控制台中開啟」 Google Cloud
  3. 按一下「Delete」(刪除),然後點選「Delete」(刪除)

如要刪除專案 (和相關聯的資源,包括任何叢集),請按照下列步驟操作:

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

後續步驟