Konfigurera tjänstuppdateringsinställningar för dina API Management-instanser

GÄLLER FÖR: Basic | Standard | Premie

Den här artikeln visar hur du konfigurerar tjänstuppdateringsinställningar (förhandsversion) i DIN API Management-instans. Azure tillämpar regelbundet tjänstuppdateringar automatiskt på API Management-instanser med hjälp av en stegvis distributionsmetod. Dessa uppdateringar omfattar nya funktioner, säkerhetsförbättringar och tillförlitlighetsförbättringar.

Du kan inte styra exakt när Azure uppdaterar varje API Management-instans, men i utvalda tjänstnivåer kan du välja en uppdateringsgrupp för din instans så att den tar emot uppdateringar tidigare eller senare än den vanligtvis skulle göra under en uppdateringsdistribution. Du kan också konfigurera en underhållsperiod under dagen när du vill att instansen ska ta emot uppdateringar.

Uppdatera grupp

En uppdateringsgrupp (kallas även en versionskanal) är en uppsättning instanser som tar emot API Management-tjänstuppdateringar under en produktionsdistribution, vilket kan ta från flera dagar till flera veckor att slutföra.

Uppdatera grupp Description
AI Gateway Early (GenAI-lanseringskanal) Får tidig åtkomst till de senaste AI-gatewayfunktionerna och uppdateringarna innan de når andra uppdateringsgrupper.

Kombinerar de mest stabila uppdateringarna av mainline-tjänsten med de senaste AI-specifika funktionerna. Tar emot andra tjänstuppdateringar som en del av gruppen Sen uppdatering, vilket möjliggör snabbare distribution av AI-relaterade funktioner.
Tidig Tar emot uppdateringar tidigt i distributionen för testning och tidig åtkomst till nya funktioner. Det här alternativet rekommenderas inte för produktionsdistributioner.
Standardinställning Tar emot uppdateringar som en del av den regelbundna utgivningsprocessen. Det här alternativet rekommenderas för de flesta tjänster, inklusive produktionsdistributioner.
Sen Tar emot uppdateringar senare än de tidigare grupperna, vanligtvis veckor efter den första distributionen. Det här alternativet rekommenderas endast för verksamhetskritiska distributioner.

Anmärkning

  • Azure distribuerar alla uppdateringar med hjälp av ett SDP-ramverk (safe deployment practices). Uppdateringar som släpps tidigt i en distribution kan vara mindre stabila och ersättas senare av stabila versioner. Alla instanser uppdateras till slut till de mest stabila versionsutgåvorna.
  • Alla uppdateringsgrupper kan innehålla funktioner i förhandsversionen. Förhandsversionsfunktioner anges tydligt i Azure-portalen och dokumentationen.
  • Funktioner sprids via uppdateringsgrupper i den här sekvensen: AI Gateway Tidigt (endast AI-funktioner) → TidigStandardSent.

Du kanske till exempel vill lägga till en testinstans i gruppen Tidig uppdatering. Den här instansen tar emot uppdateringar före dina produktionsinstanser, som du placerar i gruppen Standard eller Sen uppdatering. Du kan övervaka testinstansen för eventuella problem som orsakas av uppdateringarna innan de når dina produktionsinstanser. Läs mer om kanariedistributioner med API Management

Underhållsfönster

En underhållsperiod är en 8-timmars daglig period när du vill att instansen ska ta emot uppdateringar. Som standard är underhållsfönstret 22:00 till 06:00 i instansens tidszon.

Tjänststörningar är sällsynta under en uppdatering, men du kanske vill minska risken genom att välja tider med låg användning av tjänsten. För produktionsinstanser kan du till exempel ange ett underhållsfönster under vardagskvällar och helgmorgnar.

Konfigurera inställningar för tjänstuppdatering

  1. Logga in på Azure-portalen och gå till din API Management-instans.
  2. I den vänstra menyn väljer du Uppdateringsinställningar för distribution + infrastrukturtjänst>.
  3. Under Uppdatera grupp granskar du den aktuella inställningen och väljer Redigera för att ändra den.
  4. Under Underhållsfönster granskar du de aktuella inställningarna och väljer Redigera för att ändra dem. För varje dag kan du välja standardfönstret, ett annat standardfönster eller ett anpassat fönster per dag.

Ta reda på när dina instanser får uppdateringar

Så här kan du lära dig mer om tjänstuppdateringar som förväntas eller pågår.

  • API Management-uppdateringar tillkännages på API Management GitHub-lagringsplatsen. Prenumerera på att ta emot meddelanden från den här lagringsplatsen för att veta när uppdateringsdistributioner börjar.

  • Använd Azure-aktivitetsloggen för att övervaka tjänstuppdateringar som äger rum i din API Management-instans. Händelsen "Schemalagt underhåll" genereras när en uppdatering påbörjas.

    Schemalagd underhållshändelse i aktivitetsloggen i portalen.

    Om du vill ta emot meddelanden automatiskt konfigurerar du en avisering i aktivitetsloggen.

  • Som standard distribueras uppdateringar till regioner i följande faser: Azure EUAP-regioner, följt av USA, västra centrala, följt av återstående regioner i flera senare faser. Sekvensen med regioner som uppdateras i de senare distributionsfaserna skiljer sig från tjänst till tjänst. Du kan förvänta dig minst 24 timmar mellan varje fas i produktionsdistributionen.

  • I en region får API Management-instanser på Premium-nivån uppdateringar flera timmar senare än de på andra tjänstnivåer.

Tips/Råd

Om din API Management-instans distribueras till flera platser (regioner) bestäms tidpunkten för uppdateringar av instansens primära plats.

Distributionsstrategier för kanariefågel

Du kan använda en API Management-instans som tilldelats till en specifik uppdateringsgrupp (om det alternativet är tillgängligt) eller distribueras i en specifik Azure-region som en kanariedistribution som tar emot uppdateringar tidigare än dina produktionsinstanser.

  • Lägg till instans i gruppen Tidig uppdatering – Använd en API Management-instans i gruppen Tidig uppdatering för att validera uppdateringar tidigt i en produktionsdistribution. Den här instansen är i praktiken din kanariedistribution.

  • Distribuera i kanarieregionen – Om du har åtkomst till en Azure EUAP-region använder du en instans där för att verifiera uppdateringar så snart de släpps till produktionspipelinen. Läs mer om processen för åtkomstbegäran i Azure-regionen.

    Anmärkning

    På grund av kapacitetsbegränsningar i EUAP-regioner kanske du inte kan skala API Management-instanser efter behov.

  • Distribuera i pilotregionen – Använd en instans i USA, västra centrala för att simulera din produktionsmiljö eller använda den i produktion för icke-kritisk API-trafik. Även om den här regionen tar emot uppdateringar efter EUAP-regionerna är det mer troligt att en distribution identifierar regressioner som är specifika för din tjänstkonfiguration.

  • Distribuera duplicerade instanser i en region – Om din produktionsarbetsbelastning är en Premium-nivåinstans i en viss region bör du överväga att distribuera en liknande konfigurerad instans på en lägre nivå som tar emot uppdateringar tidigare. Du kan till exempel konfigurera en förproduktionsinstans på utvecklarnivån för att verifiera uppdateringar.

  • Lär dig hur du övervakar din API Management-instans.
  • Läs mer om andra alternativ för att observera din API Management-instans.