使用遠端開發部署 Kubernetes 應用程式

本頁面說明如何使用 Cloud Shell 中的遠端開發環境,快速開始使用 Cloud Code for VS Code。

在本快速入門導覽課程中,您將略過設定步驟,只要按一下按鈕,即可將專案複製到遠端開發工作區、建立叢集、在這個叢集上執行 Kubernetes 應用程式、偵錯執行中的程式碼、查看有效應用程式的記錄,以及將終端機連線至執行中的容器。

事前準備

如要設定支援資源並存取 Cloud Shell,也就是您在本快速入門導覽課程中使用的 Google Cloud 遠端開發環境,請在 VS Code 中完成下列步驟:

  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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  6. 在電腦上安裝 Visual Studio Code (如果尚未安裝)。
  7. 安裝 Remote - SSH Visual Studio Code 擴充功能。
  8. 安裝 Git。 您需要使用 Git,才能將範例複製到電腦。
  9. 如果尚未安裝 Cloud Code 外掛程式,請先安裝。

啟動 Cloud Code

在 Cloud Shell 中開啟 Visual Studio Code 並連線至遠端開發環境時,該環境會提供開發 Kubernetes 應用程式所需的所有工具。

  1. 如要在遠端開發工作區中開始工作,請為複製的專案選擇偏好的語言,然後按一下「Open with Cloud Code」按鈕:

    VS Code 會啟動,並將專案複製到遠端開發工作區。

  2. 如果尚未設定必要條件,系統會提示您安裝。

建立 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.

後續步驟