Upgrades configureren voor leden van Azure Kubernetes Application Network (preview)

Belangrijk

AKS preview-functies zijn beschikbaar op selfservice, opt-in basis. Previews worden geleverd 'zoals het is' en 'voor zover beschikbaar' en zijn uitgesloten van de serviceovereenkomsten en beperkte garantie. AKS-previews worden gedeeltelijk gedekt door klantondersteuning naar best vermogen. Zodoende zijn deze functies niet bedoeld voor productiegebruik. Zie de volgende ondersteuningsartikelen voor meer informatie:

Azure Kubernetes Application Network biedt flexibele controle over hoe kleine versie-upgrades worden toegepast op leden. Elk lidcluster dat is ingeschreven in een Azure Kubernetes Application Network-resource kan een van de twee upgrademodi gebruiken, afhankelijk van het beheerniveau dat u nodig hebt: SelfManaged () of volledig beheerd (FullyManaged). Deze modi werken op lidniveau, zodat u kunt kiezen of upgrades handmatig of automatisch worden uitgevoerd voor elk cluster.

In dit artikel worden de verschillen tussen deze upgrademodi uitgelegd, hoe u deze configureert voor uw leden van azure Kubernetes Application Network en belangrijke overwegingen waarmee u rekening moet houden bij het beheren van upgrades.

Algemene overwegingen voor de upgrademodus

Houd rekening met de volgende beperkingen en overwegingen bij het configureren van upgrademodi voor leden van het Azure Kubernetes-toepassingsnetwerk:

  • Upgrademodi voor Azure Kubernetes Application Network zijn alleen van toepassing op secundaire versies van Azure Kubernetes Application Network-onderdelen. Ze hebben geen controle over of invloed op upgrades op clusterniveau, zoals Kubernetes-versies of updates van knooppuntafbeeldingen.
  • Patchupdates worden altijd automatisch toegepast, ongeacht de modus.
  • U selecteert de upgrademodus voor elk lid tijdens het joinproces. Zodra de modus is geselecteerd, blijft de modus van kracht voor dat lid totdat deze wordt verwijderd uit de Azure Kubernetes Application Network-resource. U kunt de upgrademodus voor een lid niet wijzigen zonder deze eerst te verwijderen en opnieuw aan de Azure Kubernetes Application Network-resource te koppelen.
  • Als u geen upgrademodus opgeeft tijdens liddeelname, wordt deze standaard ingesteld op SelfManaged.

Zelfbeheerde modus

In SelfManaged de modus geeft u de secundaire versie van Azure Kubernetes Application Network op om te installeren en te beheren wanneer er upgrades worden uitgevoerd. Deze modus is bedoeld voor scenario's waarin u het secundaire upgradeproces handmatig wilt beheren in plaats van te vertrouwen op geautomatiseerde updates. Indien --version in deze modus niet is opgegeven, wordt standaard de eerst beschikbare versie N-1 gebruikt. Deze modus is ook de standaardmodus als er tijdens liddeelname geen upgrademodus is opgegeven.

Overwegingen voor zelfbeheerde modus

Houd bij het gebruik van SelfManaged de modus rekening met de volgende overwegingen:

  • Upgrades zijn alleen toegestaan tussen opeenvolgende secundaire versies (bijvoorbeeld van secundaire versie N naar N+1). Versies overslaan (bijvoorbeeld upgraden van 1.1 naar 1.3) wordt niet ondersteund.
  • U kunt alleen terugdraaien naar de direct voorafgaande versie (N-1), mits deze eerder op hetzelfde cluster is geïnstalleerd. Terugdraaien naar een andere eerdere versie wordt niet ondersteund.
  • Meerdere opeenvolgende terugdraaiacties worden niet ondersteund. U kunt maximaal één versie terugdraaien.

Inschrijven in de zelfbeheerde modus en versie selecteren tijdens liddeelname

  • Registreer u voor SelfManaged modus en selecteer expliciet een versie tijdens lidmaatschapsdeelname met behulp van de opdracht met de az appnet member join--upgrade-mode SelfManaged parameter en de --version parameter die is ingesteld op de gewenste versie.

    az appnet member join \
        --resource-group $APPNET_RG \
        --appnet-name $APPNET_NAME \
        --member-name $APPNET_MEMBER_NAME \
        --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
        --upgrade-mode SelfManaged \
        --version $VERSION
    

Huidige versie controleren

  • Controleer welke versie momenteel op een lid is geïnstalleerd met behulp van de az appnet member show opdracht en raadpleeg de Version eigenschap in de uitvoer.

    az appnet member show --member-name $APPNET_MEMBER_NAME --appnet-name $APPNET_NAME --resource-group $APPNET_RG
    

Beschikbare upgradeversies controleren

  • Controleer welke versies beschikbaar zijn voor elke modus en Kubernetes-versie in uw regio met behulp van de az appnet list-versions opdracht waarbij de --location parameter is ingesteld op de interesseregio. Raadpleeg de kolom in de AvailableUpgrades uitvoer om te zien welke versies beschikbaar zijn.

    az appnet list-versions --location $LOCATION -o table
    

Een upgrade starten

  • Start een upgrade met behulp van de az appnet member update opdracht met de --version parameter die is ingesteld op de gewenste versie om naar te upgraden.

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
    

Terugdraaien naar een vorige versie

  • Terugdraaien naar een eerder geïnstalleerde versie met behulp van de az appnet member update opdracht waarbij de --version parameter is ingesteld op de gewenste versie om terug te keren naar. Houd er rekening mee dat alleen terugdraaien naar de direct voorafgaande versie (N-1) wordt ondersteund.

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
    

Volledig beheerde modus

In FullyManaged de modus beheert Azure Kubernetes Application Network automatisch versie-upgrades voor elk lid op basis van het geselecteerde releasekanaal. We raden deze modus aan als u liever azure Kubernetes Application Network gebruikt voor het afhandelen van de evaluatie van versiestabiliteit, timing van de implementatie en doorlopende updates zonder handmatige tussenkomst.

FullyManaged Wanneer u de upgrademodus gebruikt, kiest u een releasekanaal dat bepaalt hoe snel uw lidclusters nieuwe versies gebruiken. Azure Kubernetes Applicatie Netwerk bewaakt de gereedheid voor release en werkt leden bij volgens de stabiliteitscriteria van het kanaal.

De volgende releasekanalen zijn beschikbaar in de FullyManaged-modus.

  • Snel: levert de nieuwste versie van het toepassingsnetwerk zodra deze beschikbaar is. Dit kanaal is bedoeld voor niet-productie- of vroege validatieomgevingen waarbij het testen van nieuwe functies en functionaliteit prioriteit krijgt gedurende een langere validatietijd.
  • Stabiel: levert versies die extra validatie en testen hebben voltooid. Dit kanaal is bedoeld voor productieomgevingen en is doorgaans afgestemd op secundaire versies N-1, waardoor de betrouwbaarheid hoger is en eventuele problemen die in eerdere versies zijn geïdentificeerd, worden opgelost.

Wanneer FullyManaged de modus is geselecteerd, kunt u het releasekanaal opgeven voor stable of rapid. Als u dit weglaat, is stablehet standaardkanaal .

Belangrijk

In FullyManaged-modus past Azure Kubernetes Application Network automatisch upgrades toe wanneer nieuwe versies worden gereleased via releasekanalen. Handmatig beheer van de timing van de upgrade of versieselectie wordt niet ondersteund.

Beschikbare upgradeversies controleren voor volledig beheerde modus

  • Controleer met welk versie elke kanaal overeenkomt voor een bepaalde regio en Kubernetes-versie met behulp van de az appnet list-versions opdracht en grep de modus voor FullyManaged.

    az appnet list-versions --location $LOCATION -o table | grep FullyManaged
    

Inschrijven in volledig beheerde modus en releasekanaal selecteren tijdens liddeelname

  • Registreer u in de FullyManaged modus en selecteer een releasekanaal tijdens het aanmelden van leden met behulp van de az appnet member join opdracht en de --upgrade-mode FullyManaged parameter, en stel de --release-channel parameter in op het gewenste kanaal. In het volgende voorbeeld ziet u hoe u het Rapid kanaal selecteert tijdens liddeelname:

    az appnet member join \
        --resource-group $APPNET_RG \
        --appnet-name $APPNET_NAME \
        --member-name $APPNET_MEMBER_NAME \
        --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
        --upgrade-mode FullyManaged \
        --release-channel Rapid \
        --member-location $LOCATION
    

Releasekanaalselectie bijwerken

U kunt de geselecteerde release op elk gewenst moment bijwerken. Wijzigingen in het releasekanaal worden onmiddellijk van kracht.

  • Werk de selectie van het releasekanaal voor een bestaand lid bij met behulp van de az appnet member update opdracht met de --release-channel parameter die is ingesteld op het gewenste kanaal. In het volgende voorbeeld ziet u hoe u overschakelt naar het Stable kanaal voor een bestaand lid:

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --release-channel Stable
    

Zie de volgende artikelen voor meer informatie over Azure Kubernetes Application Network: