Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op: ✔️ Fleet Manager met hubcluster
In dit artikel wordt beschreven hoe u Fleet Manager gebruikt om een Managed Fleet-naamruimte te maken en configureren waarmee resourcequota, netwerkbeleid en gedelegeerde gebruikerstoegang voor de naamruimten op meerdere clusters worden gedefinieerd.
Als u bestaande Managed Fleet-naamruimten wilt weergeven of openen waar u toegang toe hebt, bekijkt u beheerde fleet-naamruimten en opent u deze.
Bekende beperkingen
- Wanneer een Managed Fleet-naamruimte een beheerde Kubernetes-naamruimte of omgekeerd in één cluster gebruikt, kan dit leiden tot conflicterend eigendom. Gebruik een verwijderingsbeleid van
keepvoor zowel de Managed Fleet als de Kubernetes-naamruimten om problemen te voorkomen. - Clusters moeten leden zijn die worden beheerd door Fleet Manager die als host fungeren voor de Managed Fleet-naamruimte.
- Clusters moeten een Kubernetes-versie van ten minste 1.30.0 hebben. Clusters onder deze versie blokkeren niet dat gebruikers in het cluster de geplaatste Kubernetes-resources wijzigen.
- RBAC-rollen die zijn toegewezen aan een managed Fleet-naamruimtebereik verlenen gelijkwaardige toegang tot onbeheerde Kubernetes-naamruimten met dezelfde naam op lidclusters.
Voordat u begint
- U hebt een Azure-account met een actief abonnement nodig. Gratis een account maken
- U hebt een Fleet Manager met een hubcluster nodig. Als u er nog geen hebt, raadpleegt u ten minste één AKS-cluster (Azure Kubernetes Service) maken en koppelen aan de vloot.
- Zorg ervoor dat de gebruiker die de stappen uitvoert, voor Fleet Manager de rol Role Based Access Control Administrator toegewezen heeft gekregen.
- Meer informatie over het managed fleet-naamruimteconcept door het overzicht te lezen.
U moet de Azure CLI hebben geïnstalleerd om de Managed Fleet-naamruimte te verifiëren die Terraform maakt. Voor het installeren of upgraden, zie Azure CLI installeren.
U hebt de
fleetAzure CLI-extensie versie 1.8.0 of hoger nodig om de Managed Fleet-naamruimte te controleren. U kunt deze installeren en bijwerken naar de nieuwste versie met behulp van deaz extension addenaz extension updateopdrachten.az extension add --name fleet az extension update --name fleetAls u nog geen Fleet Manager met een hubcluster hebt, maakt het eerste deel van dit artikel er een voor u met behulp van een afzonderlijk Terraform-voorbeeld en de status van het managed Fleet-naamruimtevoorbeeld. Als u er al een hebt, noteert u de resourcegroep en de naam van Fleet Manager en gaat u verder naar Managed Fleet-naamruimte maken met Terraform.
Het vereiste Terraform-voorbeeld maakt alleen een Fleet Manager- en hubcluster; er worden geen lidclusters gemaakt of samengevoegd. U kunt een Managed Fleet-naamruimte maken en de configuratie ervan bekijken zonder lidclusters, maar als u controleert of de naamruimte daadwerkelijk wordt geïmplementeerd (doorgegeven) aan een lidcluster, moet ten minste één AKS-cluster zijn gekoppeld aan de Fleet. Als u er nog geen hebt, raadpleeg dan de bestaande ondersteunde richtlijnen voor het maken en toevoegen van ten minste één Azure Kubernetes Service (AKS)-cluster aan de vloot.
U moet Azure CLI versie 2.78.0 of hoger hebben geïnstalleerd om dit artikel te voltooien. Voor het installeren of upgraden, zie Azure CLI installeren.
U hebt de
fleetAzure CLI-extensie versie 1.8.0 of hoger nodig. U kunt deze installeren en bijwerken naar de nieuwste versie met behulp van deaz extension addenaz extension updateopdrachten.# Install the extension az extension add --name fleet # Update the extension az extension update --name fleetControleer of de versie van de vlootuitbreiding ten minste 1.8.0 is met behulp van de
az extension showopdracht.az extension show --name fleetStel de volgende omgevingsvariabelen in voor uw abonnements-id, resourcegroep, Fleet en Fleet Member:
export SUBSCRIPTION_ID=<subscription-id> export GROUP=<resource-group-name> export FLEET=<fleet-name> export FLEET_ID=<fleet-id>Stel het standaard Azure-abonnement in met behulp van de
az account setopdracht.az account set --subscription ${SUBSCRIPTION_ID}
Een nieuwe Managed Fleet-naamruimte maken
Maak een nieuwe Managed Fleet-naamruimte met behulp van de az fleet namespace create opdracht.
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
Opmerking
Deze instellingen zijn optioneel: netwerkbeleid, rekenquotum, verwijderings- en acceptatiebeleid, labels en aantekeningen.
Wanneer zij netwerkbeleid gebruiken, kunnen gebruikers met een Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write actie, zoals Azure Kubernetes Service RBAC Writer, op de rol die ze in Microsoft Entra ID zijn toegewezen, meer netwerkbeleidsregels toevoegen via de Kubernetes-API.
Als een beheerder bijvoorbeeld een Deny All beleid toepast voor inkomend/uitgaand verkeer en een gebruiker een Allow beleid toepast voor een naamruimte via de Kubernetes-API, heeft het Allow beleid prioriteit boven het Deny All beleid en wordt verkeer toegestaan voor de naamruimte. Dit additieve gedrag is standaard voor netwerkbeleid.
Gebruikers- of groepstoegang toewijzen
U kunt nu toegang verlenen aan een gebruiker voor de Managed Fleet-naamruimte in lidclusters met behulp van een van de ingebouwde Rollen van Azure RBAC.
Maak een roltoewijzing met behulp van de az role assignment create opdracht.
In het volgende voorbeeld wordt een gebruiker de rol Azure Kubernetes Fleet Manager RBAC Writer voor lidclusters toegewezen op elk cluster dat de my-managed-namespace Managed Fleet-naamruimte ontvangt.
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"
Lidclusters toevoegen
U kunt bepalen in welke lidclusters de beheerde naamruimte moet worden geïmplementeerd door de gewenste lijst met lidclusternamen op te geven.
Geef de volledige lijst met lidclusters op waarin u de beheerde naamruimte wilt implementeren met behulp van de az fleet namespace create opdracht met de --member-cluster-names parameter. De beheerde naamruimte wordt doorgegeven aan alle clusters in de lijst.
In dit voorbeeld wordt de beheerde naamruimte geïmplementeerd in contoso-prd-01-fm en 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
Lidclusters verwijderen
U kunt lidclusters verwijderen uit een Managed Fleet-naamruimte door ze uit te sluiten uit de lijst met lidclusters waarop u de naamruimte wilt gebruiken.
Geef de lijst op met lidclusters waarop u de beheerde naamruimte wilt blijven gebruiken met behulp van de az fleet namespace create opdracht met de --member-cluster-names parameter. De beheerde naamruimte wordt verwijderd uit clusters die uit de lijst zijn uitgesloten.
In dit voorbeeld wordt de beheerde naamruimte verwijderd uit 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
Een bestaande Managed Fleet-naamruimte configureren
U kunt netwerkbeleid, resourcequota, labels en aantekeningen op een bestaande Managed Fleet-naamruimte wijzigen met behulp van de az fleet namespace create opdracht met bijgewerkte parameterwaarden. Met de opdracht wordt een upsert-bewerking uitgevoerd, waarbij de naamruimte wordt bijgewerkt als deze al bestaat.
Belangrijk
Wanneer u een bestaande beheerde naamruimte bijwerkt, moet u alle parameters opgeven die u wilt behouden, zelfs als u deze niet wijzigt. Parameters die u weglaat, worden opnieuw ingesteld op de standaardwaarden. Dit omvat netwerkbeleid, resourcequota, labels, aantekeningen, verwijderbeleid, acceptatiebeleid en namen van ledenclusters.
In het volgende voorbeeld worden de netwerkbeleidsregels, resourcequota, labels en aantekeningen voor een bestaande beheerde naamruimte bijgewerkt:
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
De configuratie van een Managed Fleet-naamruimte weergeven
Bekijk de details van een specifieke Managed Fleet-naamruimte met behulp van de az fleet namespace show opdracht.
az fleet namespace show \
--resource-group $GROUP \
--fleet-name $FLEET \
--name my-managed-namespace \
-o table
De uitvoer zou ongeveer moeten lijken op de volgende voorbeelduitvoer:
AdoptionPolicy DeletePolicy ETag Location Name ProvisioningState ResourceGroup
-------------- ------------ ------------------------------------- -------- -------------------- ----------------- -------------
Always Delete "aaaaaaaa-0b0b-1c1c-2d2d-333333333333 westus2 my-managed-namespace Succeeded test-rg
Een Managed Fleet-naamruimte verwijderen
Verwijder een Managed Fleet-naamruimte met behulp van de az fleet namespace delete opdracht.
az fleet namespace delete \
--resource-group $GROUP \
--fleet-name $FLEET \
--name my-managed-namespace
Waarschuwing
Het verwijderen van een Fleet Managed Namespace waarop een DeletePolicy op delete is ingesteld, is een onomkeerbare actie. Als u er niet zeker van bent, moet u het beleid bijwerken om de naamruimte te keep behouden.
Azure RBAC-toewijzingen worden altijd verwijderd om zwevende machtigingen te voorkomen.
Een nieuwe Managed Fleet-naamruimte maken
U kunt een nieuwe Managed Fleet-naamruimte maken vanuit Fleet Manager of via het Kubernetes-centrum.
Beginnend bij Fleet Manager:
- Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.
- Selecteer in het linkermenu onder Fleet Resources de optie Naamruimten.
- Selecteer in het menu + Maken en vervolgens Managed Fleet-naamruimte.
Beginnend in het Kubernetes-centrum:
- Open Kubernetes Center - Beheerde naamruimten in Azure Portal.
- Selecteer in het menu + Maken en vervolgens Managed Fleet-naamruimte.
- Selecteer een Abonnements - en Fleet Manager-exemplaar .
- Selecteer een van de volgende opties voor Bereik:
- Nieuw : maak een nieuwe Kubernetes-naamruimte die niet bestaat in het Fleet Manager-hubcluster. Voer een naam in voor de nieuwe naamruimte.
- Converteren naar beheerd : gebruik een bestaande Kubernetes-naamruimte in het Fleet Manager-hubcluster. Selecteer de naamruimte in de lijst met naamruimten in het Fleet Manager-hubcluster.
Gebruikers- of groepstoegang toewijzen
Selecteer de Microsoft Entra-gebruikers en -groepen die toegang hebben tot de Managed Fleet-naamruimte op clusters waarnaar deze wordt gedistribueerd.
Opmerking
Deze stap is optioneel. U kunt een Managed Fleet-naamruimte maken en distribueren zonder gebruikers of groepen toe te wijzen. Hiermee kunt u de naamruimte distribueren zonder onmiddellijk toegang te verlenen.
Netwerkbeleid en rekenquotum toevoegen
Beheer de stroom van netwerkverkeer naar en uit de naamruimte op elk cluster waarnaar het wordt gedistribueerd, samen met het definiëren van de quota voor CPU- en geheugenresources voor de naamruimte.
Opmerking
Deze instellingen zijn optioneel. U kunt een Managed Fleet-naamruimte maken en distribueren zonder dat netwerkbeleid of quotabesturingselementen zijn toegepast.
Gebruikers met een Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write actie, zoals Azure Kubernetes Service RBAC Writer, binnen de Microsoft Entra ID-rol die aan hen is toegewezen, kunnen netwerkbeleidregels toevoegen via de Kubernetes-API.
Als een beheerder bijvoorbeeld een Deny All beleid toepast voor inkomend/uitgaand verkeer en een gebruiker een Allow beleid toepast voor een naamruimte via de Kubernetes-API, heeft het Allow beleid prioriteit boven het Deny All beleid en wordt verkeer toegestaan voor de naamruimte. Dit additieve gedrag is standaard voor netwerkbeleid.
Lidclusters selecteren
Definieer aan welke lidclusters de beheerde naamruimte moet worden gedistribueerd door ze als volgt toe te voegen.
- Selecteer + Toevoegen in het menu.
- Zoek in het dialoogvenster Lidclusters selecteren naar de lidclusters en selecteer deze door het selectievakje in te schakelen.
- Kies tot slot Selecteren om de lidclusters toe te voegen.
Opmerking
Deze stap is optioneel. Als u geen lidclusters opgeeft, wordt de Managed Fleet-naamruimte alleen geïmplementeerd in het Fleet Manager-hubcluster. U kunt op een later tijdstip lidclusters toevoegen.
Labels, aantekeningen en tags instellen
Definieer optionele Kubernetes-labels en aantekeningen en ARM-tags (Azure Resource Manager) die metagegevens bieden die kunnen worden gebruikt voor automatisering en resourcebeheer.
Opmerking
Deze stap is optioneel. U kunt labels, aantekeningen en tags op een later tijdstip beheren.
De naamruimte voor beheerde vloot aanmaken
Zodra u alle eigenschappen voor de nieuwe Managed Fleet-naamruimte hebt geconfigureerd, kunt u de details bevestigen voordat u de naamruimte maakt door Maken te selecteren.
Er wordt onmiddellijk een Azure Resource Manager-implementatie gestart, waarmee de plaatsing van een Fleet Manager-workload wordt gestart om de naamruimte te distribueren naar de geselecteerde clusters.
Zodra de implementatie is voltooid, kunt u de Managed Fleet-naamruimte vinden in de lijst met naamruimten voor Fleet Manager.
Als u de implementatie van de Kubernetes-naamruimte tussen clusters wilt bekijken, gebruikt u Resourceplaatsingen en zoekt u naar de plaatsing van resources met dezelfde naam als de Managed Fleet-naamruimte.
Een bestaande Managed Fleet-naamruimte configureren
U kunt een Managed Fleet-naamruimte vinden vanuit Fleet Manager of via het Kubernetes-centrum.
Beginnend bij Fleet Manager:
- Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.
- Selecteer in het linkermenu onder Fleet Resources de optie Naamruimten.
Beginnend in het Kubernetes-centrum:
- Open Kubernetes Center - Beheerde naamruimten in Azure Portal.
- Stel het Type-filter in op Managed Fleet Namespace.
Configuratie wijzigen
Wijzig netwerkbeleid, resourcequota, labels, aantekeningen en tags door bewerken te selecteren naast het juiste item in het overzichtsscherm van Managed Fleet Namespace.
Als u bewerken selecteert naast labels, aantekeningen of tags, wordt een dialoogvenster geopend waarin u een van deze drie items kunt wijzigen.
Als u bewerken selecteert naast een van de netwerkbeleids- of resourcequotaopties, wordt een dialoogvenster geopend waarin u een van deze items kunt wijzigen.
Gebruikers- of groepstoegang wijzigen
Een Managed Fleet-naamruimte is een ARM-resource (Azure Resource Manager), zodat het beheren van gebruikers- en groepstoegang kan worden bereikt door Toegangsbeheer (IAM) te selecteren in de linkernavigatiebalk in het overzichtsscherm Fleet-naamruimte beheren.
Lidmaatschapsclusters wijzigen
In het overzicht van de Managed Fleet Namespace, selecteer lidclusters in de linkernavigatie.
Lidclusters verwijderen:
- Selecteer de clusters die u wilt verwijderen door het selectievakje links van de rij in te schakelen.
- Selecteer Verwijderen in de bovenste navigatiebalk.
- Bevestig de actie en selecteer Verwijderen.
Lidclusters toevoegen:
- Selecteer + Toevoegen in het menu.
- Zoek in het dialoogvenster Lidclusters toevoegen naar de lidclusters en selecteer deze door het selectievakje in te schakelen.
- Kies Ten slotte Toevoegen om de lidclusters toe te voegen.
Zodra de clusters die als host fungeren voor de Managed Fleet-naamruimte zijn gewijzigd, wordt het overzicht bijgewerkt om de clusters weer te geven die actief als host fungeren voor de naamruimte.
Een Managed Fleet-naamruimte verwijderen
Selecteer verwijderen in het overzicht van de Managed Fleet-naamruimte in de bovenste navigatiebalk.
Selecteer in de bevestiging Managed Fleet-naamruimte verwijderen de gewenste optie:
- Naamruimte behouden, beheermogelijkheden verwijderen: de Managed Fleet-naamruimte wordt geconverteerd naar een standaard Kubernetes-naamruimte, die in het Fleet Manager-hubcluster en lidclusters blijft, maar niet meer wordt beheerd door Azure Resource Manager (ARM).
- Namespace en alle gekoppelde resources verwijderen: de Managed Fleet Namespace ARM-resource wordt verwijderd, samen met de Kubernetes-namespace op zowel het Fleet Manager hubcluster als de lidclusters.
Waarschuwing
Het verwijderen van de naamruimte en alle bijbehorende resources is een permanente actie. Als u het niet zeker weet, moet u ervoor kiezen om de naamruimte te behouden.
In beide gevallen worden Azure RBAC-toewijzingen verwijderd om zwevende machtigingen te voorkomen.
Een nieuwe Managed Fleet-naamruimte maken
De Terraform-voorbeelden in deze sectie zijn verdeeld over twee mappen, elk met een eigen Terraform-status: een vereiste voorbeeld waarmee een Fleet Manager met een hubcluster wordt gemaakt en een voorbeeldscenario waarmee de Managed Fleet-naamruimte in een bestaande Fleet Manager wordt gemaakt. Door de Fleet Manager en de Managed Fleet-naamruimte in afzonderlijke statussen te houden, kunt u een Managed Fleet-naamruimte maken voor elke bestaande Fleet Manager met een hubcluster. Deze installatie werkt of u de Fleet Manager al dan niet hebt gemaakt met behulp van Terraform. U kunt een Managed Fleet-naamruimte vernietigen zonder dat dit van invloed is op de Fleet Manager of andere Beheerde Fleet-naamruimten.
Een Fleet Manager maken met een hubcluster
Als u al een Fleet Manager met een hub-cluster hebt, ga dan naar De beheerde Fleet-naamruimte maken met Terraform en gebruik de resourcegroep en de naam van de Fleet Manager in die paragraaf.
Opmerking
De voorbeeldcode voor deze sectie bevindt zich in de Azure Terraform GitHub opslagplaats. Bekijk het logboekbestand met de testresultaten van de huidige en vorige versies van Terraform.
Zie meer artikelen en voorbeeldcode over het gebruik van Terraform voor het beheren van Azure-resources.
Maak een map waarin de Terraform-voorbeeldcode moet worden getest en maak deze de huidige map. Gebruik een map die gescheiden is van de map die u gebruikt voor het managed fleet-naamruimtevoorbeeld verderop in dit artikel, omdat elk voorbeeld een eigen Terraform-status behoudt.
Maak een bestand met de naam
providers.tfen voeg de volgende code in: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" {}Maak een bestand met de naam
variables.tfen voeg de volgende code in: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 = "" }Maak een bestand met de naam
main.tfen voeg de volgende code in: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"] }Maak een bestand met de naam
outputs.tfen voeg de volgende code in:output "resource_group_name" { value = azurerm_resource_group.fleet_rg.name } output "fleet_name" { value = azapi_resource.fleet.name }
Het voorbeeld maakt met behulp van het resourcetype azapi_resource in plaats van azurerm_kubernetes_fleet_manager een resourcegroep en een Fleet Manager met een hubcluster, omdat het kenmerk azurerm van de provider hub_profile verouderd is en de Fleet-API dit kenmerk niet langer accepteert. Als u de fleet_name variabele niet instelt, genereert Terraform een willekeurige naam voor u.
Voer terraform init uit om de Terraform-implementatie te initialiseren. Met deze opdracht worden de Azure providers gedownload die nodig zijn om uw Azure resources te beheren.
terraform init
Voer terraform fmt uit om de configuratiebestanden consistent te formatteren.
terraform fmt
Voer terraform-validatie uit om te controleren of de configuratiebestanden syntactisch geldig zijn.
terraform validate
Voer terraform-plan uit om een uitvoeringsplan te maken.
terraform plan -out main.tfplan
Voer terraform apply uit om het uitvoeringsplan toe te passen op uw cloudinfrastructuur.
terraform apply main.tfplan
Sla de namen van de resourcegroep en Fleet Manager op uit de Terraform-uitvoer. U hebt deze waarden nodig voor het managed fleet-naamruimtevoorbeeld.
resource_group_name=$(terraform output -raw resource_group_name)
fleet_manager_name=$(terraform output -raw fleet_name)
In dit voorbeeld worden geen lidclusters gemaakt of gekoppeld aan de Fleet. Controleer of de Fleet Manager al lidclusters heeft gekoppeld met behulp van de az fleet member list opdracht:
az fleet member list \
--resource-group $resource_group_name \
--fleet-name $fleet_manager_name \
-o table
Als deze opdracht geen leden retourneert, kunt u nog steeds de volgende sectie voltooien om een Managed Fleet-naamruimte te maken en de configuratie ervan weer te geven, maar u kunt niet controleren of deze wordt uitgerold naar een lidcluster totdat u ten minste één AKS-cluster maakt en aan de vloot koppelt.
De Managed Fleet-naamruimte maken met Terraform
Opmerking
De voorbeeldcode voor deze sectie bevindt zich in de Azure Terraform GitHub opslagplaats. Bekijk het logboekbestand met de testresultaten van de huidige en vorige versies van Terraform.
Zie meer artikelen en voorbeeldcode over het gebruik van Terraform voor het beheren van Azure-resources.
Maak een nieuwe, afzonderlijke map om de Terraform-code van dit voorbeeld te testen en maak deze de huidige map.
Maak een bestand met de naam
providers.tfen voeg de volgende code in: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" {}Maak een bestand met de naam
variables.tfen voeg de volgende code in: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" } }Maak een bestand met de naam
main.tfen voeg de volgende code in: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" } } } } } } }Maak een bestand met de naam
outputs.tfen voeg de volgende code in:output "managed_fleet_namespace_id" { description = "Resource ID of the Managed Fleet Namespace." value = azapi_resource.managed_fleet_namespace.id }Maak een bestand met de naam
terraform.tfvars.exampleen voeg de volgende code in:resource_group_name = "<resource-group-name>" fleet_name = "<fleet-manager-name>" managed_namespace_name = "platform-ns"Kopieer
terraform.tfvars.examplenaarterraform.tfvarsin dezelfde map. Stelresource_group_nameenfleet_namein op de waarden die u in de vorige sectie hebt opgeslagen (of op de waarden van uw bestaande Fleet Manager). Stelmanaged_namespace_namein op de gewenste naam voor de naamruimte.cp terraform.tfvars.example terraform.tfvars
In dit voorbeeld wordt geen eigen Fleet Manager aangemaakt. In plaats daarvan worden de azurerm_resource_group en azurerm_client_config gegevensbronnen gebruikt om de resourcegroep en het huidige abonnement op te zoeken. Vervolgens wordt de resource-id samengesteld van de bestaande Fleet Manager waarvan de naam is opgegeven in de variabele fleet_name, om te gebruiken als bovenliggend element voor de Managed Fleet-naamruimte. Op deze manier gebruikt het voorbeeld de Fleet Manager-gegevens van de vereiste status of van een bestaande Fleet Manager met een hubcluster, zonder Terraform-status tussen de twee voorbeelden te delen.
In het voorbeeld wordt de naamruimte gemaakt met behulp van het azapi_resource resourcetype in de preview-API-versie 2025-08-01-preview van Microsoft.ContainerService/fleets/managedNamespaces, omdat dit resourcetype nog geen systeemeigen azurerm resource heeft. De volgende eigenschappen zijn vastgelegd in main.tf en worden niet weergegeven als variabelen. Als u deze wilt wijzigen, bewerkt u het body.properties blok rechtstreeks:
-
adoptionPolicyis ingesteld opNeverendeletePolicyis ingesteldKeepop , overeenkomend met de Azure CLI standaardwaarden die eerder in dit artikel worden weergegeven. -
managedNamespaceProperties.labelsstelt de Kubernetes-labelsteam=platformenenvironment=demo. -
managedNamespaceProperties.annotationsstelt de Kubernetes-aantekeningenowner=aks-fleet-demoenapp.kubernetes.io/managed-by=terraform. -
managedNamespaceProperties.defaultNetworkPolicystelt zowelingressalsegressin opAllowAll. -
managedNamespaceProperties.defaultResourceQuotasteltcpuRequest=100m,cpuLimit=500m,memoryRequest=128MienmemoryLimit=512Miin. -
propagationPolicy.placementProfile.defaultClusterResourcePlacement.policy.placementTypeis ingesteld opPickAll, zodat de naamruimte wordt doorgegeven aan elk lidcluster dat momenteel aan de Vloot is toegevoegd. In tegenstelling tot de parameter van--member-cluster-namesAzure CLI biedt dit voorbeeld geen manier om specifieke benoemde lidclusters te targeten. Als u de plaatsing wilt beperken tot een subset van clusters, gebruikt u de draaipunten voor Azure CLI of Azure Portal op deze pagina, of breidt u het blokplacementProfileinmain.tfuit volgens de ARM-sjabloonreferentie voor Microsoft.ContainerService-fleets.
De enige variabele die wordt toegewezen aan Azure Resource Manager (ARM)-tags in de Managed Fleet-naamruimteresource, in plaats van Kubernetes-labels op de naamruimte zelf, istags. Het is optioneel en krijgt standaard de waarde { environment = "demo", managed_by = "terraform" } in variables.tf als u dit niet instelt. Het voorbeeld terraform.tfvars.example bevat niet tags, dus voeg het alleen toe aan uw terraform.tfvars bestand als u de standaardwaarde wilt overschrijven.
Voer terraform init uit om de Terraform-implementatie te initialiseren.
terraform init
Voer terraform fmt uit om de configuratiebestanden consistent te formatteren.
terraform fmt
Voer terraform-validatie uit om te controleren of de configuratiebestanden syntactisch geldig zijn.
terraform validate
Voer terraform-plan uit om een uitvoeringsplan te maken.
terraform plan -out main.tfplan
Voer terraform apply uit om het uitvoeringsplan toe te passen op uw cloudinfrastructuur.
terraform apply main.tfplan
Gebruikers- of groepstoegang toewijzen
Terraform beheert in dit voorbeeld geen Azure RBAC-roltoewijzingen. Ververleent een gebruiker toegang tot de Managed Fleet-naamruimte in de lidclusters met behulp van de az role assignment create opdracht. Gebruik de Terraform-uitvoer als de scope:
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"
Lidclusters toevoegen of verwijderen
Omdat de propagationPolicy van het voorbeeld PickAll gebruikt, wordt de namespace altijd doorgegeven aan elk huidig lidcluster van de Fleet. Als u een lidcluster toevoegt aan de Fleet, wordt de naamruimte automatisch aan het cluster toegevoegd en wordt de naamruimte automatisch verwijderd door een lidcluster uit de Fleet te verwijderen. Het voorbeeld biedt geen ondersteuning voor het richten van een specifieke lijst met lidclusternamen zoals de parameter van de Azure CLI --member-cluster-names doet. Als u specifieke lidclusters wilt selecteren, gebruikt u in plaats daarvan de Azure CLI of Azure portalpivots op deze pagina.
Een bestaande Managed Fleet-naamruimte configureren
Terraform voert een upsert uit voor het azapi_resource type, zodat u een bestaande Managed Fleet-naamruimte kunt bijwerken door het voorbeeld te wijzigen en opnieuw toe te past.
- Als u de ARM-tags wilt wijzigen, voegt u de
tagsvariabeleterraform.tfvarstoe of werkt u deze bij (dit is optioneel en is niet opgenomen interraform.tfvars.example). - Als u de Kubernetes-labels, aantekeningen, netwerkbeleid of resourcequota wilt wijzigen, bewerkt u de bijbehorende waarden in het
managedNamespacePropertiesblok vanmain.tf. In het voorbeeld worden deze instellingen niet als variabelen weergegeven.
Nadat u de wijzigingen hebt aangebracht, voert u terraform plan -out main.tfplan en terraform apply main.tfplan opnieuw uit in de map van de Managed Fleet Namespace.
De configuratie van een Managed Fleet-naamruimte weergeven
De Terraform-uitvoer retourneert alleen de resource-id van de Managed Fleet-naamruimte. Haal de namen van de resourcegroep, de Fleet Manager en de naamruimte uit de ID. Bekijk vervolgens de details van de naamruimte met behulp van de az fleet namespace show opdracht.
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
Als u de implementatie van de naamruimte tussen lidclusters wilt bekijken, gebruikt u Resourceplaatsingen en zoekt u naar de resourceplaatsing met dezelfde naam als de Managed Fleet-naamruimte. Als u de configuratie van de naamruimte controleert met behulp van az fleet namespace show , hoeven er geen lidclusters aan de Vloot te worden toegevoegd, maar voor het controleren van de implementatie- of plaatsingsstatus is ten minste één lidcluster gekoppeld. Als u er nog geen hebt, zie eerst ten minste één Azure Kubernetes Service (AKS)-cluster maken en toevoegen aan de vloot.
Een Managed Fleet-naamruimte verwijderen
Verwijder de naamruimte voor beheerde fleets voordat u de Fleet Manager verwijdert waartoe deze behoort.
Voer in de map met het managed fleet-naamruimtevoorbeeld terraform-plan uit met de -destroy vlag om een vernietigingsuitvoeringsplan te maken.
terraform plan -destroy -out main.destroy.tfplan
Voer terraform apply uit om het destroy-plan toe te passen.
terraform apply main.destroy.tfplan
Waarschuwing
Het verwijderen van een Managed Fleet-naamruimte die is geconfigureerd met een deletePolicy van Delete is een permanente actie. In dit voorbeeld wordt deletePolicy ingesteld op Keep, dus nadat de ARM-resource is verwijderd, blijft de Kubernetes-naamruimte bestaan op het Fleet Manager-hubcluster en de memberclusters, maar wordt deze niet langer beheerd door Azure Resource Manager. Als u de naamruimte in plaats daarvan overal wilt verwijderen, wijzigt u deletePolicy in Delete in main.tf en past u deze opnieuw toe voordat u de resource vernietigt.
Azure RBAC-toewijzingen die zijn gericht op de Managed Fleet-naamruimte, worden altijd verwijderd om zwevende machtigingen te voorkomen.
Als u Fleet Manager hebt geïmplementeerd met een voorbeeld van een hubcluster dat alleen is vereist voor dit artikel en u deze niet nodig hebt voor iets anders, schakelt u over naar de map van dat voorbeeld en vernietigt u het ook.
terraform plan -destroy -out main.destroy.tfplan
terraform apply main.destroy.tfplan
Waarschuwing
Met deze opdracht verwijdert u Fleet Manager, het hubcluster en de resourcegroep die is gemaakt door het vereiste voorbeeld, niet alleen de Fleet Manager. Controleer of de resourcegroep geen andere resources bevat die u wilt behouden en dat er nog geen andere beheerde fleet-naamruimten of lidclusters afhankelijk zijn van Fleet Manager voordat u deze opdracht uitvoert.
Volgende stappen
- Begrijp het concept van Managed Fleet-naamruimten door het overzicht te bekijken.
- Meer informatie over het weergeven en openen van Managed Fleet-naamruimten waar u toegang toe hebt.