Dela via


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 (kallas även en versionskanal) för din instans så att den tar emot uppdateringar tidigare eller senare än vad 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.

  • Uppdateringsgrupp – 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.

    Välj mellan:

    • Tidigt – Ta emot uppdateringar tidigt i distributionen, för testning och tidig åtkomst till nya funktioner. Det här alternativet rekommenderas inte för produktionsdistributioner.
    • Standard – Ta emot uppdateringar som en del av den vanliga versionsdistributionen. Det här alternativet rekommenderas för de flesta tjänster, inklusive produktionsdistributioner.
    • Sent – Ta emot uppdateringar senare än tidigare grupper, vanligtvis veckor efter den första distributionen. Det här alternativet rekommenderas endast för verksamhetskritiska distributioner.
    • AI Gateway Early (GenAI-lanseringskanal) – Få tidig åtkomst till de senaste AI-gatewayfunktionerna och uppdateringarna innan de når andra uppdateringsgrupper. Ta emot andra tjänstuppdateringar som en del av gruppen Sen distribution.

    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.

    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ållsperiod – 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 tar emot uppdateringar

Så här vet du 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.

  • Övervaka tjänstuppdateringar som äger rum i din API Management-instans med hjälp av Azure-aktivitetsloggen. 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.