建立與配置受管理車隊命名空間

適用於: ✔️ 使用中樞叢集的車隊管理器

本文將教你如何使用 Fleet Manager 建立並配置一個受管理的 Fleet 命名空間,該命名空間定義資源配額、網路政策,以及多個叢集上指定的使用者權限。

如果您想查看或存取您已能存取的現有管理車隊 命名空間,請參閱「檢視並存取管理車隊命名空間」。

已知的限制

  • 受控機群命名空間採用單一叢集的受控 Kubernetes 命名空間或反之亦然時,可能導致所有權發生衝突。 為避免這個狀況,請同時對受控機群和 Kubernetes 命名空間使用 keep 的刪除原則。
  • 叢集必須是由託管受控機群命名空間之機群管理員管理的成員。
  • 叢集必須至少有 1.30.0 的 Kubernetes 版本。 低於此版本的叢集 不會 阻止叢集用戶修改已放置的 Kubernetes 資源。
  • 分配給管理艦隊命名空間範圍的 RBAC 角色,會對成員叢集中同名的非管理 Kubernetes 命名空間享有等效存取權。

開始之前

  • 安裝並設定 Terraform。

  • 你需要安裝 Azure CLI 來驗證 Terraform 所建立的管理車隊命名空間。 若要安裝或升級,請參閱安裝 Azure CLI。

  • 你需要使用 fleet Azure CLI 擴充套件 1.8.0 或更新版本來驗證 Managed Fleet 命名空間。 你可以用 az extension add and az extension update 指令安裝並更新到最新版本。

    az extension add --name fleet
    az extension update --name fleet
    
  • 如果您還沒有具有中樞叢集的 Fleet Manager,本文的第一部分會使用與 Managed Fleet Namespace 範例分開的 Terraform 範例和狀態檔,為您建立一個。 如果你已經有,請注意它的資源群組和艦隊管理員名稱,然後跳過到 Terraform 建立管理艦隊命名空間。

  • Terraform 的前置範例僅建立一個艦隊管理器與樞紐叢集;它不會建立或加入任何成員叢集。 你可以建立一個管理艦隊命名空間,並在沒有任何成員叢集加入的情況下查看其設定,但要驗證命名空間是否真的會擴展(傳播)到某個成員叢集,至少需要有一個 AKS 叢集加入該艦隊。 如果你還沒有這樣做,請參閱現有支援的指引,建立至少一個 Azure Kubernetes Service (AKS) 叢集並將其加入機群。

  • 你需要安裝 Azure CLI 2.78.0 或更新版本才能完成本文。 若要安裝或升級,請參閱安裝 Azure CLI。

  • 你需要 fleet Azure CLI 擴充套件 1.8.0 或更新版本。 您可以使用 和 az extension addaz extension update 命令安裝它並更新到最新版本。

    # Install the extension
    az extension add --name fleet
    
    # Update the extension
    az extension update --name fleet
    
  • 請用指令 az extension show 確認艦隊擴充版本至少是 1.8.0。

    az extension show --name fleet
    
  • 為您的訂用帳戶識別碼、資源群組、叢集和叢集成員設定下列環境變數:

    export SUBSCRIPTION_ID=<subscription-id>
    export GROUP=<resource-group-name>
    export FLEET=<fleet-name>
    export FLEET_ID=<fleet-id>
    
  • 使用命令 az account set 設定預設 Azure 訂用帳戶。

    az account set --subscription ${SUBSCRIPTION_ID}
    

建立新的管理艦隊命名空間

使用指令 az fleet namespace create 建立一個新的管理艦隊命名空間。

    az fleet namespace create \
        --resource-group $GROUP \
        --fleet-name $FLEET \
        --name my-managed-namespace \ 
        --annotations annotation1=value1 annotation2=value2 \
        --labels team=myTeam label2=value2 \
        --cpu-requests 1m \
        --cpu-limits 4m \
        --memory-requests 1Mi \
        --memory-limits 4Mi \
        --ingress-policy allowAll \
        --egress-policy allowAll \
        --delete-policy keep \
        --adoption-policy never

備註

這些設定為可選:網路政策、計算配額、刪除與採用政策、標籤與註解。

使用網路政策時,使用者在 Microsoft Entra ID 角色上執行 Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write 動作(例如 Azure Kubernetes Service RBAC Writer),可以透過 Kubernetes API 新增更多網路政策。

例如,如果管理員套用 Deny All 進出政策,使用者透過 Kubernetes API 套用 Allow 命名空間策略,該 Allow 政策優先於該 Deny All 政策,流量便可流向該命名空間。 這種加法行為是網路政策的標準。

指派使用者或群組存取權限

你現在可以透過 Azure RBAC 內建角色之一,授權使用者跨成員叢集存取受管車隊命名空間。

使用命令 az role assignment create 建立角色指派。

以下範例指派使用者在任何收到 受控機群命名空間的叢集上,擔任成員叢集的 my-managed-namespace:

az role assignment create \
    --role "Azure Kubernetes Fleet Manager RBAC Writer for Member Clusters" \
    --assignee <USER-ENTRA-ID> \
    --scope "$FLEET_ID/managedNamespaces/my-managed-namespace"

新增成員叢集

您可以指定所需的成員叢集名稱清單,以控制要將受管理命名空間部署至哪些成員叢集。

使用az fleet namespace create命令與--member-cluster-names參數,指定要部署受管理命名空間的成員叢集完整清單。 管理命名空間會傳播到列表中的所有叢集。

在此範例中,受管理命名空間部署至contoso-prd-01-fm和contoso-prd-02-fm。

az fleet namespace create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace \
    --member-cluster-names contoso-prd-01-fm contoso-prd-02-fm

移除成員叢集

您可以將成員叢集從想放置的命名空間清單上排除,藉此移除受控機群命名空間中的成員叢集。

使用 az fleet namespace create 指令並搭配 --member-cluster-names 參數,以指定要讓受管理命名空間保留的成員叢集列表。 管理命名空間會從任何被排除在列表中的叢集中移除。

在此範例中,管理命名空間從 contoso-prd-02-fm 中移除。

az fleet namespace create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace \
    --member-cluster-names contoso-prd-01-fm

配置現有的管理車隊命名空間

您可以使用已更新參數值的 az fleet namespace create 指令,修改現有管理車隊命名空間的網路政策、資源配額、標籤與註解。 該指令執行 upsert 操作,若命名空間已存在則更新。

這很重要

在更新現有的受管理命名空間時,你必須指定所有想保留的參數,即使你沒有改變它們。 你省略的參數會被重置回預設值。 這包括網路政策、資源配額、標籤、註解、刪除政策、採用政策以及成員叢集名稱。

以下範例更新了現有受管理命名空間的網路政策、資源配額、標籤與註解:

az fleet namespace create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace \
    --annotations "updated-annotation=new-value" \
    --labels "team=updatedTeam environment=production" \
    --cpu-requests 1000m \
    --cpu-limits 2000m \
    --memory-requests 1000Mi \
    --memory-limits 1000Mi \
    --ingress-policy allowAll \
    --egress-policy allowAll \
    --delete-policy keep \
    --adoption-policy never \
    --member-cluster-names contoso-prd-01-fm contoso-prd-02-fm

查看管理車隊命名空間的配置

使用 az fleet namespace show 指令查看特定管理艦隊命名空間的詳細資訊。

az fleet namespace show \ 
    --resource-group $GROUP \ 
    --fleet-name $FLEET \ 
    --name my-managed-namespace \ 
    -o table 

您的輸出應該與下列範例輸出類似:

AdoptionPolicy  DeletePolicy   ETag                                    Location   Name                  ProvisioningState   ResourceGroup
--------------  ------------   -------------------------------------   --------   --------------------  -----------------   -------------
Always          Delete         "aaaaaaaa-0b0b-1c1c-2d2d-333333333333   westus2    my-managed-namespace  Succeeded           test-rg

刪除受管理的車隊命名空間

使用 指令 az fleet namespace delete 刪除一個受管理的艦隊命名空間。

az fleet namespace delete \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace 

警告

刪除將 DeletePolicy 設定為 delete 的艦隊管理命名空間是一項永久操作。 如果你不確定,應該更新政策,讓 keep 名稱空間保留。

Azure RBAC 指派總是會被刪除,以避免出現多餘的權限。

建立新的管理艦隊命名空間

你可以在 Fleet Manager 內建立新的管理車隊命名空間,或透過 Kubernetes 中心。

從車隊經理開始:

  • 在 Azure 入口網站 中,流覽至您的 Azure Kubernetes Fleet Manager 資源。
  • 在左側選單中,在 艦隊資源下選擇 命名空間。
  • 從選單中選擇 + 建立,然後選擇 管理艦隊命名空間。

Azure Kubernetes Fleet Manager 中建立管理車隊命名空間的 Azure 入口選單截圖。

從 Kubernetes 中心開始:

  • 開啟 Azure 入口網站中的 Kubernetes 中心 - 受控命名空間 。
  • 從選單中選擇 + 建立,然後選擇 管理艦隊命名空間。
  • 選擇 訂閱 與 車隊管理員 實例。

Azure 入口網站 Kubernetes Center 選單的截圖,用於建立管理車隊命名空間。

  • 請選擇以下選項之一以選擇 範圍:
    • 新方法 ——建立一個在 Fleet Manager 集線叢集中不存在的新 Kubernetes 命名空間。 輸入新命名空間的 名稱 。
    • 轉換為託管 - 在 Fleet Manager 中樞叢集中使用現有的 Kubernetes 命名空間。 從 Fleet Manager 樞紐叢集的命名空間列表中選擇命名空間。

顯示基礎索引標籤的 Azure 入口網站螢幕截圖,其中新受控機群命名空間的專案細節已完成。

指派使用者或群組存取權限

選取在受控機群命名空間分散至的叢集上,存取受控機群命名空間的 Microsoft Entra 使用者和群組。

Azure 入口網站的截圖,顯示新管理車隊命名空間的存取細節已完成。

備註

這個步驟是選擇性的。 你可以建立並分發管理車隊命名空間,而不必指派使用者或群組。 這讓你能在不立即授權的情況下分發命名空間。

新增網路政策與計算配額

控制每個叢集名稱空間的網路流量進出,並定義該命名空間的 CPU 與記憶體資源配額。

Azure 入口網站截圖,顯示已完成的網路政策與新管理車隊命名空間的計算配額。

備註

這些是選擇性設定。 你可以建立並分發管理車隊命名空間,無需套用網路政策或配額控制。

使用者若在其指派的 Microsoft Entra ID 角色上具有 Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write 動作,例如 Azure Kubernetes Service RBAC Writer,便可以透過 Kubernetes API 新增更多網路政策。

例如,如果管理員套用 Deny All 進出政策,使用者透過 Kubernetes API 套用 Allow 命名空間策略,該 Allow 政策優先於該 Deny All 政策,流量便可流向該命名空間。 這種加法行為是網路政策的標準。

選取成員群組

透過以下方式新增成員叢集,以定義受控命名空間要分散至的成員叢集。

  • 從選單中選擇 + 新增。
  • 在 「選擇成員叢集」 對話框中,搜尋成員群組,並勾選方塊選取。
  • 最後,選擇 選擇 以新增成員叢集。

Azure 入口網站的截圖顯示兩個成員叢集被選中來承載新的管理車隊命名空間。

備註

這個步驟是選擇性的。 如果你沒有提供任何成員叢集,管理艦隊命名空間只會部署到 Fleet Manager 的樞紐叢集。 你可以在之後加入成員叢集。

設定標籤、註解與標記

定義 Kubernetes 可選的標籤與註解,以及可提供用於自動化與資源管理的中繼資料的 Azure 資源管理器(ARM)標籤。

Azure 入口網站的截圖顯示新管理艦隊命名空間的標籤與註解設定。

備註

這個步驟是選擇性的。 標籤、註釋和標記可以稍後管理。

建立管理艦隊命名空間

一旦你設定好新的管理艦隊命名空間的所有屬性,你可以在建立命名空間前選擇「 建立」來確認細節。

Azure 資源管理器部署會立即啟動,啟動 Fleet Manager 工作負載放置,將命名空間分配給所選叢集。

部署完成後,您可以在艦隊管理者的命名空間列表中找到「管理艦隊命名空間」。

Azure 入口網站的截圖,裡面有新的管理艦隊命名空間,並列在樞紐叢集上的其他命名空間中。

要檢視 Kubernetes 命名空間在叢集間的部署,請使用 Resource placements,並尋找與 Managed Fleet 命名空間名稱相同的資源配置。

Azure 入口網站的截圖,顯示新的管理艦隊命名空間的資源放置狀態。

配置現有的管理車隊命名空間

你可以在 Fleet Manager 內找到受管理車隊命名空間,或透過 Kubernetes 中心。

從車隊經理開始:

  • 在 Azure 入口網站 中,流覽至您的 Azure Kubernetes Fleet Manager 資源。
  • 在左側選單中,在 艦隊資源下選擇 命名空間。

從 Kubernetes 中心開始:

修改設定

在管理車隊命名空間總覽畫面中,選擇適當項目旁的「編輯」,以修改網路政策、資源配額、標籤、註釋和標記。

在標籤、註解或標籤旁選擇 編輯 ,會開啟一個對話框,你可以修改這三個項目中的任一個。

在網路政策或資源配額選項旁選擇「 編輯 」會開啟一個對話框,您可以修改這些項目。

Azure 入口網站的截圖顯示一個管理車隊命名空間的總覽畫面,編輯選項以紅色框高亮顯示。

修改使用者或群組存取權限

受管理車隊命名空間是 Azure 資源管理器(ARM)資源,因此管理使用者與群組存取可透過在「管理車隊命名空間」總覽畫面左側導覽中選擇 存取控制(IAM) 來實現。

修改成員叢集

在管理艦隊命名空間總覽中,選擇左側導覽中的 成員叢集 。

要移除成員叢集,請執行以下步驟:

  • 勾選該列左側的方塊,選擇要移除的叢集。
  • 在上方導覽中選擇 「移除」。
  • 確認動作並選擇 移除。

要新增成員叢集:

  • 從選單中選擇 + 新增。
  • 在 「新增成員叢集」 對話框中,搜尋成員叢集並勾選方塊選取。
  • 最後,選擇 新增 成員叢集。

Azure 入口網站的截圖顯示一個成員叢集已被選中,準備從管理艦隊命名空間中移除。

一旦承載該管理車隊命名空間的叢集被修改,總覽會更新為顯示目前仍承載該命名空間的叢集。

刪除受管理的車隊命名空間

在管理艦隊命名空間的總覽中,選擇頂部導覽中的 刪除 。

在 「刪除受管理艦隊命名空間 」確認中,選擇你想要的選項:

  • 保留命名空間,移除管理功能: 受管理的車隊命名空間會轉換成標準的 Kubernetes 命名空間,仍保留在 Fleet Manager 的樞紐叢集和成員叢集上,但不再由 Azure 資源管理器(ARM)管理。
  • 刪除命名空間及所有相關資源: 管理艦隊命名空間的 ARM 資源會被刪除,連同 Fleet Manager 樞紐叢集及成員叢集上的 Kubernetes 命名空間。

警告

刪除命名空間及所有相關資源是永久性的操作。 如果你不確定,應該選擇保留命名空間。

在這兩種情況下,Azure RBAC 指派都會被刪除,以避免出現懸而未決的權限。

建立新的管理艦隊命名空間

本節的 Terraform 樣本分為兩個目錄,每個目錄都有自己的 Terraform 狀態:一個前置範例,建立帶有樞紐叢集的艦隊管理者;另一個情境範例,在現有艦隊管理者上建立受管理艦隊命名空間。 透過將艦隊管理者與管理艦隊命名空間保持在不同狀態,你可以針對任何已有擁有樞紐叢集的艦隊管理者建立管理艦隊命名空間。 這個設定無論你是不是用 Terraform 建立艦隊管理員都適用。 你可以刪除一個受管 Fleet 命名空間,而不會影響 Fleet Manager 或其上的任何其他受管 Fleet 命名空間。

建立一個帶有集線器叢集的車隊管理器

如果你已經有帶有樞紐叢集的艦隊管理器,可以跳過到 Terraform 建立管理艦隊命名空間 ,並在該區塊使用其資源群組和艦隊管理員名稱。

  1. 建立一個目錄來測試範例 Terraform 程式碼,並將其設為目前的目錄。 請使用與你在本文後面所用的管理艦隊命名空間範例不同的目錄,因為每個範例都保留自己的 Terraform 狀態。

  2. 建立名為 providers.tf的檔案,並插入下列程序代碼:

    terraform {
      required_version = ">= 1.5.0"
      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~> 4.0"
        }
        azapi = {
          source  = "Azure/azapi"
          version = "~> 2.0"
        }
        random = {
          source  = "hashicorp/random"
          version = "~> 3.0"
        }
      }
    }
    
    provider "azurerm" {
      features {}
    }
    
    provider "azapi" {}
    
  3. 建立名為 variables.tf的檔案,並插入下列程序代碼:

    variable "resource_group_location" {
      type        = string
      default     = "eastus"
      description = "Location of the resource group"
    }
    variable "resource_group_name_prefix" {
      type        = string
      default     = "rg"
      description = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription."
    }
    variable "fleet_name" {
      type        = string
      description = "Name of the fleet resource. If left blank, this value is randomly generated."
      default     = ""
    }
    
  4. 建立名為 main.tf的檔案,並插入下列程序代碼:

    resource "random_pet" "rg_name" {
      prefix = var.resource_group_name_prefix
    }
    
    resource "azurerm_resource_group" "fleet_rg" {
      name     = random_pet.rg_name.id
      location = var.resource_group_location
    }
    
    resource "random_string" "fleet_name" {
      length  = 54
      lower   = true
      numeric = false
      special = false
      upper   = false
    }
    
    locals {
      fleet_name = coalesce(var.fleet_name != "" ? var.fleet_name : null, random_string.fleet_name.result)
    }
    
    # A fleet with a hub cluster is required for features such as managed namespaces,
    # which the plain azurerm_kubernetes_fleet_manager resource cannot provision because
    # its hub_profile attribute is deprecated and is no longer sent to the API.
    resource "azapi_resource" "fleet" {
      type      = "Microsoft.ContainerService/fleets@2025-03-01"
      name      = local.fleet_name
      location  = azurerm_resource_group.fleet_rg.location
      parent_id = azurerm_resource_group.fleet_rg.id
    
      body = {
        properties = {
          hubProfile = {
            dnsPrefix = local.fleet_name
          }
        }
      }
    
      identity {
        type = "SystemAssigned"
      }
    
      response_export_values = ["name"]
    }
    
  5. 建立名為 outputs.tf的檔案,並插入下列程序代碼:

    output "resource_group_name" {
      value = azurerm_resource_group.fleet_rg.name
    }
    
    output "fleet_name" {
      value = azapi_resource.fleet.name
    }
    

範例透過資源 azapi_resource 類型而非 azurerm_kubernetes_fleet_manager,建立了資源群組和一個 Fleet Manager 並建立一個集線叢集,因為 azurerm 提供者 hub_profile 的屬性已被棄用,且 Fleet API 不再接受該屬性。 如果你沒設定變數, fleet_name Terraform 會幫你隨機產生一個名稱。

執行 terraform init 來初始化 Terraform 部署。 此指令會下載管理 Azure 資源所需的 Azure 提供者。

terraform init

執行 terraform fmt 來穩定格式化設定檔。

terraform fmt

執行 terraform valid 以確認設定檔在語法上是否有效。

terraform validate

執行 terraform plan 以建立執行計畫。

terraform plan -out main.tfplan

執行terraform apply指令將執行計劃套用至您的雲端基礎設施。

terraform apply main.tfplan

從 Terraform 輸出中儲存資源群組和艦隊管理員名稱。 你需要這些數值來取得管理艦隊命名空間的樣本。

resource_group_name=$(terraform output -raw resource_group_name)
fleet_manager_name=$(terraform output -raw fleet_name)

此範例不會建立任何成員叢集,也不會將任何成員叢集加入 Fleet。 請使用 az fleet member list 指令,檢查 Fleet Manager 是否已有成員叢集加入:

az fleet member list \
    --resource-group $resource_group_name \
    --fleet-name $fleet_manager_name \
    -o table

如果這個指令沒有回傳任何成員,你仍然可以完成以下部分來建立受管理車隊命名空間並查看其設定,但你無法驗證它是否會推展到成員叢集,除非你 建立並加入至少一個 AKS 叢集到該車隊。

使用 Terraform 建立管理艦隊命名空間

  1. 建立一個新的獨立目錄來測試這個範例的 Terraform 程式碼,並將其設為目前的目錄。

  2. 建立名為 providers.tf的檔案,並插入下列程序代碼:

    terraform {
      required_version = ">= 1.5.0"
      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~> 4.0"
        }
        azapi = {
          source  = "Azure/azapi"
          version = "~> 2.0"
        }
      }
    }
    
    provider "azurerm" {
      features {}
    }
    
    provider "azapi" {}
    
  3. 建立名為 variables.tf的檔案,並插入下列程序代碼:

    variable "resource_group_name" {
      type        = string
      description = "Name of the resource group that contains the Fleet Manager."
    }
    
    variable "fleet_name" {
      type        = string
      description = "Name of the existing Azure Kubernetes Fleet Manager."
    }
    
    variable "managed_namespace_name" {
      type        = string
      description = "Name of the Managed Fleet Namespace."
      default     = "platform-ns"
    
      validation {
        condition     = can(regex("^[a-z0-9]([-a-z0-9]*[a-z0-9])?$", var.managed_namespace_name)) && length(var.managed_namespace_name) <= 63
        error_message = "The managed namespace name must be 1-63 characters, use lowercase letters, numbers, or hyphens, and start and end with a lowercase letter or number."
      }
    }
    
    variable "tags" {
      type        = map(string)
      description = "Tags to apply to the Managed Fleet Namespace."
      default = {
        environment = "demo"
        managed_by  = "terraform"
      }
    }
    
  4. 建立名為 main.tf的檔案,並插入下列程序代碼:

    data "azurerm_client_config" "current" {}
    
    data "azurerm_resource_group" "fleet_rg" {
      name = var.resource_group_name
    }
    
    locals {
      fleet_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}/resourceGroups/${var.resource_group_name}/providers/Microsoft.ContainerService/fleets/${var.fleet_name}"
    }
    
    resource "azapi_resource" "managed_fleet_namespace" {
      type      = "Microsoft.ContainerService/fleets/managedNamespaces@2025-08-01-preview"
      name      = var.managed_namespace_name
      parent_id = local.fleet_id
      location  = data.azurerm_resource_group.fleet_rg.location
      tags      = var.tags
    
      body = {
        properties = {
          adoptionPolicy = "Never"
          deletePolicy   = "Keep"
          managedNamespaceProperties = {
            labels = {
              team        = "platform"
              environment = "demo"
            }
            annotations = {
              owner                          = "aks-fleet-demo"
              "app.kubernetes.io/managed-by" = "terraform"
            }
            defaultNetworkPolicy = {
              ingress = "AllowAll"
              egress  = "AllowAll"
            }
            defaultResourceQuota = {
              cpuRequest    = "100m"
              cpuLimit      = "500m"
              memoryRequest = "128Mi"
              memoryLimit   = "512Mi"
            }
          }
          propagationPolicy = {
            type = "Placement"
            placementProfile = {
              defaultClusterResourcePlacement = {
                policy = {
                  placementType = "PickAll"
                }
              }
            }
          }
        }
      }
    }
    
    
    
  5. 建立名為 outputs.tf的檔案,並插入下列程序代碼:

    output "managed_fleet_namespace_id" {
      description = "Resource ID of the Managed Fleet Namespace."
      value       = azapi_resource.managed_fleet_namespace.id
    }
    
  6. 建立名為 terraform.tfvars.example的檔案,並插入下列程序代碼:

    resource_group_name    = "<resource-group-name>"
    fleet_name             = "<fleet-manager-name>"
    managed_namespace_name = "platform-ns"
    
  7. 複製 terraform.tfvars.example 到 terraform.tfvars 同一個目錄。 將 fleet_name 和 resource_group_name 設為你在前一節儲存的值(或現有 Fleet Manager 的值)。 設定 managed_namespace_name 為你想要的命名空間名稱。

    cp terraform.tfvars.example terraform.tfvars
    

這個範例不會建立自己的車隊管理器。 它會利用 azurerm_resource_group 和 azurerm_client_config 資料來源來查詢資源群組和目前的訂閱。 接著會建立 fleet_name 變數中指定的現有 Fleet Manager 資源 ID,並將其作為 Managed Fleet Namespace 的父資源。 這說明了範例如何在不於兩個範例之間共用 Terraform 狀態的情況下,從先決條件的狀態或任何現有且具有中樞叢集的 Fleet Manager 取得 Fleet Manager 資訊。

範例中,透過預覽 azapi_resource API 版本2025-08-01-previewMicrosoft.ContainerService/fleets/managedNamespaces的資源類型來建立命名空間,因為此資源類型尚未有原生azurerm資源。 以下屬性是硬編碼的 main.tf ,不會以變數形式暴露。 要更改它們,請直接編輯區塊:body.properties

  • adoptionPolicy 設定為 Never,且 deletePolicy 設定為 Keep,與本文先前顯示的 Azure CLI 預設值相符。
  • managedNamespaceProperties.labels 會設定 Kubernetes 標籤 team=platform 和 environment=demo。
  • managedNamespaceProperties.annotations 設定 Kubernetes 註解 owner=aks-fleet-demo 和 app.kubernetes.io/managed-by=terraform。
  • managedNamespaceProperties.defaultNetworkPolicy將 ingress 和 egress 都設為 AllowAll。
  • managedNamespaceProperties.defaultResourceQuota 集合 cpuRequest=100m、 cpuLimit=500m、 memoryRequest=128Mi、 memoryLimit=512Mi。
  • propagationPolicy.placementProfile.defaultClusterResourcePlacement.policy.placementType 設定為 PickAll,因此命名空間會傳播到目前與艦隊連接的每個成員叢集。 與 Azure CLI --member-cluster-names 的參數不同,這個範例並未公開針對特定命名成員叢集的方法。 若要將放置範圍限定為部分叢集,請使用本頁上的 Azure CLI 或 Azure 入口網站選項,或依照 Microsoft.ContainerService fleets ARM 範本參考 延伸 main.tf 中的 placementProfile 區塊。

唯一對應至 Managed Fleet Namespace 資源上的 Azure Resource Manager (ARM) 標籤,而非命名空間本身上的 Kubernetes 標籤的變數是 tags。 這是可選的,如果你沒設定,預設會變成{ environment = "demo", managed_by = "terraform" }。variables.tf 範例的 terraform.tfvars.example 未包含 tags,因此只在你想覆寫預設值時,才將 tags 加入你的 terraform.tfvars 檔案中。

執行 terraform init 來初始化 Terraform 部署。

terraform init

執行 terraform fmt 來穩定格式化設定檔。

terraform fmt

執行 terraform valid 以確認設定檔在語法上是否有效。

terraform validate

執行 terraform plan 以建立執行計畫。

terraform plan -out main.tfplan

執行terraform apply指令將執行計劃套用至您的雲端基礎設施。

terraform apply main.tfplan

指派使用者或群組存取權限

Terraform 在這個範例中不管理 Azure RBAC 角色指派。 透過指令 az role assignment create 授權使用者跨其成員叢集存取管理艦隊命名空間。 使用 Terraform 輸出作為範圍:

managed_namespace_id=$(terraform output -raw managed_fleet_namespace_id)
az role assignment create \
    --role "Azure Kubernetes Fleet Manager RBAC Writer for Member Clusters" \
    --assignee <USER-ENTRA-ID> \
    --scope "$managed_namespace_id"

新增或移除成員叢集

由於樣本 propagationPolicy 使用 PickAll,命名空間總是會傳播到艦隊中每個現有成員叢集。 將成員叢集加入艦隊會自動加入該命名空間;而從艦隊中移除成員叢集則會自動移除該命名空間。 此範例不支援像 Azure CLI 的 --member-cluster-names 參數那樣指定特定的成員叢集名稱清單。 如果您需要選取特定的成員叢集,請改用此頁面上的 Azure CLI 或 Azure 入口網站切換選項。

配置現有的管理車隊命名空間

Terraform 會針對azapi_resource類型執行 upsert ,因此您可以透過變更樣本並重新套用該樣本來更新現有的受控機群命名空間。

  • 要更改 ARM 標籤,請新增或更新 tags 中的 terraform.tfvars 變數(這是可選的,且不包含在 terraform.tfvars.example中)。
  • 要更改 Kubernetes 的標籤、註解、網路政策或資源配額,請編輯區塊main.tf中managedNamespaceProperties對應的值。 樣本並未將這些設定暴露為變數。

完成變更後,請在 Managed Fleet Namespace 目錄中重新執行 terraform plan -out main.tfplan 和 terraform apply main.tfplan。

查看管理車隊命名空間的配置

Terraform 輸出只會回傳管理艦隊命名空間的資源 ID。 從 ID 中提取資源群組、艦隊管理員及命名空間名稱。 然後用指令 az fleet namespace show 查看命名空間的詳細資訊。

managed_namespace_id=$(terraform output -raw managed_fleet_namespace_id)
resource_group_name=$(echo $managed_namespace_id | cut -d'/' -f5)
fleet_manager_name=$(echo $managed_namespace_id | cut -d'/' -f9)
managed_namespace_name=$(echo $managed_namespace_id | cut -d'/' -f11)
az fleet namespace show \
    --resource-group $resource_group_name \
    --fleet-name $fleet_manager_name \
    --name $managed_namespace_name \
    -o table

要檢視命名空間在成員叢集間的部署,請使用 資源配置,並尋找與管理艦隊命名空間名稱相同的資源配置。 使用az fleet namespace show來檢閱命名空間的組態時,不需要任何成員叢集加入機群,但若要檢閱推出或放置狀態時,則至少需要有一個成員叢集已加入機群。 如果你還沒有這麼做,請先參閱建立至少一個 Azure Kubernetes Service (AKS) 叢集並將其加入艦隊。

刪除受管理的車隊命名空間

在刪除它所屬的機群管理員之前,請先刪除受控機群命名空間。

在包含 Managed Fleet 命名空間範例的目錄中,執行帶有 -destroy 標誌的 terraform 計畫以建立銷毀執行計畫。

terraform plan -destroy -out main.destroy.tfplan

執行 terraform apply 以套用銷毀計畫。

terraform apply main.destroy.tfplan

警告

刪除設定為Delete的deletePolicy的受控機群命名空間是永久性動作。 此範例設定deletePolicy為 Keep,因此在 ARM 資源被銷毀後,Kubernetes 命名空間仍留在 Fleet Manager 集線器叢集及成員叢集上,但不再由 Azure Resource Manager 管理。 如果你想把命名空間全部移除,請改 deletePolicy 成 Delete in main.tf 並重新套用,然後再摧毀資源。

範圍限定於受控 Fleet 命名空間的 Azure RBAC 指派一律會遭到刪除,以避免殘留權限。

如果您只是為了這篇文章而使用中樞叢集先決條件樣本部署機群管理員,且不需要將它用於其他地方,請切換至該樣本所在的目錄,連它也一併銷毀。

terraform plan -destroy -out main.destroy.tfplan
terraform apply main.destroy.tfplan

警告

此指令刪除艦隊管理員、其樞紐叢集,以及由前置樣本建立的資源群組,而非僅刪除艦隊管理者。 在執行此指令前,先確認該資源群組中沒有其他你想保留的資源,且沒有其他管理艦隊命名空間或成員叢集仍依賴艦隊管理員。

後續步驟