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

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

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

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

事前準備

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

如要使用現有專案完成本指南，請確認您擁有完成本指南所需的權限。如果您已建立新專案，表示已具備必要權限。

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

如要使用現有專案完成本指南，請確認您擁有完成本指南所需的權限。如果您已建立新專案，表示已具備必要權限。

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. 安裝 Git。 需要使用 Git 才能將範例複製到電腦。
2. 安裝 Docker。 您必須使用 Docker 建構範例程式碼。確認本機使用者帳戶可以建構容器。
3. 如果尚未安裝 Cloud Code 外掛程式，請先安裝。

必要的角色

如要取得完成本快速入門導覽課程所需的權限，請要求管理員授予您專案的 Kubernetes Engine 管理員 (roles/container.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

建立應用程式

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

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. 系統提示啟用容器 API 時，請選取「Yes」(是)。

4. 按一下「+ Create a New GKE Cluster」(建立新的 GKE 叢集)。

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

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

7. 在 Google Cloud 控制台中，確認選取的專案是您先前建立或選擇的專案。

8. 將叢集名稱設為 my-first-cluster。

9. 選取「區域」Zonal做為位置類型，並將可用區設為 us-central1-a。

10. 點按「Create」(建立)。叢集建立作業需要幾分鐘才能完成。

11. 叢集建立完成後，請再次點選「Add a cluster to the KubeConfig」(將叢集新增至 KubeConfig)，然後從清單中選取您剛建立的叢集。

12. 新叢集會新增至設定，並設為有效環境。

執行及查看應用程式

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

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

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

   

2. 在隨即顯示的「快速挑選」選單中，選取「在 Kubernetes 中執行」。 再次收到提示時，請選取「Run on Kubernetes」(在 Kubernetes 中執行)。

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

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

5. 應用程式在 Kubernetes 上執行後，請按一下「Development sessions」(開發工作階段) 區段中「Run on Kubernetes」(在 Kubernetes 上執行) 工作的「Status」(狀態) 項目。系統會開啟視窗，並顯示「輸出」分頁，其中包含應用程式的網址。如要開啟這個網址，請按下 Control 鍵 (或 macOS 的 Command 鍵)，然後點按該網址。

   您也可以在 Google Cloud 控制台的「工作負載總覽」中找到應用程式。如要進一步瞭解正在執行的應用程式，包括外部 IP 位址和通訊埠編號，請按一下清單中的應用程式名稱。

疑難排解提示

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

1. 在 VS Code 中，按一下 「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 部分

   • 「容器」部分

     

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

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

清除所用資源

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

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

如要刪除叢集：

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

如要刪除專案 (和相關聯的資源，包括所有叢集)，請按照下列步驟操作：

注意：刪除專案會帶來以下影響：

• 專案中所有內容遭到刪除。如果使用現有專案來進行本文中的任務，刪除專案將一併移除當中已完成的其他任務'。
• 自訂專案 ID 會消失。當您之前建立這個專案時，可能建立了想要在日後使用的自訂專案 ID。如要保留使用該專案 ID 的網址 (例如 appspot.com 網址)，請刪除在該專案中選取的資源，而不是刪除整個專案。

如果打算探索多種架構、教學課程或快速入門導覽課程，重複使用專案可避免超出專案配額限制。

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.

後續步驟

• 請考慮將現有應用程式匯入 VS Code，並使用 Cloud Code 進行設定。
• 透過 Cloud Code 的 YAML 編輯支援功能，處理更進階的 Google Cloud Kubernetes 設定。
• 瞭解 Cloud Code 提供的語言專屬偵錯支援。
• 透過檔案同步和熱重載功能，加快開發速度。
• 建立及設定 GKE 叢集
• 設定私人叢集
• 如要自訂 Cloud Code 體驗，請設定相關設定。
• 將應用程式部署至 ARM64、AMD64 或混合架構 GKE 叢集。