Cloud Code 可讓您根據範例或現有專案建立 Kubernetes 應用程式。
從範本建立應用程式
Cloud Code 隨附一系列程式碼範例範本，可協助您快速上手。如要使用現有範例建立 Kubernetes 應用程式，請按照下列步驟操作：
- 啟動指令面板 (按下
Ctrl/Cmd+Shift+P鍵，或依序點選「View」(瀏覽) >「Command Palette」(指令面板))，然後執行「Cloud Code: New Application」。 - 選取「Kubernetes application」(Kubernetes 應用程式) 做為範例類型。
- 依據您要使用的語言選取一個範本，選項有 NodeJS、Go、Python 和 Java。
從本機選擇偏好的應用程式位置，然後按一下「Create new application」(建立新的應用程式)儲存。
Cloud Code 會複製您選擇的範例，並開啟新的專案供您使用。
應用程式結構範例
所有語言範例應用程式的結構都近乎相同。這不僅是支援的結構，也是建議使用的入門結構。
舉例來說，Node.js 留言簿應用程式結構如下：
.
|---- .vscode
| └---- launch.json
|---- kubernetes-manifests
| |---- guestbook-backend.deployment.yaml
| |---- guestbook-backend.service.yaml
| |---- guestbook-frontend.deployment.yaml
| |---- guestbook-frontend.service.yaml
| |---- mongo.deployment.yaml
| └---- mongo.service.yaml
|---- src
| |---- backend
| | |---- Dockerfile
| | |---- index.js
| | |---- app.js
| | └---- package.json
| |---- frontend
| |---- Dockerfile
| |---- index.js
| | |---- app.js
| └---- package.json
└---- skaffold.yaml
進一步瞭解這個 Kubernetes Guestbook Node.js 範例應用程式，以下是一些重要檔案及其用途：
- .vscode
extensions.json：開啟此專案時，提示要求下載相關擴充功能launch.json：啟動設定 (類型為cloudcode.kubernetes)，用於執行或偵錯 Kubernetes 應用程式tasks.json：Visual Studio Code 工作的設定資訊
- kubernetes-manifests
guestbook-backend.deployment.yaml：後端節點的 Pod 規格guestbook-frontend.deployment.yaml：前端節點的 Pod 規格mongo.deployment.yaml：資料庫的 Pod 規格
- src
(backend|frontend)/app.js：含網路伺服器邏輯的 Node.js 程式碼(backend|frontend)/Dockerfile：用於建構程式的容器映像檔
skaffold.yaml：Skaffold 的設定檔，Cloud Code 會使用這個檔案建構、部署及偵錯 Kubernetes 應用程式
使用自己的應用程式
如需使用現有專案的步驟，請參閱使用現有 Kubernetes 應用程式的 Cloud Code。
設定 Kubernetes 環境
執行應用程式前，請確保您已完成設定，可將應用程式部署至偏好的 Kubernetes 環境。您可以在設定中指定這項資訊。
設定
使用「Cloud Code: Develop on Kubernetes」(Cloud Code：在 Kubernetes 上開發) 執行設定時，您可以透過調整可用設定的方式自訂部署作業。
如要新增或編輯設定，請依序前往「Run」 >「Open Configurations」，然後編輯或新增設定。建構設定
Cloud Code 支援 Docker、Jib 和 Buildpacks 構件類型。請參閱「設定容器映像檔建構作業偏好設定指南」，瞭解如何設定偏好的建構工具及其相關設定。
自訂啟動設定
如要設定應用程式的執行方式，可以自訂 skaffold.yaml 檔案。
您也可以編輯 .vscode/launch.json 檔案中的 cloudcode.kubernetes 設定，藉此設定啟動作業。
如要進一步瞭解如何自訂啟動設定，請參閱「Cloud Code 中的 Kubernetes」。
執行應用程式
設定應用程式後，您可以運用 skaffold dev 在 Kubernetes 叢集上執行應用程式，並即時查看。您可以在本機叢集 (例如 minikube 或 Docker Desktop)、Google Kubernetes Engine，或其他雲端服務供應商上執行應用程式。
- 開啟「Command Palette」(按下
Ctrl/Cmd+Shift+P鍵)，然後執行「Cloud Code: Run on Kubernetes」指令。 - 確認是否要使用目前的 Kubernetes 內容執行應用程式 (或切換至偏好的內容)。如要進一步瞭解如何設定 Kubernetes 環境，請參閱「設定設定」。
如果選擇遠端叢集做為環境，系統會提示您選擇要將映像檔推送至哪個映像檔登錄檔。如果專案已啟用 Artifact Registry API，且至少有一個 Artifact Registry 存放區，您可以瀏覽並選取現有的 Artifact Registry 存放區。
以下範例說明如何為一些常見的登錄檔指定容器映像檔的儲存位置：
Artifact Registry REGION-docker.pkg.dev/PROJECT_ID/REPO_NAMEDocker Hub docker.io/ ACCOUNT
如果使用私密 Docker Hub 存放區，請務必正確驗證。AWS Container Repository (ECR) AWS_ACCOUNT_ID.dkr.ecr.REGION.amazonaws.com/APPAzure Container Registry (ACR) ACR_NAME.azurecr.io/APPCloud Code 會串連這個映像檔登錄檔和 Kubernetes 資訊清單中指定的映像檔名稱，產生最終的映像檔存放區名稱。
詳情請參閱映像檔登錄處理指南。
這項選擇會儲存在
cloudcode.kubernetes啟動設定 (位於 .vscode/launch.json 中)。Cloud Code 會建構容器、將容器推送至登錄檔、將 Kubernetes 設定套用至叢集，並等待推出。
查看記錄
除了在開發及執行應用程式時，以終端機輸出內容的即時串流形式查看執行中 Pod 的記錄，您也可以前往 Kubernetes 專區，查看特定 Pod 的記錄。
如要查看特定 Pod 的記錄，請按照下列步驟操作：
- 在 Kubernetes 區段中，展開「Deployments」(部署作業)
在要查看記錄的 Pod 上按一下滑鼠右鍵，然後點選「View Logs」(查看記錄檔)。
「記錄檢視器」隨即開啟。
進行變更、重建及清理
如果您已在啟動設定中將手錶模式設為false，且想要變更應用程式，然後重建並重新部署應用程式，請按照下列步驟操作：
進行變更並儲存。
在「Debug Toolbar」中，依序按一下「Pause」 (
F6) 和「Restart」 (Ctrl/Cmd + Shift + F5)，即可重建並重新部署應用程式。如要停止執行應用程式，請在「Debug Toolbar」中按一下「Stop」。
停止應用程式後，所有已部署的 Kubernetes 資源都會從叢集刪除。您可以在啟動設定中使用 cleanUp 旗標變更這項行為。
儲存密鑰
如果程式碼包含 API 金鑰、密碼和憑證等可能屬於機密的資料，建議您將這些資料儲存為密鑰。透過 Cloud Code，您可以將這些密鑰安全地儲存在 Secret Manager 中，並在需要時以程式輔助方式擷取。
如要詳細瞭解如何使用 Cloud Code 建立及管理密鑰，請參閱 Secret Manager 指南。
查看資源詳細資料
Kubernetes 專區會顯示叢集、命名空間、節點、工作負載 (例如部署、副本集、Pod 和容器)、服務和 Ingress、設定 (例如密鑰和設定對應) 和儲存空間 (例如磁碟區)。您可以在 Kubernetes 專區中，對部分資源執行專屬動作。
如要進一步瞭解如何查看資源詳細資料，請參閱 Kubernetes 總覽。
後續步驟
- 使用建構套件、Jib 或 Docker 探索建構選項。
- 使用 同步處理檔案和熱重載 加快開發速度。
- 進一步瞭解 Cloud Code 的 YAML 編輯輔助功能。