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

瞭解如何使用 Cloud Code for IntelliJ 部署第一個 Kubernetes 應用程式。

在本快速入門導覽課程中，您將使用入門的 Hello World 範本設定新的 Kubernetes 應用程式、在叢集上執行應用程式、設定持續重建功能以疊代開發應用程式、偵錯執行中的程式碼，以及查看有效應用程式的串流記錄。

雖然本指南建議使用 Google Cloud ，但您也可以搭配本機叢集使用 Cloud Code，並搭配 minikube 和 Docker Desktop 等工具。不過，如要享有即時建立 GKE 叢集和整合式持續推送軟體更新等功能，建議使用Google Cloud 專案。

事前準備

無論您選擇使用本機或雲端代管叢集，如要完成本快速入門導覽，請按照下列步驟操作：

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

如要使用 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.

    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.

    Go to project selector

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

  4. Verify that billing is enabled for your Google Cloud project.

  5. 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

  6. 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.

    Go to project selector

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

  8. Verify that billing is enabled for your Google Cloud project.

  9. 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

    10.

    必要的角色

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

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

建立應用程式

Cloud Code 隨附一系列程式碼範例範本，協助您輕鬆上手。如何使用現有範例建立新應用程式：

  1. 在 IDE 中，依序開啟「File」 >「New Project」，然後選取「Cloud Code: Kubernetes」。

  2. 從入門應用程式清單中選取「Hello World」範本。 可用的範本清單：Python、Go、NodeJS、Java Hello World 和留言簿應用程式

  3. 為專案命名。

    按一下「Finish」後，Cloud Code 會複製您選擇的範本，並開啟新建立的專案供您使用。

    如果是 Java 範本，系統會提示您匯入必要的 Maven 專案，以同步處理 pom.xml。按一下「Add as Maven project」(新增為 Maven 專案)，然後按一下「Import Changes」(匯入變更)。

選擇叢集

如要開發應用程式，您需要相關聯的 Kubernetes 叢集，該叢集可透過 minikube 在本機代管，也可以使用雲端平台 (例如 Google Kubernetes Engine 叢集)。

本機叢集

如果您還沒有要用於本快速入門導覽課程的叢集，可以選擇使用 Cloud Code 管理的本機 minikube 叢集執行應用程式。Cloud Code 會啟動 minikube 叢集來執行應用程式，並在部署作業停止時停止叢集。如果 minikube 叢集已在執行中，Cloud Code 會重複使用現有的 minikube 叢集進行部署。

在下一個步驟「開發應用程式」中，您可以將這個 Cloud Code 管理的 minikube 叢集設為部署偏好設定，然後使用該叢集。

以雲端平台為基礎的叢集

如果您已設定叢集，可搭配 kubectl 等 Kubernetes 工具使用，並用於本快速入門導覽，Cloud Code 會自動將叢集部署至該叢集。您可以繼續開發應用程式，並確認偏好的叢集已設為目前的環境。

如果沒有，請按照雲端平台專屬的指示建立。如果是 GKE，請按照「建立叢集」指南操作。

開發應用程式

如要在 Kubernetes 上啟動應用程式的開發作業，請按照下列步驟操作：

  1. 如果您在雲端平台代管的叢集上執行，請確保您已定義容器映像檔的儲存位置，以供「在 Kubernetes 上開發」使用。

    如果您已登入 IDE 並定義預設專案，Cloud Code 會自動使用預設容器映像檔存放區 (gcr.io/{project_id}，其中 {project_id} 是指預設專案)。 Google Cloud

  2. 確認已設定偏好的 Kubernetes 內容。您可以在「Develop on Kubernetes」設定中指定此項目 (依序點選「Run」 >「Edit Configurations」 >「Develop on Kubernetes」即可存取)，位置在「Run」分頁的「Deployment preferences」部分。

    您可以選擇部署至目前環境 (預設)、本機的 minikube 叢集，或是其他可用環境。

    根據預設，Kubernetes 應用程式會以「以量計價模式」執行，並選取「以量計價」。你也可以視需要選取「儲存檔案時」選項。

  3. 從導覽列的「Run/Debug configuration」(執行/偵錯設定) 選取器中，選擇「Develop on Kubernetes」(在 Kubernetes 上開發) 執行目標。

    Kubernetes 部署執行設定

    這樣一來，系統就會自動建構、推送及部署任何程式碼變更，並將這些變更套用至新版應用程式。

  4. 如要在 Kubernetes 叢集上啟動開發週期，請按一下「Develop on Kubernetes」(在 Kubernetes 上開發) 的執行動作圖示 。

  5. 在輸出視窗的「記錄」分頁中，查看傳入的應用程式記錄。

    部署作業開始後，這裡就會列出已部署應用程式的轉送通訊埠清單。

  6. 部署成功後，系統會通知您有新的服務網址可用。按一下「服務網址」分頁標籤即可查看網址，然後按一下網址連結，在瀏覽器中開啟執行中的應用程式。

    在「Service URLs」分頁中查看已轉送的服務

    或者，您也可以開啟「事件記錄」，然後點選連結，在瀏覽器中開啟正在執行的應用程式。

    「已部署的資源」窗格會顯示您在開發工作階段期間部署的內容。

對應用程式進行偵錯

Cloud Code 支援在偵錯時套用變更。

如何對應用程式進行偵錯：

  1. 按一下「Develop on Kubernetes」(在 Kubernetes 上開發) 的偵錯動作圖示 偵錯動作圖示，在 Kubernetes 叢集上以偵錯模式啟動開發週期。

    在偵錯模式下啟動 Kubernetes 叢集的開發週期

  2. Cloud Code 會連結一個偵錯工作階段。成功連線後，系統會開啟「Debug Tool」視窗，並在「Console」分頁中確認連線。

    現在可以對使用中的 Kubernetes 叢集進行偵錯。

  3. 在要新增中斷點的程式碼可執行行，按一下空白處。

    紅色實心圓圈代表有效中斷點，紅色空心圓圈則代表已停用的中斷點。

  4. 傳送新要求到應用程式後，系統會暫停在想要的那一行上。

    Kubernetes 偵錯工具工作階段

  5. 如要結束偵錯工作階段，請按一下Develop on Kubernetes執行設定旁的停止圖示。

查看記錄

除了在開發及執行應用程式時，透過終端機輸出內容查看執行中 Pod 的記錄直播，您也可以前往 Kubernetes Explorer 查看特定 Pod 的記錄。

如要查看特定 Pod 的記錄，請按照下列步驟操作：

  1. 前往 Kubernetes Explorer。您可以從右側面板存取，也可以依序選取「Tools」 >「Cloud Code」 >「Kubernetes」 >「View Cluster Explorer」。

    使用右側工作列上的分頁開啟 Kubernetes Explorer 面板

  2. 選取要查看記錄的 Pod。

  3. 在 Pod 上按一下滑鼠右鍵，然後選取「Stream Logs」。或者，您也可以串流 Pod 中執行的個別容器記錄。

    這會將記錄輸出至 Kubernetes Explorer 控制台。

    使用 Pod 的右鍵選單串流記錄，將記錄輸出至 Kubernetes Explorer 控制台

清除所用資源

為了避免系統向您的 Google Cloud 帳戶收取本頁面所用資源的費用，請按照下列步驟操作。

  1. 前往 Google Cloud 控制台的「Projects」(專案) 頁面：

    前往「Projects」(專案) 頁面

  2. 選取您在本快速入門導覽課程所建立的專案，然後點選旁邊的垃圾桶圖示將其刪除。

    接著，系統就會關閉專案並排定刪除時間。

後續步驟