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

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

在本快速入門課程中,您將略過設定程序,只需按一下按鈕即可將專案複製到遠端開發工作區,建立叢集、在該叢集中執行 Kubernetes 應用程式、偵錯執行中的程式碼、查看實際應用程式的記錄,以及將終端連結至執行中的容器。

事前準備

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

  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. 安裝 遠端 - 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. 按一下「add」「Add a Cluster to the KubeConfig」(將叢集新增至 KubeConfig),然後點選「Quick pick」選單中的「Google Kubernetes Engine」

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

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

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

  6. 按一下「Open」,允許 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」部分。

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

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

    在以下範例中,「變數」區段的「Local」下方,請注意 Hello, world!res._contentLength; 值為 13。

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

  7. 編輯在內�� #8 傳送至 Hello, goodbye! 的字串,然後重新啟動「在 Kubernetes 上偵錯」動作。

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

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

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

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

如要查看步驟的詳細資料,請在「Development session」窗格中按一下該步驟。「Output」窗格會在記錄輸出內容中顯示步驟。

開啟容器的終端機

如要在容器中開啟終端機,請按照下列指示操作:

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

  2. 展開下列部分:

    • 您偏好的叢集區段
    • 「Namespaces」 部分,然後選擇偏好的命名空間
    • 「Pods」專區,然後點選所需 Pod 專區
    • 「容器」部分

      Cloud Code Pod

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

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

清除所用資源

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

如要避免系統向您的帳戶收取這份快速入門課程中所用其他資源的費用,請務必刪除專案,或刪除您建立的叢集 (如果您想重複使用專案的話)。

如要刪除叢集:

  1. 按一下 「Cloud Code」,然後展開「Kubernetes」探索工具。
  2. 將游標懸停在叢集名稱上,然後按一下「open_in_new」open_in_new
  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.

後續步驟