Dela via

Migrera en icke-VNet-inmatad API Management-instans till stv2-beräkningsplattformen

  • Artikel

GÄLLER FÖR: Utvecklare | Grundläggande | Standard | Premie

Den här artikeln innehåller steg för att migrera en API Management-instans som finns på beräkningsplattformen stv1 stv2 på plats till plattformen när instansen inte matas in (distribueras) i ett externt eller internt virtuellt nätverk. I det här scenariot migrerar du din instans med hjälp av Azure Portal eller REST-API:et Migrera till stv2. Ta reda på om du behöver göra detta.

Om du behöver migrera en VNet-inmatad API Management som finns på stv1 plattformen kan du läsa Migrera en VNet-inmatad API Management-instans till stv2-plattformen.

Viktigt!

Stöd för API Management-instanser som finns på stv1 plattformen dras tillbaka. I globala Azure är slutdatumet den 31 augusti 2024. I Azure Government och i Azure som drivs av 21Vianet (Azure i Kina) är slutdatumet den 24 februari 2025. Om du har instanser som finns på stv1 plattformen migrerar du dem till stv2 plattformen före slutdatumet för att undvika avbrott i tjänsten.

Varning

  • Att migrera DIN API Management-instans till ny infrastruktur är en tidskrävande åtgärd.
  • Beroende på migreringsprocessen kan du ha tillfällig stilleståndstid under migreringen och du kan behöva uppdatera dina nätverksberoenden efter migreringen för att nå DIN API Management-instans. Planera migreringen i enlighet med detta.
  • Migrering till stv2 är inte reversibel.

Vad händer under migreringen?

Api Management-plattformsmigrering från stv1 till innebär att stv2 enbart den underliggande beräkningen uppdateras och påverkar inte den tjänst-/API-konfiguration som finns kvar i lagringslagret. För en instans som inte har distribuerats i ett virtuellt nätverk:

  • Du kan välja om VIP-adressen för instansen ska ändras eller om den ursprungliga VIP-adressen bevaras.
  • Uppgraderingsprocessen innebär att skapa en ny beräkning parallellt med den gamla beräkningen.
  • API Management-statusen i portalen uppdateras.
  • Om du väljer att bevara VIP-adressen innehåller migreringen ytterligare ett steg för att flytta VIP:en från den gamla beräkningen till den nya beräkning under vilken API:erna inte svarar.
  • Azure hanterar hanteringsslutpunktens DNS och uppdaterar till den nya beräkningen omedelbart vid lyckad migrering.
  • Standardgatewayen och portalens DNS pekar omedelbart på den nya beräkningen.
  • Om du väljer att låta DIN API Management-instans få en ny VIP-adress måste du uppdatera nätverksberoenden för att använda den nya VIP-adressen.

Förutsättningar

Migrera instansen till stv2-plattformen

Alternativ för offentlig IP-adress

Du kan välja om den virtuella IP-adressen för API Management ska ändras eller om den ursprungliga VIP-adressen bevaras.

  • Ny virtuell IP-adress – Om du väljer det här läget förblir API-begäranden dynamiska under migreringen. Infrastrukturkonfiguration (till exempel anpassade domäner, platser och CA-certifikat) låses i 30 minuter. Efter migreringen måste du uppdatera eventuella nätverksberoenden, inklusive DNS, brandväggsregler och virtuella nätverk för att använda den nya VIP-adressen.

  • Bevara IP-adress – Om du bevarar VIP-adressen svarar INTE API-begäranden i ungefär 15 minuter medan IP-adressen migreras till den nya infrastrukturen. Infrastrukturkonfiguration (till exempel anpassade domäner, platser och CA-certifikat) låses i 45 minuter. Ingen ytterligare konfiguration krävs efter migreringen.

Fördefinierad IP-adress för migrering

För API Management-instanser som kan nås av en offentlig IP-adress skapar API Management en offentlig IP-adress för migreringsprocessen. Hitta den förskapade IP-adressen i JSON-utdata för API Management-instansens egenskaper. Under customPropertiesär den förskapade IP-adressen värdet för Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps egenskapen. För en distribution i flera regioner är värdet en kommaavgränsad lista över förskapade IP-adresser.

Använd den förskapade IP-adressen (eller adresserna) för att hantera migreringsprocessen:

  • När du migrerar och bevarar VIP-adressen tilldelas den förskapade IP-adressen tillfälligt till den nya stv2 distributionen innan den ursprungliga IP-adressen tilldelas distributionen stv2 . Om du till exempel har brandväggsregler som begränsar åtkomsten till API Management-instansen kan du lägga till den förskapade IP-adressen i listan över tillåtna för att bevara kontinuiteten för klientåtkomst under migreringen. När migreringen är klar kan du ta bort den förskapade IP-adressen från listan över tillåtna adresser.
  • När du migrerar och genererar en ny VIP-adress tilldelas den förskapade IP-adressen till den nya stv2 distributionen under migreringen och bevaras när migreringen är klar. Använd den förskapade IP-adressen för att uppdatera dina nätverksberoenden, till exempel DNS och brandväggsregler, för att peka på den nya IP-adressen.

Migreringssteg

  1. I Azure Portal navigerar du till din API Management-instans.

  2. I den vänstra menyn går du till Inställningar och väljer Plattformsmigrering.

  3. På sidan Plattformsmigrering väljer du något av de två migreringsalternativen:

    • Ny virtuell IP-adress. VIP-adressen för din API Management-instans ändras automatiskt. Tjänsten har ingen stilleståndstid, men efter migreringen måste du uppdatera eventuella nätverksberoenden, inklusive DNS, brandväggsregler och virtuella nätverk för att använda den nya VIP-adressen.

    • Bevara IP-adress – VIP-adressen för din API Management-instans ändras inte. Din instans har stilleståndstid i upp till 15 minuter.

      Skärmbild av API Management-plattformsmigrering i portalen.

  4. Granska vägledningen för migreringsprocessen och förbered din miljö.

  5. När du har slutfört förberedelsestegen väljer du Jag har läst och förstår effekten av migreringsprocessen. Välj Migrera.

Verifiera migrering

Kontrollera att migreringen lyckades när statusen ändras till Online genom att kontrollera plattformsversionen av DIN API Management-instans. Efter lyckad migrering är stv2 värdet eller stv2.1.

Återställ automatiskt om migreringen misslyckas

Om det uppstår ett fel under migreringsprocessen återgår instansen automatiskt till stv1 plattformen. Om migreringen har slutförts (plattformsversionen av instansen visas som stv2 eller stv2.1 och statusen online) kan du inte återställa till stv1 plattformen.

Kontakta Azure Support om migreringen misslyckas.

Om du behöver funktionen för att återställa manuellt rekommenderar vi att du distribuerar en ny stv2 instans sida vid sida med din ursprungliga API Management-instans.

Uppdatera nätverksberoenden

Efter lyckad migrering till en ny VIP-adress uppdaterar du eventuella nätverksberoenden, inklusive DNS, brandväggsregler och virtuella nätverk för att använda den nya VIP-adressen.

Hjälp och support

Vi är här för att hjälpa dig att migrera till stv2 plattformen med minimala avbrott i dina tjänster.

Om du har frågor får du snabba svar från communityexperter i Microsoft Q&A. Om du har ett supportavtal och behöver teknisk hjälp kan du skapa en supportbegäran.

  1. För Sammanfattning skriver du en beskrivning av problemet, till exempel "stv1 retirement".
  2. Under Problemtyp väljer du Teknisk.
  3. Välj din prenumeration under Prenumeration.
  4. Under Tjänst väljer du Mina tjänster och sedan API Management Service.
  5. Under Resurs väljer du den Azure-resurs som du skapar en supportbegäran för.
  6. För Problemtyp väljer du Administration och hantering.
  7. För Problemundertyp väljer du Uppgradera, Skala eller SKU-ändringar.

Vanliga frågor och svar

  • Vilken information behöver vi för att välja en migreringsväg?

    • Vad är nätverksläget för API Management-instansen?
    • Är anpassade domäner konfigurerade?
    • Är en brandvägg inblandad?
    • Några kända beroenden som tas av uppströms/nedströms på de berörda IP-adresserna?
    • Är det en distribution i flera regioner?
    • Kan vi ändra den befintliga instansen eller krävs en parallell installation?
    • Kan det bli stilleståndstid?
    • Kan migreringen utföras i icke-arbetstid?

  • Vilka är förutsättningarna för migreringen?

    För icke-VNet-inmatade instanser krävs inga krav. Om du migrerar bevarandet av din offentliga IP-adress kommer API Management-instansen att svara i ungefär 15 minuter. Det kanske inte uppstår något avbrott om du väljer alternativet Ny virtuell IP-adress som gör API Management tillgängligt på en ny IP-adress. Instanser som konfigurerats med en anpassad domän med hjälp av en A-post och/eller som har nätverksberoenden på den offentliga virtuella IP-adressen får en stilleståndstid när en ny virtuell IP-adress begärs.

  • Kommer migreringen att orsaka stilleståndstid?

    För icke-VNet-inmatade instanser finns det en stilleståndstid på cirka 15 minuter bara om du väljer att behålla den ursprungliga IP-adressen. Det finns dock ingen stilleståndstid om du migrerar med en ny IP-adress och inte har några nätverksberoenden på den nya IP-adressen. Nätverksberoenden omfattar anpassat domännamn utan CNAME, LISTA över tillåtna IP-adresser, brandväggsregler och virtuella nätverk.

  • Kan data- eller konfigurationsförluster inträffa vid/under migreringen?

    stv1 till stv2 migrering innebär att du uppdaterar beräkningsplattformen ensam och att det interna lagringslagret inte ändras. Därför är all konfiguration säker under migreringsprocessen. Detta inkluderar den systemtilldelade hanterade identiteten, som om den är aktiverad bevaras.

  • Hur bekräftar jag att migreringen har slutförts och lyckats?

    Migreringen anses vara fullständig och lyckad när statusen på översiktssidan läser Online tillsammans med att plattformsversionen är antingen stv2 eller stv2.1. Kontrollera också att nätverksstatusen på nätverksbladet är grön för alla nödvändiga anslutningar.

  • Kan jag utföra migreringen med hjälp av portalen?

    Ja, bladet Plattformsmigrering i Azure Portal vägleder genom migreringen för icke-VNet-inmatade instanser.

  • Kan jag bevara IP-adressen för instansen?

    Ja, IP-adressen kan bevaras, men det blir en stilleståndstid på cirka 15 minuter.

  • Finns det en migreringssökväg utan att ändra den befintliga instansen?

    Ja, du behöver en migrering sida vid sida. Det innebär att du skapar en ny API Management-instans parallellt med din aktuella instans och kopierar konfigurationen till den nya instansen.

  • Vad händer om migreringen misslyckas?

    Om din API Management-instans inte visar plattformsversionen som stv2 eller stv2.1 och status som Online efter att du initierat migreringen misslyckades den förmodligen. Tjänsten återställs automatiskt till den gamla instansen och inga ändringar görs. Om du har problem (till exempel om statusen uppdateras i mer än 2 timmar) kontaktar du Azure Support.

  • Vilka funktioner är inte tillgängliga under migreringen?

    För icke-VNet-inmatade instanser:

    • Om du valde att bevara den ursprungliga IP-adressen: API-begäranden svarar inte i ungefär 15 minuter medan IP-adressen migreras till den nya infrastrukturen. Infrastrukturkonfiguration (till exempel anpassade domäner, platser och CA-certifikat) är låst i 45 minuter.
    • Om du har valt att migrera till en ny IP-adress: API-begäranden förblir dynamiska under migreringen. Infrastrukturkonfiguration (till exempel anpassade domäner, platser och CA-certifikat) är låst i 30 minuter. Efter migreringen måste du uppdatera eventuella nätverksberoenden, inklusive DNS, brandväggsregler och virtuella nätverk för att använda den nya VIP-adressen.

  • Hur lång tid tar migreringen?

    Den förväntade varaktigheten för hela migreringen är cirka 45 minuter. Indikatorn för att kontrollera om migreringen redan har utförts är att kontrollera om Status för din instans är tillbaka till Online och inte Uppdatera. Om det står Uppdatera i mer än 2 timmar kontaktar du Azure Support.

  • Kan jag återställa migreringen om det behövs?

    Om det uppstår ett fel under migreringsprocessen återställs instansen automatiskt till stv1 plattformen. Men när tjänsten har migrerats kan du inte återställa till stv1 plattformen.

  • Krävs det någon ändring i anpassade domäner/privata DNS-zoner?

    För icke-VNet-inmatade instanser krävs inga ändringar om IP-adressen bevaras. Om du väljer en ny IP-adress bör anpassade domäner som refererar till IP-adressen uppdateras.

  • Min stv1-instans distribueras till flera Azure-regioner (flera regioner). Hur gör jag för att uppgradera till stv2?

    För en API Management som inte matas in i ett virtuellt nätverk följer du migreringsstegen med hjälp av portalen eller Azure CLI. Alla regioner migreras till stv2.

  • Vad bör vi tänka på för gatewayer med egen värd?

    Du behöver inte göra något i dina lokala gatewayer. Du behöver bara migrera API Management-instanser som körs i Azure som påverkas av stv1 plattformens tillbakadragning. Observera att det kan finnas en ny IP-adress för konfigurationsslutpunkten för API Management-instansen och att eventuella nätverksbegränsningar som är fästa på IP-adressen bör uppdateras.

  • Hur påverkas utvecklarportalen av migreringen?

    Utvecklarportalen påverkas inte. Om anpassade domäner används bör DNS-posten uppdateras med den effektiva IP-adressen efter migreringen. Men om standarddomänerna används uppdateras de automatiskt vid lyckad migrering. Det finns ingen stilleståndstid för utvecklarportalen under migreringen.

  • Har kostnaden påverkats när vi migrerat till stv2?

    Faktureringsmodellen är densamma för stv2 och det kommer inte att uppstå några fler kostnader under och efter migreringen.

  • Vilka RBAC-behörigheter krävs för migreringen stv1 till stv2?

    Användaren/processen som utför migreringen behöver skrivåtkomst till API Management-instansen.

Relaterat innehåll