Delen via

Een niet-VNet-geïnjecteerd API Management-exemplaar migreren naar het stv2-rekenplatform

  • Artikel

VAN TOEPASSING OP: Ontwikkelaar | Basic | Standaard | Premie

Dit artikel bevat stappen voor het migreren van een API Management-exemplaar dat wordt gehost op het stv1 rekenplatform in-place naar het stv2 platform wanneer het exemplaar niet wordt geïnjecteerd (geïmplementeerd) in een extern of intern VNet. Voor dit scenario migreert u uw exemplaar met behulp van Azure Portal of de Migrate naar stv2 REST API. Kijk of u dit moet doen.

Als u een door VNet geïnjecteerde API Management wilt migreren die op het stv1 platform wordt gehost, raadpleegt u Een VNet-geïnjecteerd API Management-exemplaar migreren naar het stv2-platform.

Belangrijk

Ondersteuning voor API Management-exemplaren die op het stv1 platform worden gehost, wordt buiten gebruik gesteld. In global Azure is de buitengebruikstellingsdatum 31 augustus 2024. In Azure Government en in Azure beheerd door 21Vianet (Azure in China), is de buitengebruikstellingsdatum 24 februari 2025. Als u exemplaren op het stv1 platform hebt gehost, migreert u deze vóór de buitengebruikstellingsdatum naar het stv2 platform om serviceonderbrekingen te voorkomen.

Let op

  • Het migreren van uw API Management-exemplaar naar een nieuwe infrastructuur is een langdurige bewerking.
  • Afhankelijk van uw migratieproces hebt u mogelijk tijdelijke downtime tijdens de migratie en moet u mogelijk uw netwerkafhankelijkheden bijwerken na de migratie om uw API Management-exemplaar te bereiken. Plan uw migratie dienovereenkomstig.
  • Migratie naar stv2 is niet omkeerbaar.

Wat gebeurt er tijdens de migratie?

Migratie van stv1 API Management-platform naar stv2 omvat het alleen bijwerken van de onderliggende rekenkracht en heeft geen invloed op de service-/API-configuratie die in de opslaglaag blijft bestaan. Voor een exemplaar dat niet is geïmplementeerd in een VNet:

  • U kunt kiezen of het VIP-adres van het exemplaar wordt gewijzigd of of het oorspronkelijke VIP-adres behouden blijft.
  • Het upgradeproces omvat het maken van een nieuwe berekening parallel aan de oude berekening.
  • De API Management-status in de portal wordt bijgewerkt.
  • Als u ervoor kiest om het VIP-adres te behouden, bevat de migratie een extra stap voor het verplaatsen van het VIP van de oude rekenkracht naar de nieuwe berekening waarbij de API's niet meer reageren.
  • Azure beheert de DNS van het beheereindpunt en werkt de nieuwe berekening onmiddellijk bij een geslaagde migratie bij.
  • De standaardgateway en de portal-DNS wijzen onmiddellijk naar de nieuwe berekening.
  • Als u ervoor kiest om uw API Management-exemplaar een nieuw VIP-adres te laten ontvangen, moet u netwerkafhankelijkheden bijwerken om het nieuwe VIP-adres te gebruiken.

Vereisten

Het exemplaar migreren naar het stv2-platform

Opties voor openbaar IP-adres

U kunt kiezen of het virtuele IP-adres van API Management wordt gewijzigd of of het oorspronkelijke VIP-adres behouden blijft.

  • Nieuw virtueel IP-adres : als u deze modus kiest, blijven API-aanvragen responsief tijdens de migratie. Infrastructuurconfiguratie (zoals aangepaste domeinen, locaties en CA-certificaten) wordt 30 minuten vergrendeld. Na de migratie moet u alle netwerkafhankelijkheden, waaronder DNS, firewallregels en VNets, bijwerken om het nieuwe VIP-adres te kunnen gebruiken.

  • IP-adres behouden: als u het VIP-adres behoudt, reageren API-aanvragen ongeveer 15 minuten niet terwijl het IP-adres wordt gemigreerd naar de nieuwe infrastructuur. Infrastructuurconfiguratie (zoals aangepaste domeinen, locaties en CA-certificaten) wordt 45 minuten vergrendeld. Er is geen verdere configuratie vereist na de migratie.

Vooraf gemaakt IP-adres voor migratie

Voor API Management-exemplaren die bereikbaar zijn via een openbaar IP-adres, maakt API Management een openbaar IP-adres voor het migratieproces vooraf. Zoek het vooraf gemaakte IP-adres in de JSON-uitvoer van de eigenschappen van uw API Management-exemplaar. Onder customPropertiesis het vooraf gemaakte IP-adres de waarde van de Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps eigenschap. Voor een implementatie met meerdere regio's is de waarde een door komma's gescheiden lijst met vooraf gemaakte IP-adressen.

Gebruik het vooraf gemaakte IP-adres (of de adressen) om u te helpen bij het beheren van het migratieproces:

  • Wanneer u het VIP-adres migreert en behoudt, wordt het vooraf gemaakte IP-adres tijdelijk toegewezen aan de nieuwe stv2 implementatie, voordat het oorspronkelijke IP-adres aan de stv2 implementatie wordt toegewezen. Als u bijvoorbeeld firewallregels hebt die de toegang tot het API Management-exemplaar beperken, kunt u het vooraf gemaakte IP-adres toevoegen aan de acceptatielijst om de continuïteit van clienttoegang tijdens de migratie te behouden. Nadat de migratie is voltooid, kunt u het vooraf gemaakte IP-adres verwijderen uit uw acceptatielijst.
  • Wanneer u een nieuw VIP-adres migreert en genereert, wordt het vooraf gemaakte IP-adres tijdens de migratie toegewezen aan de nieuwe stv2 implementatie en blijft het behouden nadat de migratie is voltooid. Gebruik het vooraf gemaakte IP-adres om uw netwerkafhankelijkheden, zoals DNS en firewallregels, bij te werken om naar het nieuwe IP-adres te verwijzen.

Migratiestappen

  1. Blader in Azure Portal naar uw API Management-exemplaar.

  2. Selecteer platformmigratie in het linkermenu onder Instellingen.

  3. Selecteer op de pagina Platformmigratie een van de twee migratieopties:

    • Nieuw virtueel IP-adres. Het VIP-adres van uw API Management-exemplaar wordt automatisch gewijzigd. Uw service heeft geen downtime, maar na de migratie moet u alle netwerkafhankelijkheden bijwerken, waaronder DNS, firewallregels en VNets om het nieuwe VIP-adres te kunnen gebruiken.

    • IP-adres behouden: het VIP-adres van uw API Management-exemplaar wordt niet gewijzigd. Uw exemplaar heeft maximaal 15 minuten downtime.

      Schermopname van api Management-platformmigratie in de portal.

  4. Bekijk de richtlijnen voor het migratieproces en bereid uw omgeving voor.

  5. Nadat u de voorbereidingsstappen hebt voltooid, selecteer ik heb de impact van het migratieproces gelezen en begrepen. Selecteer Migreren.

Migratie verifiëren

Als u wilt controleren of de migratie is geslaagd, controleert u de platformversie van uw API Management-exemplaar wanneer de status is gewijzigd in Online. Na een geslaagde migratie is stv2 de waarde of stv2.1.

Automatisch herstellen als de migratie mislukt

Als er een fout optreedt tijdens het migratieproces, wordt het exemplaar automatisch teruggezet naar het stv1 platform. Als de migratie is voltooid (de platformversie van het exemplaar wordt weergegeven als stv2 of stv2.1 de status als Online), kunt u niet terugdraaien naar het stv1 platform.

Neem contact op met ondersteuning voor Azure voor hulp als de migratie mislukt.

Als u de mogelijkheid nodig hebt om handmatig terug te draaien, is het raadzaam om een nieuw stv2 exemplaar naast uw oorspronkelijke API Management-exemplaar te implementeren.

Netwerkafhankelijkheden bijwerken

Nadat de migratie naar een nieuw VIP-adres is geslaagd, werkt u alle netwerkafhankelijkheden, waaronder DNS, firewallregels en VNets, bij om het nieuwe VIP-adres te gebruiken.

Help en ondersteuning

We zijn er om u te helpen bij het migreren naar het stv2 platform met minimale onderbrekingen naar uw services.

Als u vragen hebt, kunt u snel antwoorden krijgen van community-experts in Microsoft Q&A. Dien een ondersteuningsaanvraag in als u over een ondersteuningsplan beschikt en technische ondersteuning nodig hebt.

  1. Typ voor Samenvatting een beschrijving van uw probleem, bijvoorbeeld 'stv1 retirement'.
  2. Selecteer Technisch onder Type probleem.
  3. Selecteer onder Abonnement uw abonnement.
  4. Selecteer Onder Service de optie Mijn services en selecteer vervolgens API Management Service.
  5. Selecteer onder Resource de Azure-resource waarvoor u een ondersteuningsaanvraag maakt.
  6. Selecteer Beheer en beheer voor probleemtype.
  7. Voor subtype Probleem selecteert u Upgraden, Schalen of SKU-wijzigingen.

Veelgestelde vragen

  • Welke gegevens moeten we kiezen voor een migratiepad?

    • Wat is de netwerkmodus van het API Management-exemplaar?
    • Zijn aangepaste domeinen geconfigureerd?
    • Is er een firewall betrokken?
    • Zijn er bekende afhankelijkheden die door upstream/downstream worden genomen op de betrokken IP-adressen?
    • Is het een implementatie met meerdere regio's?
    • Kunnen we het bestaande exemplaar wijzigen of is een parallelle installatie vereist?
    • Kan er downtime zijn?
    • Kan de migratie worden uitgevoerd in niet-kantooruren?

  • Wat zijn de vereisten voor de migratie?

    Voor niet-VNet-geïnjecteerde instanties zijn geen vereisten vereist. Als u migreert met behoud van uw openbare IP-adres, reageert uw API Management-exemplaar ongeveer 15 minuten niet meer. Er is mogelijk geen downtime als u de optie Nieuw virtueel IP-adres kiest die API Management beschikbaar maakt op een nieuw IP-adres. Exemplaren die zijn geconfigureerd met een aangepast domein met behulp van een A-record en/of netwerkafhankelijkheden hebben op het openbare virtuele IP-adres, hebben een downtime wanneer een nieuw virtueel IP-adres wordt aangevraagd.

  • Veroorzaakt de migratie downtime?

    Voor niet-VNet-geïnjecteerde exemplaren is er slechts een downtime van ongeveer 15 minuten als u ervoor kiest om het oorspronkelijke IP-adres te behouden. Er is echter geen downtime als u migreert met een nieuw IP-adres en geen netwerkafhankelijkheden hebt op het nieuwe IP-adres. Netwerkafhankelijkheden omvatten aangepaste domeinnaam zonder een CNAME, IP-acceptatielijst, firewallregels en VNets.

  • Kunnen gegevens- of configuratieverlies optreden door/tijdens de migratie?

    stv1 voor stv2 migratie moet het rekenplatform alleen worden bijgewerkt en de interne opslaglaag niet wordt gewijzigd. Daarom is alle configuratie veilig tijdens het migratieproces. Dit omvat de door het systeem toegewezen beheerde identiteit, die, indien ingeschakeld, behouden blijft.

  • Hoe bevestigt u dat de migratie is voltooid en geslaagd?

    De migratie wordt beschouwd als voltooid en geslaagd wanneer de status op de overzichtspagina Online leest, samen met de platformversie als of stv2 stv2.1. Controleer ook of de netwerkstatus op de netwerkblade groen wordt weergegeven voor alle vereiste connectiviteit.

  • Kan ik de migratie uitvoeren met behulp van de portal?

    Ja, de blade Platformmigratie in Azure Portal begeleidt de migratie voor niet-VNet-geïnjecteerde exemplaren.

  • Kan ik het IP-adres van het exemplaar behouden?

    Ja, het IP-adres kan worden bewaard, maar er is een downtime van ongeveer 15 minuten.

  • Is er een migratiepad zonder het bestaande exemplaar te wijzigen?

    Ja, u hebt een side-by-side migratie nodig. Dit betekent dat u een nieuw API Management-exemplaar parallel met uw huidige exemplaar maakt en de configuratie naar het nieuwe exemplaar kopieert.

  • Wat gebeurt er als de migratie mislukt?

    Als uw API Management-exemplaar de platformversie stv2 niet als of stv2.1 status als Online weergeeft nadat u de migratie hebt gestart, is dit waarschijnlijk mislukt. Uw service wordt automatisch teruggedraaid naar het oude exemplaar en er worden geen wijzigingen aangebracht. Als u problemen ondervindt (bijvoorbeeld als de status langer dan 2 uur bijwerken is), neemt u contact op met ondersteuning voor Azure.

  • Welke functionaliteit is niet beschikbaar tijdens de migratie?

    Voor niet-VNet-geïnjecteerde exemplaren:

    • Als u ervoor hebt gekozen om het oorspronkelijke IP-adres te behouden: API-aanvragen reageren ongeveer 15 minuten niet terwijl het IP-adres naar de nieuwe infrastructuur wordt gemigreerd. Infrastructuurconfiguratie (zoals aangepaste domeinen, locaties en CA-certificaten) is 45 minuten vergrendeld.
    • Als u ervoor hebt gekozen om te migreren naar een nieuw IP-adres: API-aanvragen blijven responsief tijdens de migratie. Infrastructuurconfiguratie (zoals aangepaste domeinen, locaties en CA-certificaten) is 30 minuten vergrendeld. Na de migratie moet u alle netwerkafhankelijkheden, waaronder DNS, firewallregels en VNets, bijwerken om het nieuwe VIP-adres te kunnen gebruiken.

  • Hoe lang duurt de migratie?

    De verwachte duur voor de hele migratie is ongeveer 45 minuten. De indicator om te controleren of de migratie al is uitgevoerd, is om te controleren of de status van uw exemplaar weer online is en niet wordt bijgewerkt. Als er meer dan 2 uur wordt vermeld dat bijwerken is, neemt u contact op met ondersteuning voor Azure.

  • Kan ik de migratie indien nodig terugdraaien?

    Als er een fout optreedt tijdens het migratieproces, wordt het exemplaar automatisch teruggedraaid naar het stv1 platform. Nadat de service is gemigreerd, kunt u echter niet terugdraaien naar het stv1 platform.

  • Is er een wijziging vereist in aangepaste domeinen/privé-DNS-zones?

    Voor niet-VNet-geïnjecteerde instanties zijn geen wijzigingen vereist als het IP-adres behouden blijft. Als u voor een nieuw IP-adres hebt gekozen, moeten aangepaste domeinen die naar het IP-adres verwijzen, worden bijgewerkt.

  • Mijn stv1-exemplaar wordt geïmplementeerd in meerdere Azure-regio's (meerdere regio's). Hoe kan ik upgrade naar stv2?

    Voor een API Management dat niet in een VNet wordt geïnjecteerd, volgt u de migratiestappen met behulp van de portal of de Azure CLI. Alle regio's worden gemigreerd naar stv2.

  • Wat moeten we overwegen voor zelf-hostende gateways?

    U hoeft niets te doen in uw zelf-hostende gateways. U hoeft alleen API Management-exemplaren te migreren die worden uitgevoerd in Azure die worden beïnvloed door de buitengebruikstelling van het stv1 platform. Houd er rekening mee dat er mogelijk een nieuw IP-adres is voor het configuratie-eindpunt van het API Management-exemplaar en dat netwerkbeperkingen die zijn vastgemaakt aan het IP-adres moeten worden bijgewerkt.

  • Hoe wordt de ontwikkelaarsportal beïnvloed door migratie?

    Er is geen invloed op de ontwikkelaarsportal. Als aangepaste domeinen worden gebruikt, moet de DNS-record worden bijgewerkt met het effectieve IP-adres, na de migratie. Als de standaarddomeinen echter worden gebruikt, worden ze automatisch bijgewerkt bij een geslaagde migratie. Er is geen downtime voor de ontwikkelaarsportal tijdens de migratie.

  • Is er invloed op de kosten zodra we naar stv2 zijn gemigreerd?

    Het factureringsmodel blijft hetzelfde voor stv2 en er worden geen kosten meer gemaakt tijdens en na de migratie.

  • Welke RBAC-machtigingen zijn vereist voor de migratie van stv1 naar stv2?

    De gebruiker/het proces dat de migratie uitvoert, heeft schrijftoegang nodig tot het API Management-exemplaar.

Gerelateerde inhoud