Cloud Code 會自動安裝及管理 minikube。如果選擇不使用依附元件管理功能,請將 minikube 二進位檔新增至 PATH。
事前準備
- 安裝 Git,讓 Cloud Code 執行 Git 作業,例如複製範例。
- 如果尚未安裝 Cloud Code 外掛程式,請先安裝。
使用範本建立應用程式
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 Guestbook 應用程式結構如下:
.
|---- .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 留言板 Node.js 範例應用程式,以下是一些重要檔案及其用途:
- .vscode
- 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:設定檔,Cloud Code 會使用這個檔案建構、部署及偵錯 Kubernetes 應用程式
使用自己的應用程式
如要瞭解如何使用現有專案,請參閱「搭配現有 Kubernetes 應用程式使用 Cloud Code」。
設定 Kubernetes 環境
執行應用程式前,請確認您已設定好將應用程式部署至偏好的 Kubernetes 環境。您可以在設定中指定這項資訊。
設定
使用「Cloud Code: Develop on Kubernetes」(Cloud Code:在 Kubernetes 上開發) 執行設定時,您可以設定可用設定,自訂部署作業。
如要新增或編輯設定,請依序前往「Run」 >「Open Configurations」,然後編輯或新增設定。建立並部署至 minikube 叢集
啟動 minikube 叢集
Cloud Code 會自動安裝及管理 minikube。如果選擇不使用依附元件管理功能,請將 minikube 二進位檔新增至 PATH。
- 啟動指令區塊面板 (按下
Ctrl/Cmd+Shift+P鍵,或依序點選「View」(瀏覽) >「Command Palette」(指令面板)),然後執行「Cloud Code: Control minikube」指令。 - 按一下「Choose a Minikube cluster (profile) to control」(選擇要控管的 Minikube 叢集 (設定檔)) 下方的「minikube」,然後按一下「Start」(開始)。
在 minikube 上執行
- 啟動指令面板,然後執行「Cloud Code: Run on Kubernetes」。
- 按一下「Use current context (minikube) to run the app?」(使用目前的環境 (minikube) 執行應用程式?) 的「Yes」。
Cloud Code 會在 minikube 叢集中執行應用程式。如果系統提示,請授權 Cloud Shell 使用您的憑證發出Google Cloud API 呼叫。
在 Cloud Code 的「Development sessions」(開發工作階段) 專區中,查看部署詳細資料。
在「Development sessions」(開發工作階段) 專區中,按一下「Portfoward URLs」(連接埠轉送網址),然後點選網址連結,即可在瀏覽器中開啟正在執行的應用程式。
開啟容器的互動式終端機
- 按一下
「Cloud Code」,然後展開「開發工作階段」探索工具。
- 依序展開「已部署的資源」和「Pod」。
- 在容器上按一下滑鼠右鍵,然後點選「Get Terminal」。
暫停或停止 minikube 叢集
- 啟動指令區塊面板 (按下
Ctrl/Cmd+Shift+P鍵,或依序點選「View」(瀏覽) >「Command Palette」(指令面板)),然後執行「Cloud Code: Control minikube」指令。 - 「Choose a Minikube cluster (profile) to control」(選擇要控制的 Minikube 叢集 (設定檔)) 選項填入後,請按一下「minikube」,然後按一下「Stop」(停止) 或「Pause」(暫停)。
建立及新增其他雲端服務供應商的叢集
如果您使用的是地端部署叢集,或是來自 Azure 或 AWS 等其他供應商的叢集,請使用供應商的工具建立叢集,並將叢集新增至 KubeConfig。
使用其他本機叢集
除了 minikube,如果您使用 Docker Desktop (適用於 Mac 或 Windows),也可以使用 Cloud Code。
如要讓 Cloud Code 搭配本機叢集運作,請確認預設設定 (例如 ~/.kube/config) 包含本機叢集。這個叢集必須設為目前的環境。
舉例來說,如果您使用 Docker Desktop 搭配本機叢集 docker-for-desktop,請執行下列指令來設定偏好的叢集:
kubectl config use-context docker-for-desktop
後續步驟
- 使用同步處理檔案和熱重載功能,加快開發速度。
- 在 Cloud Code 中偵錯應用程式