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

事前準備

1. 如要使用 Google Cloud，您必須建立或選取 Google Cloud 專案，並為專案啟用結帳功能。

   或者，您也可以使用託管在任何其他雲端平台上的叢集，或本機 Kubernetes 叢集，並搭配 minikube 和 Docker Desktop 等工具。

2. 安裝 Git，讓 Cloud Code 執行 Git 作業，例如複製範例。

3. 如果尚未安裝 Cloud Code 外掛程式，請先安裝。

建立應用程式

Cloud Code 提供一系列程式碼範例範本，可讓您快速上手。如何使用現有範例建立新應用程式：

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

2. 從新手應用程式清單中選取「Hello World」範本。

3. 為專案命名。

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

   針對 Java 範本，系統會提示您匯入必要的 Maven 專案，以便同步處理 pom.xml。按一下「Add as Maven project」，然後點選「Import Changes」。

選擇叢集

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

本機叢集

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

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

以雲端平台為基礎的叢集

如果您已設定叢集，可與可用於本快速入門的 Kubernetes 工具 (例如 kubectl) 搭配使用，Cloud Code 就會自動將叢集部署至該叢集。您可以繼續開發應用程式，確認偏好的叢集已設為目前的結構定義。

如果沒有，您可以按照雲端平台專屬的操作說明建立。如為 GKE，請按照建立叢集指南操作。

開發應用程式

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

1. 如果您在雲端平台代管的叢集中執行，請務必定義容器映像檔的儲存位置，以便在 Kubernetes 上進行開發。

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

2. 確認已設定偏好的 Kubernetes 結構定義。您可以在「Develop on Kubernetes」設定 (可透過「Run」 >「Edit Configurations」 >「Develop on Kubernetes」存取) 的「Run」分頁和「Deployment preferences」部分指定此值。

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

   根據預設，Kubernetes 應用程式會在選取「On demand」的「On-demand」模式下執行。如有需要，您可以改為選取「On file save」選項。

3. 從導覽列的「Run/Debug」設定選取器中，選擇「Develop on Kubernetes」執行目標。

   

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

4. 如要在 Kubernetes 叢集中啟動開發週期，請按一下「在 Kubernetes 上開發」的執行動作。

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

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

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

   

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

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

偵錯應用程式

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

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

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

   

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

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

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

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

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

   

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

查看記錄

除了在開發及執行應用程式時，在終端機輸出中查看執行中 Pod 的記錄即時串流外，您也可以前往 Kubernetes Explorer 查看特定 Pod 的記錄。

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

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

   

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

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

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