Automatiseer upgrades van Kubernetes en knooppuntafbeeldingen in meerdere clusters met Azure Kubernetes Fleet Manager.

Van toepassing op: ✔️ Fleet Manager ✔️ Fleet Manager met hubcluster

Het tijdig en veilig houden van clusters is een belangrijke zorg van platformbeheerders. Wanneer u overstapt op Azure Kubernetes Fleet Manager Update Runs and Strategies, kunt u profielen voor automatische upgrade gebruiken om de uitvoering van updateuitvoeringen te automatiseren wanneer nieuwe Versies van Kubernetes- of knooppuntinstallatiekopieën worden uitgebracht.

In dit artikel wordt uitgelegd hoe u profielen voor automatische upgrade gebruikt om updates automatisch te maken en uit te voeren wanneer Azure Kubernetes Service (AKS) nieuwe versies van Kubernetes of knooppuntinstallatiekopieën publiceert.

Notitie

Bij een automatische upgrade wordt een update uitgevoerd die de geplande onderhoudsvensters respecteert die u op het niveau van het AKS-cluster hebt ingesteld. Zie gepland onderhoud voor meerdere lidclusters voor meer informatie over hoe update-uitvoeringen lidclusters verwerken met geconfigureerde geplande onderhoudsvensters.

Voordat u begint

  • Lees het conceptuele overzicht van profielen voor automatische upgrade, waarin de configuraties worden uitgelegd waarnaar in deze handleiding wordt verwezen.
  • Een Fleet Manager instellen met een of meer lidclusters. Als u er nog geen hebt, volgt u de quickstart om een Fleet Manager te maken en AKS-clusters als leden toe te voegen.
  • Configureer een updatestrategie. Gebruik de instructies in het artikel over het uitvoeren van updates. U hebt de resource-id van de updatestrategie nodig voor gebruik met een profiel voor automatische upgrade wanneer u de Azure CLI gebruikt.

  • Stel de volgende omgevingsvariabelen in die moeten worden gebruikt in de Azure CLI-opdrachten:

    export GROUP=<resource-group>
export FLEET=<fleet-name>
export AUTOUPGRADEPROFILE=<upgrade-profile-name>
# Optional
export STRATEGYID=<strategy-id>
export CLUSTER=<aks-cluster-name>

  • Installeer de meest recente Azure CLI versie. Voor installatie of upgrade, zie Azure CLI installeren.

  • Installeer de nieuwste fleet Azure CLI-extensie. Gebruik de az extension add opdracht om de extensie te installeren.

    az extension add --name fleet

    Gebruik de az extension update opdracht om bij te werken naar de nieuwste versie van de extensie.

    az extension update --name fleet

Notitie

Clusters met agent pools die zijn gemaakt op basis van momentopnamen van knooppuntgroepen, worden als volgt beïnvloed op basis van het geselecteerde automatische upgradekanaal en de knooppuntimage-optie.

  • Node-imagekanaal: De node-image wordt bijgewerkt naar de versie die door Fleet Manager wordt bepaald. De verwijzing naar de momentopname (creationData) wordt verwijderd uit de agent pool.
  • Stabiele, Snelle of Kubernetes minder belangrijke versiekanalen met knooppuntbeeld ingesteld op:
    • Consistente image: De node-image wordt bijgewerkt naar de versie zoals bepaald door Fleet Manager. De verwijzing naar de momentopname (creationData) wordt verwijderd uit de agent pool.
    • Nieuwste installatiekopie: de agentpool behoudt de verwijzing naar de momentopname (creationData) en de knooppuntinstallatiekopie blijft ongewijzigd.

Zie voor meer informatie het begrijpen van upgrades en momentopnamen van knooppuntbeelden.

Profielen voor automatische upgrade maken

Maak profielen voor automatische upgrade met behulp van de az fleet autoupgradeprofile create opdracht.

U kunt een profiel voor automatische upgrade uitschakelen door de --disabled vlag met de az fleet autoupgradeprofile create opdracht te gebruiken. Als u een uitgeschakeld profiel voor automatische upgrade opnieuw wilt inschakelen, voert u de az fleet autoupgradeprofile create opdracht opnieuw uit zonder de --disabled vlag.

Notitie

Het uitschakelen van een auto-upgradeprofiel heeft geen invloed op update-uitvoeringen die al bezig zijn. Het proces stopt echter met het genereren van nieuwe updates totdat u het profiel opnieuw kunt activeren.

Kubernetes-updates voor stabiele kanalen

Update naar de meest recente ondersteunde Kubernetes-patchrelease op secundaire versie N-1, waarbij N de meest recente ondersteunde secundaire versie is.

Lidclusters één voor één bijwerken

Werk lidclusters opeenvolgend bij met behulp van de az fleet autoupgradeprofile create opdracht.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel Stable

Lidclusters bijwerken met behulp van een bestaande updatestrategie

Werk lidclusters bij met behulp van een bestaande updatestrategie. Gebruik de az fleet autoupgradeprofile create opdracht met de --update-strategy-id parameter die is ingesteld op de id van de bestaande updatestrategie.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel Stable

Lidclusters bijwerken met een bestaande updatestrategie met een consistente node-image

Werk lidclusters bij met behulp van een bestaande updatestrategie en zorg ervoor dat dezelfde versie van de knooppuntinstallatiekopie wordt gebruikt in elke Azure regio. Gebruik de az fleet autoupgradeprofile create opdracht met de --node-image-selection parameter ingesteld op Consistent. Alle lidclusters voeren dezelfde versie van de node-afbeelding uit.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel Stable \
  --node-image-selection Consistent

Lidclusters bijwerken met behulp van een bestaande updatestrategie met de meest recente knooppuntinstallatiekopie

Werk lidclusters bij met behulp van een bestaande updatestrategie en zorg ervoor dat de meest recente versie van de knooppuntinstallatiekopie wordt gebruikt voor elke Azure regio. Gebruik de az fleet autoupgradeprofile create opdracht met de --node-image-selection parameter ingesteld op Latest. Lidclusters kunnen meerdere versies van knooppuntinstallatiekopieën uitvoeren.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel Stable \
  --node-image-selection Latest

Updates van node-imagekanaal

Werk knooppunten bij met een nieuw gepatchte machine-image die beveiligingsupdates en bugfixes bevat.

Werk node-images één voor één bij

Werk node-installatiekopieën van lidclusters achtereenvolgens bij met behulp van de opdracht az fleet autoupgradeprofile create.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel NodeImage

Werk node-installatiekopieën bij met behulp van een bestaande updatestrategie

Werk knooppuntimages van lidclusters bij met behulp van een bestaande updatestrategie. Gebruik de az fleet autoupgradeprofile create opdracht en stel de --update-strategy-id parameter in op de id van de bestaande updatestrategie.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel NodeImage

Updates voor de beoogde Kubernetes-minorversie

Werk bij naar een gedefinieerde secundaire kubernetes-doelversie met behulp van de --target-kubernetes-version parameter. Geef de versie op in de {primaire versie}.{ secundaire versie} indeling (bijvoorbeeld 1.33). Fleet Manager Automatische upgrade voert automatisch een upgrade uit van lidclusters naar de nieuwste patchversie van de opgegeven doelversie wanneer de patch beschikbaar is.

Belangrijk

Houd rekening met de volgende informatie bij het gebruik van het secundaire versiekanaal van Target Kubernetes :

  • U moet de --target-kubernetes-version parameter opgeven. Deze parameter wordt niet ondersteund voor andere kanalen voor automatische upgrade (Rapid, Stable, Node image en Security patch).
  • De vlag --long-term-supportvoor langetermijnondersteuning (LTS) is alleen beschikbaar wanneer u het secundaire versiekanaal van Target Kubernetes gebruikt. Voor andere kanalen stelt u deze vlag in op False.
  • U kunt alleen LTS Kubernetes-versies (N-2) selecteren voor een profiel voor automatische upgrade met de --long-term-support vlag. Voor een automatische upgrade van Fleet om in dit scenario te blijven werken, moet u ervoor zorgen dat de clusters in de gegenereerde updateuitvoering allemaal zijn ingeschakeld met LTS. Niet-LTS-clusters zorgen ervoor dat de updatebewerking mislukt wanneer het eerste niet-LTS-cluster wordt aangetroffen.
  • U kunt de Kubernetes-doelversie niet instellen op een toekomstige Kubernetes-versie die niet door AKS is uitgebracht.

Lidclusters bijwerken naar een specifieke secundaire Kubernetes-versie

Werk lidclusters bij naar een specifieke secundaire kubernetes-versie met behulp van de az fleet autoupgradeprofile create opdracht waarbij de --target-kubernetes-version parameter is ingesteld op de gewenste versie. In het volgende voorbeeld worden lidclusters bijgewerkt naar Kubernetes versie 1.33.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel TargetKubernetesVersion \
  --target-kubernetes-version "1.33"

Lidclusters bijwerken met LTS ingeschakeld voor een specifieke secundaire Kubernetes-versie

Werk memberclusters met LTS ingeschakeld bij naar een specifieke secundaire versie van Kubernetes met behulp van de opdracht az fleet autoupgradeprofile create, waarbij de parameter --target-kubernetes-version is ingesteld op de gewenste versie en de --long-term-support-vlag is ingeschakeld. In het volgende voorbeeld worden lidclusters bijgewerkt naar Kubernetes versie 1.29 waarvoor LTS is ingeschakeld.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel TargetKubernetesVersion \
  --target-kubernetes-version "1.29" \
  --long-term-support

Updates voor het kanaal voor beveiligingspatches

Werk Linux-knooppunten bij met beveiligingsoplossingen. Pas waar mogelijk updates toe met behulp van live patching. Anders implementeert u een pas gepatchte machine-image die beveiligingscorrecties bevat.

Knooppunten bijwerken met beveiligingspatches één voor één

Werk node-installatiekopieën van lidclusters achtereenvolgens bij met behulp van de opdracht az fleet autoupgradeprofile create.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel SecurityPatch

Knooppunten bijwerken met beveiligingspatches met behulp van een bestaande updatestrategie

Werk knooppuntimages van lidclusters bij met behulp van een bestaande updatestrategie. Gebruik de az fleet autoupgradeprofile create opdracht en stel de --update-strategy-id parameter in op de id van de bestaande updatestrategie.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel SecurityPatch

Profielen voor automatische upgrade weergeven

Profielen voor automatische upgrade zijn resources op Fleet-niveau. Ze worden niet rechtstreeks gekoppeld aan afzonderlijke AKS-clusters. Als u wilt bepalen welke profielen uw AKS-clusters kunnen bijwerken, moet u eerst de Fleet-leden vermelden en controleren of de clusters lid zijn van de Vloot.

az fleet member list \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --query "[].{memberName:name,clusterResourceId:clusterResourceId}" \
  --output table

Vermeld alle profielen voor automatische upgrade voor de Vloot met behulp van de az fleet autoupgradeprofile list opdracht.

az fleet autoupgradeprofile list \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --output table

Geef een specifiek profiel voor automatische upgrade voor de Vloot weer met behulp van de az fleet autoupgradeprofile show opdracht. Controleer het kanaal, de status en updateStrategyId in de uitvoer.

az fleet autoupgradeprofile show \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE

Als updateStrategyId leeg is, gebruikt het profiel de updatesequentie Een voor een en neemt het de lidclusters van de Fleet achtereenvolgens op. Als updateStrategyId een resource-id bevat, toon dan de strategie waarnaar wordt verwezen om de fasen, groepen of selectoren voor leden te bekijken die bepalen welke Fleet-leden in de gegenereerde update-runs worden opgenomen.

PROFILE_STRATEGY_ID=$(az fleet autoupgradeprofile show \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --query updateStrategyId \
  --output tsv)

if [[ -n "$PROFILE_STRATEGY_ID" ]]; then
  az fleet updatestrategy show \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name "${PROFILE_STRATEGY_ID##*/}"
fi

Een profiel voor automatische upgrade verwijderen

Gebruik de az fleet autoupgradeprofile delete opdracht om een bestaand profiel voor automatische upgrade te verwijderen. Nadat u deze opdracht hebt uitgevoerd, wordt u gevraagd om het verwijderen te bevestigen. Om de bevestiging te omzeilen en het profiel direct te verwijderen, neemt u --yes op in de opdracht.

az fleet autoupgradeprofile delete \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE

Notitie

Het verwijderen van een profiel voor automatische upgrade heeft geen invloed op lopende updateprocessen.

Profielen voor automatische upgrade maken

Update naar de meest recente ondersteunde Kubernetes-patchrelease op secundaire versie N-1, waarbij N de meest recente ondersteunde secundaire versie is.

  1. Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.

  2. Selecteer in het servicemenu onder InstellingenMulticluster-update>Automatische upgradeprofielen> en klik op + Maken.

  3. Configureer bij Het maken van een profiel voor automatische upgrade de volgende opties:

    • Onder Details van automatische upgrade:
      • Profielnaam voor automatische upgrade: voer een naam in voor het profiel voor automatische upgrade.
      • Status: Selecteer Ingeschakeld of Uitgeschakeld. Uitgeschakelde profielen voor automatische upgrade worden niet geactiveerd wanneer nieuwe versies worden uitgebracht.
      • Updatevolgorde: fasen oféén voor één selecteren.
    • Onder Triggers voor automatische upgrade:
      • Kanaal: Selecteer Stabiel.
      • Knooppuntinstallatiekopieën: Selecteer de meest recente installatiekopieën of consistente installatiekopieën.
    • Onder Strategiedetails:
      • Als u een updatereeks hebt geselecteerd met behulp van fasen, selecteert u een bestaande strategie of maakt u een nieuwe.

  4. Selecteer Maken om het profiel voor automatische upgrade te maken.

    Schermopname van het deelvenster Azure Kubernetes Fleet Manager Azure Portal voor het maken van een profiel voor automatische upgrade met behulp van het stabiele kanaal.

Profielen voor automatische upgrade weergeven

Profielen voor automatische upgrades zijn bronnen op Fleet-niveau. Ze worden niet rechtstreeks gekoppeld aan afzonderlijke AKS-clusters. Als u wilt bepalen welke profielen uw AKS-clusters kunnen bijwerken, controleert u of de clusters lid zijn van de Vloot en controleert u vervolgens de profielen van de Vloot en de bijbehorende updatereeksen.

  1. Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.
  2. Selecteer Fleet-leden in het servicemenu en bevestig dat uw AKS-clusters worden weergegeven in de ledenlijst.
  3. Selecteer onder Instellingen deoptie Profielen voor automatisch upgraden voor meerdere clusters>.
  4. Selecteer een profiel voor automatische upgrade om het kanaal, de status en de updatevolgorde weer te geven.
  5. Als de updatevolgorde één voor één is, bevat het profiel de lidclusters van de Fleet opeenvolgend. Als de updatereeks fasen gebruikt, controleert u de fasen, groepen en ledenkiezers van de bijbehorende strategie om te bepalen welke Fleet-leden de gegenereerde updateuitvoeringen bevatten.

Een profiel voor automatische upgrade verwijderen

  1. Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.
  2. Selecteer in het servicemenu onder InstellingenMulticluster update> en Profielen voor automatische upgrade.
  3. Selecteer het profiel dat u wilt verwijderen en selecteer> VervolgensJa verwijderen om te bevestigen.

Notitie

Het verwijderen van een profiel voor automatische upgrade heeft geen invloed op lopende updateprocessen.

Automatische upgrades valideren

Automatische upgrades worden alleen uitgevoerd wanneer er nieuwe Kubernetes- of knooppuntinstallatiekopieën beschikbaar zijn. Wanneer automatische upgrade wordt geactiveerd, wordt er een gekoppelde updateuitvoering gemaakt, zodat u de updateuitvoering kunt beheren om de resultaten van de automatische upgrade te bekijken.

U kunt uw bestaande versies ook controleren als referentiepunt.

Haal de huidige Kubernetes-versie voor een lidcluster op met behulp van de az aks show opdracht met de --query parameter om de uitvoer voor de currentKubernetesVersion eigenschap te filteren.

az aks show \
  --resource-group $GROUP \
  --name $CLUSTER \
  --query currentKubernetesVersion

Haal de huidige versie van de node-installatiekopie van een lidcluster op met de opdracht az aks show en de parameter --query om de uitvoer te filteren op de eigenschap nodeImageVersion.

az aks show \
  --resource-group $GROUP \
  --name $CLUSTER \
  --query "agentPoolProfiles[].{name:name,mode:mode, nodeImageVersion:nodeImageVersion, osSku:osSku, osType:osType}"

Wanneer de update is voltooid, kunt u deze opdrachten opnieuw uitvoeren en de bijgewerkte versies bekijken die zijn geïmplementeerd.

Een update run genereren vanuit een automatisch upgradeprofiel

Nadat u een profiel voor automatische upgrade hebt gemaakt, kan het enige tijd duren voordat een nieuwe Kubernetes- of knooppunt-imageversie automatische upgrade activeert om een update uit te voeren. Met automatische upgrade kunt u op elk gewenst moment een nieuwe updateuitvoering genereren met behulp van de az fleet autoupgradeprofile generate-update-run opdracht. De resulterende updateuitvoering is gebaseerd op de huidige versie van de door AKS gepubliceerde Kubernetes- of knooppuntinstallatiekopieën.

Zie Een update-uitvoering genereren vanuit een profiel voor automatische upgrade voor meer informatie over het maken van een updateuitvoering op aanvraag vanuit een profiel voor automatische upgrades.

Verwante inhoud

  • Last updated on