快速入門：使用 AKS 桌面部署與管理應用程式

部署和管理 Kubernetes 應用程式通常需要撰寫 YAML 清單、執行 kubectl 指令，並在多個工具間切換。 AKS 桌面透過引導式工作流程消除這些複雜性，讓開發者與 DevOps 工程師無需深厚的 Kubernetes 專業知識，也能部署、監控、排除故障及清理應用程式。

本指南將引導你如何使用 AKS 桌面部署 TypeScript 應用程式，從建立叢集到探索應用程式日誌、指標、擴展功能及內建故障排除工具。

先決條件

Azure 訂用帳戶。如果您沒有帳戶，請建立免費的 Azure 帳戶。
Azure CLI 版本 2.64.0 或更後版本。使用 az --version 命令來檢查您的版本。若要安裝或升級，請參閱安裝 Azure CLI。
Azure aks-preview CLI 擴充功能。用這個 az extension add --name aks-preview 指令安裝。欲了解更多資訊，請參閱管理 Azure CLI 擴充功能。
安裝了 AKS 桌面。 AKS 桌面支援以下作業系統（OS）：Windows、Linux 和 Mac。
若使用現有叢集，叢集必須經過 Microsoft Entra ID 認證。為了確保您的叢集已通過 Microsoft Entra ID 認證，請使用 AKS 自動叢集。你還需要 Azure Kubernetes Service RBAC 叢集管理員角色或目標叢集的同等權限。

創建 Azure 資源

如果你沒有現有的 AKS 叢集和 Azure 容器登錄檔（ACR），你可以使用 Azure CLI 來建立它們。這些章節展示了如何建立新的資源群組、AKS 叢集和 ACR。如果您已經有這些資源，可以跳至向 AKS Desktop 註冊叢集。

設定環境變數

為了簡化指令操作，請在終端機中設定以下環境變數。記得設定 myLocation 為你的 Azure 區域。此範例用來 RAND 建立獨特的資源名稱。如果你願意，也可以用你自己的價值觀來取代這些。

RAND=$RANDOM
export RAND
echo "Random resource identifier will be: ${RAND}"
myResourceGroup=bbash$RAND
myLocation=westus3
myClusterName=clu-$RAND
registryName=bbashreg$RAND

建立資源群組

使用 az group create 指令建立一個Azure資源群組。

az group create --name $myResourceGroup --location $myLocation

建立 Azure Container Registry

使用 az acr create 命令，建立 Azure 容器登錄。

az acr create --resource-group $myResourceGroup --name $registryName --sku Basic

建立帶有 ACR 整合的 AKS 叢集

使用命令 az aks create 建立一個帶有 ACR 整合的 AKS 叢集。該 --attach-acr 參數賦予 AKS 叢集從 ACR 擷取影像的權限。此範例指令同時將--sku設置為automatic。我們建議使用 AKS 自動叢集以獲得最佳的 AKS 桌面體驗，但你也可以使用標準叢集。

az aks create --resource-group $myResourceGroup --name $myClusterName --sku automatic --attach-acr $registryName

授予叢集管理員權限

用指令 az aks show 取得叢集資源 ID，並設定為環境變數。

AKS_ID=$(az aks show --resource-group $myResourceGroup --name $myClusterName --query id --output tsv)

請使用 az role assignment create 帶有 Azure Kubernetes Service RBAC 叢集管理員角色的指令，賦予自己叢集的管理員權限。務必用你的 Microsoft Entra ID 物件 ID 來替換 <your-entra-id> 。
```
az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \
   --assignee <your-entra-id> \
   --scope $AKS_ID
```

建立一個容器映像檔進行測試

這個範例是從 Contoso Air 範例應用程式建立映像，但你也可以使用任何容器映像來測試部署 AKS 桌面應用程式。如果你想使用不同的映像檔，務必在部署步驟中替換映像細節。

建立一個新目錄，進入並複製 Contoso Air 範例應用程式。然後進入網頁應用程式目錄。如果你使用的是不同的應用程式或目錄結構，請相應調整這些指令。
```
mkdir myapp
cd myapp
git clone https://github.com/Azure-Samples/contoso-air
cd contoso-air/src/web
```
用指令 az acr build 建立並推送容器映像檔到你的容器登錄檔。如果你用的是不同的映像檔，記得相應地更新圖片名稱和路徑。
```
az acr build --resource-group $myResourceGroup --registry $registryName --image contosoair:v1 .
```

用 AKS 桌面註冊你的叢集

確保你用同一個帳號登入 AKS 桌面版，該帳號能存取 AKS 叢集。登入後，選擇 「從 Azure 訂閱加入」。
如果你有多份 Azure 訂閱，請輸入你的 Azure 訂閱名稱。（或者，選擇箭頭開啟下拉選單，然後選擇你的 Azure 訂閱。）
選擇你的叢集，然後選擇 登錄叢集

在 AKS 桌面建立受管理專案

在 AKS 桌面版中，導覽到專案標籤，選擇 建立新的受管理專案。
請配置以下專案設定：
- 基本說明：
  - 專案名稱：例如， my-dev-frontend
  - 訂用帳戶：<your-subscription-name>
  - 群組： <your-cluster-name>
Note

當設定 Azure 訂閱與 AKS 叢集時，AKS 桌面會檢查 AKS 桌面體驗所需的叢集與訂閱功能支援。
- 網路政策：你可以保留這個快速入門的預設設定，或視需要更新。
  - 若要公開該應用程式，請將 Ingress 改為 Allow all traffic。
- 計算配額：將預設值留給測試應用程式。
- 存取：新增某人或刪除該項目。
在檢視中，確認你的專案設定，然後選擇 建立專案。

部署應用程式

請提供應用程式名稱，然後選擇 建立應用程式。
為您的申請選擇一個來源。在這個例子中，選擇「 容器影像>下一步」。
請設定以下應用程式設定。你可以接受預設值，或是根據需要更新。
- 容器影像名稱：
  - 新增你的容器圖片名稱。在此範例中，我們使用 myacr.azurecr.io/contosoair:v1。
  Important
  
  你不能使用latest標籤。指定一個明確的標籤，例如 v1。
- 人脈交流：
  - 目標埠：範例容器中，設為 3000。
  - 啟用公開存取：設定若你想從公開 URL 存取應用程式。
- HPA（水平艙自動調整器）：
  - 啟用 HPA：設定為根據資源使用自動擴展應用程式。
選擇部署以部署應用程式。應用程式部署完成可能需要幾分鐘。您可以在專案總覽頁面查看部署狀態。等所有資源都顯示健康狀態後再開啟應用程式探索。

探索應用程式

在專案總覽頁面，您可以使用以下標籤瀏覽您的申請：

資源：查看該應用程式的所有 Kubernetes 資源。
地圖：視覺化所有 Kubernetes 資源如何相互互動與依賴。
日誌：查看 pod 日誌。
指標：檢視核心應用程式資源消耗。
縮放：查看縮放事件並進行更新。
洞察：排除 DNS 故障、網路流量及資源使用（預覽版）。欲了解更多資訊，請參閱使用 Insights 在 AKS 桌面中排除應用程式問題。
刪除：刪除專案。
AI 助理：使用自然語言診斷並解決叢集中的問題（預覽）。欲了解更多資訊，請參閱 AKS 桌面版的 AI 故障排除助理。

清理資源

快速啟動結束後，你可以清理自己創造的資源，避免不必要的成本。

要移除專案，請選擇刪除。如果你也想移除底層的 Azure 管理命名空間資源，請選擇 「另刪除命名空間」。

欲了解更多關於 AKS 桌面的資訊，請參閱以下資源：

意見反應

此頁面對您有幫助嗎？

上次更新時間： 2026-09-22