Migratie naar App Service Environment v3 met behulp van de functie voor side-by-side-migratie

Notitie

De migratiefunctie die in dit artikel wordt beschreven, wordt gebruikt voor automatische migratie van App Service Environment v2 naar App Service Environment v3 naast elkaar (ander subnet). Als u geen respijtperiode van 30 dagen hebt aangevraagd, bekijkt u het respijtperiodeoverzicht en vraagt u vervolgens een respijtperiode aan door naar Azure Portal te gaan en naar de blade Migratie voor elk van uw App Service-omgevingen te gaan.

Als u op zoek bent naar informatie over de in-place migratiefunctie, raadpleegt u Migreren naar App Service Environment v3 met behulp van de in-place migratiefunctie. Als u op zoek bent naar informatie over opties voor handmatige migratie, raadpleegt u Opties voor handmatige migratie. Zie de beslissingsstructuur van het migratiepad voor hulp bij het bepalen welke migratieoptie geschikt is voor u. Zie het overzicht van App Service Environment v3 voor meer informatie over App Service Environment v3.

Naast elkaar treedt er extra uitdagingen op in vergelijking met in-place migratie. Voor klanten die tussen de twee opties moeten beslissen, is de aanbeveling om in-place migratie te gebruiken, omdat er minder stappen en minder complexiteit zijn. Als u besluit om naast elkaar migratie te gebruiken, bekijkt u de veelvoorkomende bronnen van problemen bij het migreren met behulp van de sectie met de functie voor side-by-side-migratie om veelvoorkomende valkuilen te voorkomen.

App Service kan de migratie van uw App Service Environment v1 en v2 naar een App Service Environment v3 automatiseren. Er zijn verschillende migratieopties. Bekijk de beslissingsstructuur van het migratiepad om te bepalen welke optie het beste is voor uw use-case. App Service Environment v3 biedt voordelen en functieverschillen ten opzichte van eerdere versies. Controleer de ondersteunde functies van App Service Environment v3 voordat u migreert om het risico op een onverwacht toepassingsprobleem te verminderen.

Met de functie voor side-by-side-migratie wordt uw migratie naar App Service Environment v3 geautomatiseerd. Met de functie voor side-by-side-migratie maakt u een nieuwe App Service Environment v3 met al uw apps in een ander subnet. Uw bestaande App Service-omgeving wordt pas verwijderd nadat u de verwijdering hebt gestart aan het einde van het migratieproces. Deze migratieoptie is het beste voor klanten die willen migreren naar App Service Environment v3 zonder downtime en ondersteuning kunnen bieden voor het gebruik van een ander subnet voor hun nieuwe omgeving. Als u hetzelfde subnet moet gebruiken en ongeveer één uur downtime van toepassingen wilt ondersteunen, raadpleegt u de in-place migratiefunctie. Zie de opties voor handmatige migratie waarmee u in uw eigen tempo kunt migreren.

Belangrijk

Als u niet alle stappen uitvoert die in deze zelfstudie worden beschreven, ondervindt u downtime. Als u bijvoorbeeld niet alle afhankelijke resources bijwerkt met de nieuwe IP-adressen of u geen toegang tot/van uw nieuwe subnet toestaat, zoals het geval voor de sleutelkluis voor het aangepaste domeinachtervoegsel, ervaart u downtime totdat dat is opgelost.

Het is raadzaam deze functie eerst te gebruiken voor ontwikkelomgevingen voordat u productieomgevingen migreert om het proces te oefenen en ervoor te zorgen dat er geen onverwachte problemen zijn. Geef feedback met betrekking tot dit artikel of de functie met behulp van de knoppen onder aan de pagina.

Ondersteunde scenario's

Op dit moment biedt de migratiefunctie naast elkaar geen ondersteuning voor migraties naar App Service Environment v3 in de volgende regio's:

Azure openbaar

• UAE - centraal

Azure Government

• US DoD Central
• US DoD East
• US Gov - Arizona
• US Gov - Texas
• VS (overheid) - Virginia

Microsoft Azure beheerd door 21Vianet

• China - oost 2
• China - noord 2

De volgende App Service Environment-configuraties kunnen worden gemigreerd met behulp van de functie voor side-by-side-migratie. De tabel bevat de Configuratie van App Service Environment v3 wanneer u de migratiefunctie naast elkaar gebruikt op basis van uw bestaande App Service Environment.

Configuratie	App Service Environment v3-configuratie
Interne load balancer (ILB) App Service Environment v2	ILB App Service Environment v3
Extern (ELB/internet gericht met openbaar IP) App Service Environment v2	ELB App Service Environment v3
ILB App Service Environment v2 met een aangepast domeinachtervoegsel	ILB App Service Environment v3 met een aangepast domeinachtervoegsel

App Service Environment v3 kan worden geïmplementeerd als zone-redundant. Zoneredundantie kan worden ingeschakeld zolang uw App Service Environment v3 zich in een regio bevindt die zoneredundantie ondersteunt.

Als u wilt dat uw nieuwe App Service Environment v3 een aangepast domeinachtervoegsel gebruikt en u er momenteel geen gebruikt, kan het achtervoegsel voor aangepaste domeinen op elk gewenst moment worden geconfigureerd zodra de migratie is voltooid. Zie Het achtervoegsel voor aangepaste domeinen configureren voor App Service Environment voor meer informatie. Als uw bestaande omgeving een aangepast domeinachtervoegsel heeft en u deze niet meer wilt gebruiken, moet u een aangepast domeinachtervoegsel configureren voor de migratie. U kunt het achtervoegsel van het aangepaste domein verwijderen nadat de migratie is voltooid.

Beperkingen voor naast elkaars migratiefuncties

Hier volgen beperkingen bij het gebruik van de functie voor side-by-side-migratie:

• Uw nieuwe App Service Environment v3 bevindt zich in een ander subnet, maar hetzelfde virtuele netwerk als uw bestaande omgeving.
• U kunt de regio waarin uw App Service Environment zich bevindt, niet wijzigen.
• ELB App Service Environment kan niet worden gemigreerd naar ILB App Service Environment v3 en omgekeerd.
• Als uw bestaande App Service Environment gebruikmaakt van een aangepast domeinachtervoegsel, moet u tijdens het migratieproces het aangepast domeinachtervoegsel configureren voor uw App Service Environment v3.
  • Als u geen aangepast domeinachtervoegsel meer wilt gebruiken, kunt u dit verwijderen zodra de migratie is voltooid.
• De functie voor side-by-side-migratie is alleen beschikbaar met behulp van de CLI of via REST API. De functie is niet beschikbaar in Azure Portal.

App Service Environment v3 biedt geen ondersteuning voor de volgende functies die u mogelijk gebruikt met uw huidige App Service Environment v2.

• Een TLS/SSL-binding op basis van IP configureren met uw apps.
• App Service Environment v3 valt niet terug op Azure DNS als uw geconfigureerde aangepaste DNS-servers in het virtuele netwerk een bepaalde naam niet kunnen omzetten. Als dit gedrag is vereist, moet u ervoor zorgen dat u een doorstuurserver naar een openbare DNS hebt of Azure DNS opneemt in de lijst met aangepaste DNS-servers.

De migratiefunctie naast elkaar biedt geen ondersteuning voor de volgende scenario's. Zie de opties voor handmatige migratie als uw App Service-omgeving in een van deze categorieën valt.

• App Service Environment v1
  • U kunt de versie van uw App Service-omgeving vinden door naar uw App Service-omgeving te navigeren in Azure Portal en configuratie te selecteren onder Instellingen aan de linkerkant. U kunt Ook Azure Resource Explorer gebruiken en de waarde van de kind eigenschap voor uw App Service-omgeving controleren.
  • Als u een App Service Environment v1 hebt, kunt u migreren met behulp van de in-place migratiefunctie of een van de opties voor handmatige migratie.
• ELB App Service Environment v2 met IP SSL-adressen
• Zone vastgemaakte App Service Environment v2
• App Service Environment met een naam die niet voldoet aan de tekenlimieten. De volledige naam, inclusief het domeinachtervoegsel, moet 64 tekens of minder zijn. Bijvoorbeeld: my-ase-name.appserviceenvironment.net voor ILB en my-ase-name.p.azurewebsites.net voor ELB moet 64 tekens of minder zijn. Als u niet aan de tekenlimiet voldoet, moet u handmatig migreren. De tekenlimieten voor de naam van de App Service-omgeving zijn als volgt:
  • ILB App Service Environment-naamlimiet: 36 tekens
  • Naamlimiet voor ELB App Service Environment-naam: 42 tekens

Het App Service-platform beoordeelt uw App Service-omgeving om de ondersteuning voor migratie naast elkaar te bevestigen. Als uw scenario niet alle validatiecontroles doorgeeft, kunt u op dit moment niet migreren met behulp van de functie voor side-by-side-migratie. Als uw omgeving een beschadigde of onderbroken status heeft, kunt u pas migreren als u de benodigde updates hebt uitgevoerd.

Notitie

App Service Environment v3 biedt geen ondersteuning voor IP SSL. Als u IP SSL gebruikt, moet u alle IP SSL-bindingen verwijderen voordat u migreert naar App Service Environment v3. De migratiefunctie ondersteunt uw omgeving zodra alle IP SSL-bindingen zijn verwijderd.

Probleemoplossing

Als uw App Service Environment de validatiecontroles niet doorgeeft of als u een migratiestap in de onjuiste volgorde probeert uit te voeren, ziet u een van de volgende foutberichten:

Foutmelding	Beschrijving	Aanbeveling
Migreren kan alleen worden aangeroepen op een ASE in ARM VNET en deze ASE bevindt zich in het klassieke VNET.	App Service-omgevingen in klassieke virtuele netwerken kunnen niet worden gemigreerd met behulp van de functie voor side-by-side migratie.	Migreren met behulp van een van de handmatige migratieopties.
ASEv3-migratie is nog niet gereed.	De onderliggende infrastructuur is niet gereed om App Service Environment v3 te ondersteunen.	Migreer met behulp van een van de handmatige migratieopties als u onmiddellijk wilt migreren. Wacht anders totdat de migratiefunctie naast elkaar beschikbaar is in uw regio.
Kan zoneredundantie voor deze ASE niet inschakelen.	De regio waarin de App Service Environment zich bevindt, biedt geen ondersteuning voor zoneredundantie.	Als u zoneredundantie wilt inschakelen, gebruikt u een van de handmatige migratieopties om te migreren naar een regio die zoneredundantie ondersteunt.
Migreren kan momenteel niet worden aangeroepen voor dit aangepaste DNS-achtervoegsel ASE.	Migratie van aangepast domeinachtervoegsel wordt geblokkeerd.	Open een ondersteuningsaanvraag om ondersteuning te vragen om uw probleem op te lossen.
Zoneredundante ASE-migratie kan momenteel niet worden aangeroepen.	Zone-redundante Migratie van App Service Environment wordt geblokkeerd.	Open een ondersteuningsaanvraag om ondersteuning te vragen om uw probleem op te lossen.
Migreren kan niet worden aangeroepen op ASEv2 dat is vastgemaakt aan de zone.	App Service Environment v2 die is vastgemaakt, kan momenteel niet worden gemigreerd met behulp van de functie voor side-by-side-migratie.	Migreer met behulp van een van de handmatige migratieopties als u onmiddellijk wilt migreren.
Bestaande revert-migratiebewerking wordt uitgevoerd. Probeer het later opnieuw.	Een vorige migratiepoging wordt teruggedraaid.	Wacht totdat het terugdraaien is voltooid voordat u de migratie opnieuw probeert te starten.
Properties.VirtualNetwork.Id moet de resource-id van het subnet bevatten.	De fout wordt weergegeven als u probeert te migreren zonder een nieuw subnet op te geven voor de plaatsing van uw App Service Environment v3.	Zorg ervoor dat u de richtlijnen volgt en voltooi de stap om het subnet te identificeren dat u gaat gebruiken voor uw App Service Environment v3.
Kan niet overstappen <requested phase> van de huidige fase <previous phase> van migratie zonder downtime.	Deze fout wordt weergegeven als u een migratiestap probeert uit te voeren in de onjuiste volgorde.	Zorg ervoor dat u de migratiestappen op volgorde volgt.
Kan de terugdraaibewerking voor ASE niet in hybride staat starten. Probeer het later opnieuw.	Deze fout wordt weergegeven als u de migratie probeert terug te keren, maar er is iets misgegaan. Deze fout heeft geen invloed op uw oude of nieuwe omgeving.	Open een ondersteuningsaanvraag om ondersteuning te vragen om uw probleem op te lossen.
Deze ASE kan niet zonder downtime worden gemigreerd.	Deze fout wordt weergegeven als u de migratiefunctie naast elkaar probeert te gebruiken in een App Service Environment v1.	De migratiefunctie naast elkaar biedt geen ondersteuning voor App Service Environment v1. Migreren met behulp van de in-place migratiefunctie of een van de handmatige migratieopties.
Migreren is niet beschikbaar voor dit abonnement.	Ondersteuning moet worden ingeschakeld voor het migreren van deze App Service-omgeving.	Open een ondersteuningsaanvraag om ondersteuning te vragen om uw probleem op te lossen.
Zone-redundante migratie kan niet worden aangeroepen omdat de IP-adressen die tijdens de pre-migratie zijn gemaakt, geen zoneredundant zijn.	Deze fout wordt weergegeven als u een zone-redundante migratie probeert uit te voeren, maar de IP-adressen die tijdens de stap van de IP-generatie zijn gegenereerd, zijn niet gemaakt als zoneredundant. Het platform probeert alle IP-adressen zoneredundant te maken om back-endtolerantie te garanderen.	Open een ondersteuningsaanvraag om ondersteuning in te schakelen als u zoneredundantie wilt inschakelen. De technici keren de migratie terug en maken een andere poging om de IP-adressen te maken. Anders kunt u migreren zonder zoneredundantie in te schakelen.
Migreren kan niet worden aangeroepen als IP SSL is ingeschakeld op een van de sites.	App Service-omgevingen waarvoor sites met IP SSL zijn ingeschakeld, kunnen niet worden gemigreerd met behulp van de functie voor side-by-side-migratie.	Verwijder het IP SSL uit al uw apps in de App Service Environment om de migratiefunctie in te schakelen.
Kan niet binnen hetzelfde subnet migreren.	De fout wordt weergegeven als u hetzelfde subnet opgeeft waarin uw huidige omgeving zich bevindt voor de plaatsing van uw App Service Environment v3.	U moet een ander subnet opgeven voor uw App Service Environment v3. Als u hetzelfde subnet wilt gebruiken, migreert u met behulp van de in-place migratiefunctie.
Het abonnement heeft te veel App Service-omgevingen. Verwijder een aantal voordat u meer probeert te maken.	Aan het quotum voor de App Service Environment voor uw abonnement wordt voldaan.	Verwijder overbodige omgevingen of neem contact op met de ondersteuning om uw opties te controleren.
Migreren kan niet worden aangeroepen op deze ASE totdat de actieve upgrade is voltooid.	App Service-omgevingen kunnen niet worden gemigreerd tijdens platformupgrades. U kunt uw upgradevoorkeur instellen vanuit de Azure-portal. Upgrades duren 8-12 uur of langer, afhankelijk van de grootte (aantal exemplaren/kernen) van de App Service Environment.	Wacht totdat de upgrade is voltooid en migreer vervolgens.
De beheerbewerking van App Service Environment wordt uitgevoerd.	Uw App Service-omgeving ondergaat een beheerbewerking. Deze bewerkingen kunnen activiteiten omvatten, zoals implementaties of upgrades. Migratie wordt geblokkeerd totdat deze bewerkingen zijn voltooid.	U kunt migreren zodra deze bewerkingen zijn voltooid.
Uw InteralLoadBalancingMode wordt momenteel niet ondersteund.	App Service-omgevingen waarvoor InternalLoadBalancingMode is ingesteld op bepaalde waarden, kunnen momenteel niet worden gemigreerd met behulp van de migratiefunctie. Het Microsoft-team moet de InternalLoadBalancingMode handmatig wijzigen.	Open een ondersteuningsaanvraag om ondersteuning te vragen om uw probleem op te lossen. Vraag een update aan voor de InternalLoadBalancingMode.
Volledige migratie kan niet worden aangeroepen voordat IP-adressen worden gegenereerd.	Deze fout wordt weergegeven als u probeert te migreren voordat u de premigratiestappen voltooit.	Zorg ervoor dat u alle premigratiestappen voltooit voordat u migreert. Zie de stapsgewijze handleiding voor migratie.
Volledige migratie kan niet worden aangeroepen op Ase met aangepaste dns-achtervoegselset, maar zonder dat een aangepaste AseV3-configuratie voor dns-achtervoegsel is geconfigureerd.	Uw bestaande App Service Environment maakt gebruik van een aangepast domeinachtervoegsel. U moet tijdens het migratieproces aangepast domeinachtervoegsel configureren voor uw App Service Environment v3.	Configureer een aangepast domeinachtervoegsel. Als u geen aangepast domeinachtervoegsel meer wilt gebruiken, kunt u dit verwijderen zodra de migratie is voltooid.

Overzicht van het migratieproces met behulp van de functie voor side-by-side-migratie

Een side-by-side migratie bestaat uit een reeks stappen die in volgorde moeten worden gevolgd. Belangrijke punten worden gegeven voor een subset van de stappen. Het is belangrijk om te begrijpen wat er gebeurt tijdens deze stappen en hoe uw omgeving en apps worden beïnvloed. Nadat u de volgende informatie hebt bekeken en wanneer u klaar bent om te migreren, volgt u de stapsgewijze handleiding.

Controleer of migratie wordt ondersteund met behulp van de functie voor migratie naast elkaar voor uw App Service-omgeving

Het platform valideert dat uw App Service-omgeving kan worden gemigreerd met behulp van de functie voor side-by-side-migratie. Als uw App Service Environment niet alle validatiecontroles doorgeeft, kunt u op dit moment niet migreren met behulp van de functie voor side-by-side-migratie. Zie de sectie probleemoplossing voor meer informatie over de mogelijke oorzaken van validatiefouten. Als uw omgeving een beschadigde of onderbroken status heeft, kunt u pas migreren als u de benodigde updates hebt uitgevoerd. Als u niet kunt migreren met behulp van de functie voor gelijktijdige migratie, raadpleegt u de opties voor handmatige migratie.

De validatie controleert ook of uw App Service-omgeving de minimale build heeft die vereist is voor migratie. Deze build kan nieuwer zijn dan de standaard-build die wordt geïmplementeerd met de routine-upgrade-/onderhoudscyclus van het platform. De minimale build wordt periodiek bijgewerkt om ervoor te zorgen dat de meest recente bugfixes en verbeteringen beschikbaar zijn. Als uw App Service-omgeving zich niet in de minimale build bevindt, moet u de upgrade zelf starten. Deze upgrade is een standaardproces waarbij uw App Service-omgeving niet wordt beïnvloed, maar u kunt niet schalen of wijzigingen aanbrengen in uw App Service-omgeving terwijl de upgrade wordt uitgevoerd. U kunt pas migreren als de upgrade is voltooid. Het kan 8-12 uur duren voordat upgrades zijn voltooid of langer, afhankelijk van de grootte van uw omgeving. Als u een specifiek tijdvenster voor uw migratie plant, moet u de validatiecontrole 24-48 uur vóór de geplande migratietijd uitvoeren om ervoor te zorgen dat u tijd hebt voor een upgrade als dat nodig is.

Het subnet selecteren en voorbereiden voor uw nieuwe App Service Environment v3

Het platform maakt uw nieuwe App Service Environment v3 in een ander subnet dan uw bestaande App Service Environment. U moet een subnet selecteren dat voldoet aan de volgende vereisten:

• Het subnet moet zich in hetzelfde virtuele netwerk bevinden en daarom de regio, als uw bestaande App Service-omgeving.
  • Als uw virtuele netwerk geen beschikbaar subnet heeft, moet u er een maken. Mogelijk moet u de adresruimte van uw virtuele netwerk vergroten om een nieuw subnet te maken. Zie Een virtueel netwerk maken voor meer informatie.
• Het subnet moet in beide richtingen kunnen communiceren met het subnet waarin uw bestaande App Service-omgeving zich bevindt. Zorg ervoor dat er geen netwerkbeveiligingsgroepen of andere netwerkconfiguraties zijn die communicatie tussen de subnetten verhinderen.
• Het subnet moet één delegatie van Microsoft.Web/hostingEnvironments.
• Het subnet moet voldoende beschikbare IP-adressen hebben om uw nieuwe App Service Environment v3 te ondersteunen. Het aantal benodigde IP-adressen is afhankelijk van het aantal exemplaren dat u wilt gebruiken voor uw nieuwe App Service Environment v3. Zie App Service Environment V3-netwerken voor meer informatie.
• Op het subnet mogen geen vergrendelingen worden toegepast. Als er vergrendelingen zijn, moeten ze vóór de migratie worden verwijderd. De vergrendelingen kunnen indien nodig worden gelezen zodra de migratie is voltooid. Zie Uw resources vergrendelen om uw infrastructuur te beveiligen voor meer informatie over vergrendelingen en overname van vergrendelingen.
• Er mag geen Azure-beleid zijn dat migratie of gerelateerde acties blokkeert. Als er beleidsregels zijn die het maken van App Service-omgevingen of de wijziging van subnetten blokkeren, moeten ze vóór de migratie worden verwijderd. Het beleid kan zo nodig worden gelezen zodra de migratie is voltooid. Zie het overzicht van Azure Policy voor meer informatie over Azure Policy.

Uitgaande IP-adressen genereren voor uw nieuwe App Service Environment v3

Het platform maakt de nieuwe uitgaande IP-adressen. Hoewel deze IP-adressen worden gemaakt, wordt de activiteit met uw bestaande App Service Environment niet onderbroken. U kunt echter niet schalen of wijzigingen aanbrengen in uw bestaande omgeving. Dit proces duurt ongeveer 15 minuten.

Wanneer dit is voltooid, worden de nieuwe uitgaande IP-adressen gemaakt die in uw toekomstige App Service Environment v3 worden gebruikt. Deze nieuwe IP-adressen hebben geen invloed op uw bestaande omgeving.

U ontvangt het nieuwe binnenkomende IP-adres zodra de migratie is voltooid, maar voordat u de DNS-wijziging aanbrengt om klantverkeer om te leiden naar uw nieuwe App Service Environment v3. U krijgt het binnenkomende IP-adres op dit punt in het proces niet omdat er afhankelijkheden zijn van App Service Environment v3-resources die tijdens de migratiestap worden gemaakt. U kunt alle resources bijwerken die afhankelijk zijn van het nieuwe binnenkomende IP-adres voordat u verkeer omleidt naar uw nieuwe App Service Environment v3.

Afhankelijke resources bijwerken met nieuwe uitgaande IP-adressen

De nieuwe uitgaande IP-adressen worden gemaakt en aan u gegeven voordat u de daadwerkelijke migratie start. De nieuwe standaardinstelling voor uitgaand verkeer naar openbare internetadressen wordt gegeven, zodat u eventuele externe firewalls, DNS-routering, netwerkbeveiligingsgroepen en andere resources kunt aanpassen die afhankelijk zijn van deze IP-adressen voordat u de migratie voltooit. Het is uw verantwoordelijkheid om alle resources bij te werken die worden beïnvloed door de wijziging van het IP-adres die is gekoppeld aan de nieuwe App Service Environment v3. Ga niet verder met de volgende stap totdat u alle vereiste updates hebt doorgevoerd. Mogelijk ondervindt u downtime tijdens en na de migratiestap als u afhankelijk bent van de uitgaande IP-adressen en niet alle benodigde updates uitvoert. Dit komt doordat wanneer de migratie is gestart, hoewel verkeer nog steeds naar de front-ends van Uw App Service Environment v2 gaat, uw onderliggende rekenproces uw nieuwe App Service Environment v3 in het nieuwe subnet is.

Deze stap is ook een goed moment om de binnenkomende en uitgaande netwerkafhankelijkheidswijzigingen te controleren bij het overstappen naar App Service Environment v3, inclusief de poortwijziging voor de statustest van Azure Load Balancer, die nu gebruikmaakt van poort 80.

Uw App Service Environment-subnet delegeren

App Service Environment v3 vereist dat het subnet waarin het zich bevindt één delegering heeft Microsoft.Web/hostingEnvironments. Migratie kan niet slagen als het subnet van de App Service-omgeving niet is gedelegeerd of als u het delegeert aan een andere resource. Zorg ervoor dat het subnet dat u selecteert voor uw nieuwe App Service Environment v3 één delegering heeft.Microsoft.Web/hostingEnvironments

Wijzigingen in exemplaargrootte bevestigen

Uw App Service-plannen worden gemaakt met de bijbehorende geïsoleerde v2-SKU als onderdeel van de migratie. I2-abonnementen komen bijvoorbeeld overeen met I2v2. Uw apps zijn mogelijk te ruim ingericht na de migratie, omdat de geïsoleerde v2-laag meer geheugen en CPU per bijbehorende instantiegrootte heeft. U hebt de mogelijkheid om uw omgeving zo nodig te schalen zodra de migratie is voltooid. Raadpleeg de SKU-details voor meer informatie.

Zorg ervoor dat uw resources niet zijn vergrendeld

Virtuele netwerk vergrendelt platformbewerkingen tijdens de migratie. Als uw virtuele netwerk vergrendelingen heeft, moet u deze verwijderen voordat u migreert. De vergrendelingen kunnen indien nodig worden gelezen zodra de migratie is voltooid. Vergrendelingen kunnen bestaan op drie verschillende bereiken: abonnement, resourcegroep en resource. Wanneer u een vergrendeling toepast op een bovenliggend bereik, nemen alle resources binnen dat bereik dezelfde vergrendeling over. Als u vergrendelingen hebt toegepast op het abonnement, de resourcegroep of het resourcebereik, moeten deze vóór de migratie worden verwijderd. Zie Uw resources vergrendelen om uw infrastructuur te beveiligen voor meer informatie over vergrendelingen en overname van vergrendelingen.

Zorg ervoor dat migratie niet wordt geblokkeerd door Azure-beleid

Azure Policy kan worden gebruikt om het maken en wijzigen van resources in bepaalde principals te weigeren. Als u een beleid hebt dat het maken van App Service-omgevingen of de wijziging van subnetten blokkeert, moet u dit verwijderen voordat u migreert. Het beleid kan indien nodig worden gelezen zodra de migratie is voltooid. Zie het overzicht van Azure Policy voor meer informatie over Azure Policy.

Een aangepast domeinachtervoegsel toevoegen (optioneel)

Als uw bestaande App Service Environment gebruikmaakt van een aangepast domeinachtervoegsel, moet u een aangepast domeinachtervoegsel configureren voor uw nieuwe App Service Environment v3. Aangepast domeinachtervoegsel in App Service Environment v3 wordt anders geïmplementeerd dan in App Service Environment v2. U moet de aangepaste domeinnaam, beheerde identiteit en het certificaat opgeven die moeten worden opgeslagen in Azure Key Vault. Zie Aangepast domeinachtervoegsel configureren voor App Service Environment v3 voor meer informatie over het achtervoegsel van aangepaste domeinen, inclusief vereisten, stapsgewijze instructies en aanbevolen procedures voor het configureren van het achtervoegsel voor aangepaste domeinen voor App Service Environment. Als uw App Service Environment v2 een aangepast domeinachtervoegsel heeft, moet u een aangepast domeinachtervoegsel configureren voor uw nieuwe omgeving, zelfs als u deze niet meer wilt gebruiken. Zodra de migratie is voltooid, kunt u indien nodig de configuratie van het aangepaste domeinachtervoegsel verwijderen.

Als uw migratie een aangepast domeinachtervoegsel bevat, wordt voor App Service Environment v3 het aangepaste domein niet weergegeven in de sectie Essentials van de overzichtspagina van de portal, zoals voor App Service Environment v1/v2. Ga in plaats daarvan voor App Service Environment v3 naar de pagina aangepast domeinachtervoegsel waar u kunt bevestigen dat het achtervoegsel van uw aangepaste domein correct is geconfigureerd. Als u in App Service Environment v2 een aangepast domeinachtervoegsel hebt, bevat de standaardhostnaam ook het achtervoegsel van uw aangepaste domein en heeft deze de vorm APP-NAME.internal.contoso.com. In App Service Environment v3 gebruikt de standaardhostnaam altijd het standaarddomeinachtervoegsel en bevindt zich in de vorm APP-NAME.ASE-NAME.appserviceenvironment.net. Dit verschil komt doordat App Service Environment v3 het standaarddomeinachtervoegsel behoudt wanneer u een aangepast domeinachtervoegsel toevoegt. Met App Service Environment v2 is er slechts één domeinachtervoegsel.

Migreren naar App Service Environment v3

Nadat u de vorige stappen hebt voltooid, moet u zo snel mogelijk doorgaan met de migratie.

Er is geen downtime van toepassingen tijdens de migratie, maar net als in de stap voor het genereren van IP-adressen kunt u uw bestaande App Service Environment niet schalen, wijzigen of apps erop implementeren tijdens dit proces.

Belangrijk

Omdat schalen tijdens de migratie wordt geblokkeerd, moet u uw omgeving schalen naar de gewenste grootte voordat u de migratie start. Als automatisch schalen is ingeschakeld en er een schaalgebeurtenis plaatsvindt voordat de migratie wordt gestart, moet u wachten totdat de schaalgebeurtenis is voltooid voordat de migratie wordt gestart. Schakel automatisch schalen uit voordat u de migratie start om dit probleem te voorkomen. Als u de schaal van uw omgeving na de migratie wilt aanpassen, kunt u dit doen zodra de migratie is voltooid.

In deze stap besluit u ook of u zoneredundantie wilt inschakelen voor uw nieuwe App Service Environment v3. Zoneredundantie kan worden ingeschakeld zolang uw App Service Environment v3 zich in een regio bevindt die zoneredundantie ondersteunt.

Voor side-by-side-migratie is een servicevenster van drie tot zes uur vereist voor App Service Environment v2-naar-v3-migraties. Tijdens de migratie worden schaal- en omgevingsconfiguraties geblokkeerd en worden de volgende gebeurtenissen uitgevoerd:

• De nieuwe App Service Environment v3 wordt gemaakt in het subnet dat u hebt geselecteerd.
• Uw nieuwe App Service-plannen worden gemaakt in de nieuwe App Service Environment v3 met de bijbehorende geïsoleerde v2-laag.
• Uw apps worden gemaakt in de nieuwe App Service Environment v3.
• De onderliggende rekenkracht/werkrollen voor uw apps worden verplaatst naar de nieuwe App Service Environment v3, wat betekent dat uw apps nu worden uitgevoerd in uw App Service Environment v3. Uw Front-ends van App Service Environment v2 worden echter standaard nog steeds uitgevoerd en leveren verkeer. Uw oude binnenkomende IP-adres blijft in gebruik, maar uw nieuwe uitgaande IP-adressen worden gebruikt. Daarnaast worden uw nieuwe Front-ends voor App Service Environment v3 gemaakt en klaar om verkeer te verwerken.
  • Voor ILB App Service Environments worden de front-ends van Uw App Service Environment v3 pas gebruikt wanneer u uw privé-DNS-zones bijwerkt met het nieuwe binnenkomende IP-adres.
  • Voor ELB App Service-omgevingen leidt het migratieproces geen verkeer om naar de front-ends van App Service Environment v3 totdat u de laatste stap van de migratie hebt voltooid.

Wanneer deze stap is voltooid, gaat uw toepassingsverkeer nog steeds naar de oude front-ends van App Service Environment v2 en het binnenkomende IP-adres dat eraan is toegewezen. Uw apps worden echter daadwerkelijk uitgevoerd op werkrollen in uw nieuwe App Service Environment v3.

Notitie

Vanwege een bekende fout worden webtaken mogelijk niet gestart tijdens de hybride implementatiestap. Als u webtaken gebruikt, kan deze fout app-problemen/downtime veroorzaken. Open een ondersteuningsaanvraag als u vragen of opmerkingen hebt over dit probleem.

Het binnenkomende IP-adres voor uw nieuwe App Service Environment v3 ophalen en afhankelijke resources bijwerken

Het nieuwe binnenkomende IP-adres wordt opgegeven, zodat u nieuwe eindpunten kunt instellen met services zoals Traffic Manager of Azure Front Door en een van uw privé-DNS-zones kunt bijwerken. Ga pas verder met de volgende stap als u deze wijzigingen aanbrengt. Er is downtime als u afhankelijke resources niet bijwerkt met het nieuwe binnenkomende IP-adres. Het is uw verantwoordelijkheid om alle resources bij te werken die worden beïnvloed door de wijziging van het IP-adres die is gekoppeld aan de nieuwe App Service Environment v3. Ga niet verder met de volgende stap totdat u alle vereiste updates hebt doorgevoerd.

Klantverkeer omleiden, uw App Service Environment v3 valideren en de migratie voltooien

De laatste stap is het omleiden van verkeer naar de nieuwe front-ends van App Service Environment v3 en het voltooien van de migratie. Voordat u deze stap uitvoert, moet u de nieuwe App Service Environment v3 controleren en de benodigde tests uitvoeren om te controleren of deze werkt zoals bedoeld. Standaard gaat verkeer naar de front-ends van uw App Service Environment v2. Als u een ILB App Service Environment v3 gebruikt, kunt u de front-ends van uw App Service Environment v3 testen door uw privé-DNS-zone bij te werken met het nieuwe binnenkomende IP-adres. Als u een ELB App Service Environment v3 gebruikt, is het proces voor testen afhankelijk van uw specifieke netwerkconfiguratie. Een eenvoudige methode om te testen voor ELB-omgevingen is het bijwerken van uw hosts-bestand om uw nieuwe binnenkomende IP-adres van App Service Environment v3 te gebruiken. Als u aangepaste domeinen hebt toegewezen aan uw afzonderlijke apps, kunt u hun DNS ook bijwerken zodat deze verwijst naar het nieuwe binnenkomende IP-adres. Door deze wijziging te testen, kunt u uw App Service Environment v3 volledig valideren voordat u de laatste stap van de migratie start waar uw oude App Service-omgeving wordt verwijderd.

Zodra u klaar bent om verkeer om te leiden, kunt u de laatste stap van de migratie voltooien. Met deze stap worden interne/platform-DNS-records bijgewerkt om te verwijzen naar het IP-adres van de load balancer van uw nieuwe App Service Environment v3 en de front-ends die tijdens de migratie zijn gemaakt. Wijzigingen worden binnen een paar minuten doorgevoerd. Het is uw verantwoordelijkheid om uw DNS-records bij te werken zodat deze verwijzen naar het nieuwe binnenkomende IP-adres. Als u problemen ondervindt of uitvaltijd van toepassingen ondervindt, controleert u de cache- en TTL-instellingen. Met deze stap wordt ook uw oude App Service-omgeving afgesloten en verwijderd. Uw nieuwe App Service Environment v3 is nu uw productieomgeving.

Belangrijk

Het platform garandeert een migratie-ervaring zonder downtime. Uw DNS-instellingen kunnen echter downtime veroorzaken tijdens de DNS-wijzigingsstap. Dit kan worden veroorzaakt door problemen met betrekking tot TTL- en cache-instellingen, omdat verkeer mogelijk nog steeds wordt omgeleid naar uw oude App Service Environment na de DNS-wijziging. Controleer uw DNS-instellingen en zorg ervoor dat u een lage TTL hebt en dat uw DNS-provider ondersteuning biedt voor snelle doorgifte. Als u een hoge TTL hebt, ondervindt u mogelijk downtime tijdens de DNS-wijzigingsstap.

Notitie

Het is belangrijk om deze stap zo snel mogelijk te voltooien. Wanneer uw App Service Environment de hybride status heeft, kan deze geen platformupgrades en beveiligingspatches ontvangen, waardoor deze kwetsbaarder wordt voor instabiliteit en beveiligingsrisico's.

U hebt 14 dagen de tijd om deze stap te voltooien. Na 14 dagen wordt de migratie automatisch voltooid en wordt uw oude omgeving verwijderd. Als u meer tijd nodig hebt, kunt u een ondersteuningsaanvraag openen om uw opties te bespreken.

Als u problemen met uw nieuwe App Service Environment v3 ontdekt, voert u de opdracht niet uit om klantverkeer om te leiden. Met deze opdracht wordt ook het verwijderen van uw App Service Environment v2 gestart. Als u een probleem vindt, neemt u contact op met de ondersteuning.

De functie voor side-by-side-migratie gebruiken

Vereisten

Zorg ervoor dat u begrijpt hoe migratie naar App Service Environment v3 van invloed is op uw toepassingen. Bekijk het migratieproces in zijn geheel om inzicht te krijgen in de tijdlijn van het proces en waar en wanneer u betrokken moet raken. Bekijk ook de veelgestelde vragen, die enkele van uw vragen kunnen beantwoorden.

Zorg ervoor dat uw virtuele netwerk, resourcegroepen, resources of abonnement niet zijn vergrendeld. Blokkeer platformbewerkingen tijdens de migratie.

Zorg ervoor dat er geen Azure-beleid acties blokkeert die vereist zijn voor de migratie, inclusief subnetwijzigingen en Azure-app Service-resourcecreaties. Beleidsregels die resourcewijzigingen en -creaties blokkeren, kunnen ertoe leiden dat de migratie vastloopt of mislukt.

Omdat uw App Service Environment v3 zich in een ander subnet in uw virtuele netwerk bevindt, moet u ervoor zorgen dat u een beschikbaar subnet in uw virtuele netwerk hebt dat voldoet aan de subnetvereisten voor App Service Environment v3. Het subnet dat u selecteert, moet ook kunnen communiceren met het subnet waarin uw bestaande App Service Environment zich bevindt. Zorg ervoor dat er niets is dat de communicatie tussen de twee subnetten blokkeert. Als u geen beschikbaar subnet hebt, moet u er een maken voordat u migreert. Het maken van een nieuw subnet kan betrekking hebben op het vergroten van de adresruimte van uw virtuele netwerk. Zie Een virtueel netwerk en subnet maken voor meer informatie.

Omdat schalen tijdens de migratie wordt geblokkeerd, moet u uw omgeving schalen naar de gewenste grootte voordat u de migratie start. Als u de schaal van uw omgeving na de migratie wilt aanpassen, kunt u dit doen zodra de migratie is voltooid. Als automatisch schalen is ingeschakeld en er een schaalgebeurtenis plaatsvindt voordat de migratie wordt gestart, wordt de migratie geblokkeerd totdat de schaalgebeurtenis is voltooid. Schakel automatisch schalen uit voordat u de migratie start om dit probleem te voorkomen.

Volg de stappen die hier worden beschreven in volgorde en zoals geschreven, omdat u Azure REST API-aanroepen maakt. U wordt aangeraden de Azure CLI te gebruiken om deze API-aanroepen uit te voeren. Zie azure REST API-naslaginformatie voor meer informatie over andere methoden.

Voor deze handleiding installeert u de Azure CLI of gebruikt u Azure Cloud Shell en gebruikt u een Bash-shell.

Notitie

U wordt aangeraden een Bash-shell te gebruiken om de opdrachten uit te voeren die in deze handleiding worden gegeven. De opdrachten zijn mogelijk niet compatibel met PowerShell-conventies en escapetekens.

Belangrijk

Tijdens de migratie kan azure Portal onjuiste informatie over uw App Service Environment en uw apps weergeven. Ga niet naar de migratie-ervaring in De Azure-portal, omdat de functie voor side-by-side-migratie daar niet beschikbaar is. U wordt aangeraden de Azure CLI te gebruiken om de status van uw migratie te controleren. Als u vragen hebt over de status van uw migratie of uw apps, neemt u contact op met de ondersteuning.

1. Selecteer het subnet voor uw nieuwe App Service Environment v3

Selecteer een subnet in uw App Service Environment v3 dat voldoet aan de subnetvereisten voor App Service Environment v3. Noteer de naam van het subnet dat u selecteert. Dit subnet moet afwijken van het subnet waarin uw bestaande App Service-omgeving zich bevindt.

2. Haal uw App Service Environment-id op

Voer de volgende opdrachten uit om uw App Service Environment-id op te halen en op te slaan als een omgevingsvariabele. Vervang de tijdelijke aanduidingen voor de naam en resourcegroepen door uw waarden voor de App Service-omgeving die u wilt migreren. ASE_RG en VNET_RG hetzelfde zijn als uw virtuele netwerk en App Service Environment zich in dezelfde resourcegroep bevinden.

ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-ASE-Resource-Group>
VNET_RG=<Your-VNet-Resource-Group>
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)

3. Valideren dat migratie wordt ondersteund

Met de volgende opdracht wordt gecontroleerd of uw App Service-omgeving wordt ondersteund voor migratie. Met deze opdracht wordt ook gevalideerd of uw App Service-omgeving de ondersteunde buildversie voor migratie heeft. Als uw App Service Environment zich niet in de ondersteunde buildversie bevindt, moet u de upgrade zelf starten. Zie Valideren dat migratie wordt ondersteund met behulp van de functie voor migratie naast elkaar voor uw App Service-omgeving voor meer informatie over de premigratie-upgrade.

az rest --method post --uri "${ASE_ID}/NoDowntimeMigrate?phase=Validation&api-version=2022-03-01"

Als er geen fouten zijn, wordt uw migratie ondersteund en kunt u doorgaan met de volgende stap.

Als u een upgrade moet starten om uw App Service Environment te upgraden naar de ondersteunde buildversie, die 8-12 uur of langer kan duren, afhankelijk van de grootte van uw omgeving, voert u de volgende opdracht uit. Voer deze opdracht alleen uit als u de validatiestap mislukt en u wordt geïnstrueerd om uw App Service-omgeving te upgraden.

az rest --method post --uri "${ASE_ID}/NoDowntimeMigrate?phase=PreMigrationUpgrade&api-version=2022-03-01"

4. Uitgaande IP-adressen genereren voor uw nieuwe App Service Environment v3

Voer de volgende opdracht uit om nieuwe uitgaande IP-adressen te maken. Deze stap duurt ongeveer 15 minuten. Schaal of breng gedurende deze tijd geen wijzigingen aan in uw bestaande App Service-omgeving.

az rest --method post --uri "${ASE_ID}/NoDowntimeMigrate?phase=PreMigration&api-version=2022-03-01"

Voer de volgende opdracht uit om de status van deze stap te controleren:

az rest --method get --uri "${ASE_ID}?api-version=2022-03-01" --query properties.status

Als de stap wordt uitgevoerd, krijgt u de status Migrating. Nadat u de status hebt, Readyvoert u de volgende opdracht uit om uw nieuwe uitgaande IP-adressen weer te geven. Als u de nieuwe IP-adressen niet onmiddellijk ziet, wacht u enkele minuten en probeert u het opnieuw.

az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2022-03-01" --query properties.windowsOutboundIpAddresses

5. Afhankelijke resources bijwerken met nieuwe uitgaande IP-adressen

Werk met behulp van de nieuwe uitgaande IP-adressen een van uw resources of netwerkonderdelen bij om ervoor te zorgen dat uw nieuwe omgeving functioneert zoals bedoeld nadat de migratie is gestart. Het is uw verantwoordelijkheid om eventuele benodigde updates te maken. De nieuwe uitgaande IP-adressen worden gebruikt zodra de App Service Environment v3 is gemaakt tijdens de migratiestap. Als u bijvoorbeeld een aangepast domeinachtervoegsel en een Azure Key Vault hebt en toegangsbeperkingen beheert met een firewall, moet u de firewall van Azure Key Vault bijwerken om alleen de nieuwe uitgaande IP-adressen of het hele nieuwe subnet toe te staan.

6. Uw App Service Environment-subnet delegeren

App Service Environment v3 vereist dat het subnet waarin het zich bevindt één delegering heeft Microsoft.Web/hostingEnvironments. Voor eerdere versies is deze delegatie niet vereist. U moet controleren of uw subnet correct is gedelegeerd en de overdracht (indien nodig) bijwerken voordat u migreert. U kunt de overdracht bijwerken door de volgende opdracht uit te voeren of door naar het subnet in Azure Portal te gaan.

az network vnet subnet update --resource-group $VNET_RG --name <subnet-name> --vnet-name <vnet-name> --delegations Microsoft.Web/hostingEnvironments

7. Controleer of het virtuele netwerk geen vergrendelingen bevat

Virtuele netwerk vergrendelt platformbewerkingen tijdens de migratie. Als uw virtuele netwerk vergrendelingen heeft, moet u deze verwijderen voordat u migreert. Indien nodig kunt u de vergrendelingen weer toevoegen nadat de migratie is voltooid.

Gebruik de volgende opdracht om te controleren of uw virtuele netwerk vergrendelingen heeft:

az lock list --resource-group $VNET_RG --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks

Verwijder bestaande vergrendelingen met behulp van de volgende opdracht:

az lock delete --resource-group $VNET_RG --name <lock-name> --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks

Zie de Azure CLI-verwijzing voor vergrendelingen voor gerelateerde opdrachten om te controleren of uw abonnement of resourcegroep vergrendelingen heeft.

8. Uw configuraties voorbereiden

Als uw bestaande App Service Environment gebruikmaakt van een aangepast domeinachtervoegsel, moet u er een configureren voor uw nieuwe App Service Environment v3-resource tijdens het migratieproces. Migratie mislukt als u geen aangepast domeinachtervoegsel configureert en er momenteel een gebruikt. Zie aangepast domeinachtervoegsel voor App Service Environment v3 voor meer informatie over aangepaste domeinachtervoegsels, waaronder vereisten, stapsgewijze instructies en aanbevolen procedures voor aangepast domein voor App Service Environments.

Notitie

Als u een aangepast domeinachtervoegsel configureert en u de netwerkmachtigingen aan uw Azure-sleutelkluis toevoegt, moet u ervoor zorgen dat uw sleutelkluis toegang toestaat vanuit het nieuwe subnet van uw App Service Environment v3. Als u toegang hebt tot uw sleutelkluis met behulp van een privé-eindpunt, controleert u of u persoonlijke toegang correct hebt geconfigureerd met het nieuwe subnet. U ondervindt downtime als u deze toegang niet correct instelt vóór de migratie.

U kunt uw nieuwe App Service Environment v3-zone redundant maken als uw bestaande omgeving zich in een regio bevindt die zoneredundantie ondersteunt. Zoneredundantie kan worden geconfigureerd door de zoneRedundant eigenschap in te stellen op true. Zoneredundantie is een optionele configuratie. Deze configuratie kan alleen worden ingesteld tijdens het maken van uw nieuwe App Service Environment v3 en kan later niet worden verwijderd.

Als u deze configuraties wilt instellen, inclusief het identificeren van het subnet dat u eerder hebt geselecteerd, maakt u een bestand met de naam parameters.json met de volgende details op basis van uw scenario. Zorg ervoor dat u het nieuwe subnet gebruikt dat u hebt geselecteerd voor uw nieuwe App Service Environment v3. Neem de eigenschappen voor een aangepast domeinachtervoegsel niet op als deze functie niet van toepassing is op uw migratie. Let op de waarde van de zoneRedundant eigenschap en stel deze in op basis van uw tolerantievereiste.

Als u migreert zonder een aangepast domeinachtervoegsel, gebruikt u deze code:

{
    "Properties": {
        "VirtualNetwork": {
            "Id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Network/virtualNetworks/<virtual-network-name>/subnets/<subnet-name>"
        },
        "zoneRedundant": "<true/false>"
    }
}

Als u een door de gebruiker toegewezen beheerde identiteit gebruikt voor de configuratie van het aangepaste domeinachtervoegsel, gebruikt u deze code:

{
    "Properties": {
        "VirtualNetwork": {
            "Id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Network/virtualNetworks/<virtual-network-name>/subnets/<subnet-name>"
        },
        "zoneRedundant": "<true/false>",
        "customDnsSuffixConfiguration": {
            "dnsSuffix": "internal.contoso.com",
            "certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
            "keyVaultReferenceIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/asev3-migration/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ase-managed-identity"
        }
    }
}

Als u een door het systeem toegewezen beheerde identiteit gebruikt voor de configuratie van het aangepaste domeinachtervoegsel, gebruikt u deze code:

{
    "properties": {
        "VirtualNetwork": {
            "Id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Network/virtualNetworks/<virtual-network-name>/subnets/<subnet-name>"
        },
        "zoneRedundant": "<true/false>",
        "customDnsSuffixConfiguration": {
            "dnsSuffix": "internal.contoso.com",
            "certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
            "keyVaultReferenceIdentity": "SystemAssigned"
        }
    }
}

9. Migreren naar App Service Environment v3 en de status controleren

Nadat u alle voorgaande stappen hebt voltooid, kunt u de migratie starten. Zorg ervoor dat u de gevolgen van de migratie begrijpt.

Deze stap duurt drie tot zes uur. Gedurende die tijd is er geen downtime voor toepassingen als u de vorige stappen hebt uitgevoerd. Schalen, implementaties en wijzigingen in uw bestaande App Service-omgeving worden tijdens deze stap geblokkeerd.

Notitie

Vanwege een bekende fout worden webtaken mogelijk niet gestart tijdens de hybride implementatiestap. Als u webtaken gebruikt, kan deze fout app-problemen/downtime veroorzaken. Open een ondersteuningsaanvraag als u vragen of opmerkingen hebt over dit probleem.

Voer de volgende opdracht uit om de migratie te starten:

az rest --method post --uri "${ASE_ID}/NoDowntimeMigrate?phase=HybridDeployment&api-version=2022-03-01" --body @parameters.json

Voer de volgende opdracht uit om de status van uw migratie te controleren:

az rest --method get --uri "${ASE_ID}?api-version=2022-03-01" --query properties.subStatus

Nadat u de status hebt, MigrationPendingDnsChangewordt de migratie uitgevoerd en hebt u een App Service Environment v3-resource. Uw apps worden nu uitgevoerd in uw nieuwe omgeving en in uw oude omgeving.

Haal de details van uw nieuwe omgeving op door de volgende opdracht uit te voeren:

az appservice ase show --name $ASE_NAME --resource-group $ASE_RG

Belangrijk

Tijdens de migratie en tijdens de MigrationPendingDnsChange stap toont Azure Portal onjuiste informatie over uw App Service Environment en uw apps. Gebruik de Azure CLI om de status van uw migratie te controleren. Als u vragen hebt over de status van uw migratie of uw apps, neemt u contact op met de ondersteuning.

Notitie

Als uw migratie een aangepast domeinachtervoegsel bevat, kan de configuratie van het aangepaste domeinachtervoegsel worden weergegeven als gedegradeerd zodra de migratie is voltooid vanwege een bekende fout. Uw App Service Environment werkt nog steeds zoals verwacht. De gedegradeerde status moet zichzelf binnen 6-8 uur oplossen. Als de configuratie na 8 uur is gedegradeerd of als het achtervoegsel van uw aangepaste domein niet werkt, neemt u contact op met de ondersteuning.

10. Haal de binnenkomende IP-adressen voor uw nieuwe App Service Environment v3 op en werk afhankelijke resources bij

U hebt twee sets front-ends van App Service Environment in deze fase in het migratieproces en beide sets kunnen toepassingsverkeer verwerken. Uw DNS wordt niet gewijzigd, dus standaard wordt verkeer verzonden naar de oude front-ends van de App Service Environment. U moet afhankelijke resources bijwerken om het nieuwe binnenkomende IP-adres voor uw nieuwe App Service Environment v3 te gebruiken. Voor interne App Service Environments (ILB) moet u uw privé-DNS-zones bijwerken om te verwijzen naar het nieuwe binnenkomende IP-adres.

U kunt het nieuwe binnenkomende IP-adres voor uw nieuwe App Service Environment v3 ophalen door de volgende opdracht uit te voeren die overeenkomt met het load balancertype van uw App Service Environment. Het is uw verantwoordelijkheid om eventuele benodigde updates te maken.

Voor ILB App Service Environments haalt u het privé-binnenkomende IP-adres op door de volgende opdracht uit te voeren:

az rest --method get --uri "${ASE_ID}?api-version=2022-03-01" --query properties.networkingConfiguration.internalInboundIpAddresses

Voor ELB App Service-omgevingen haalt u het openbare binnenkomende IP-adres op door de volgende opdracht uit te voeren:

az rest --method get --uri "${ASE_ID}?api-version=2022-03-01" --query properties.networkingConfiguration.externalInboundIpAddresses

Belangrijk

Als uw migratie een aangepast domeinachtervoegsel bevat, is het standaardgedrag van de hostnaam voor App Service Environment v3 anders dan voor App Service Environment v2. Voor App Service Environment v3 gebruikt de standaardhostnaam altijd het standaarddomeinachtervoegsel en bevindt zich in de vorm APP-NAME.ASE-NAME.appserviceenvironment.net. Controleer al uw afhankelijke resources, zoals App Gateway, die gebruikmaken van de hostnamen van uw apps om ervoor te zorgen dat ze worden bijgewerkt om rekening te houden met dit gedrag. Zie de vergelijking van de app Service-omgevingsversie voor meer informatie over de functieverschillen tussen de verschillende versies.

11. Klantverkeer omleiden, uw App Service Environment v3 valideren en de migratie voltooien

Deze stap is de kans om uw nieuwe App Service Environment v3 te testen en te valideren.

Belangrijk

U hebt 14 dagen de tijd om deze stap te voltooien. Na 14 dagen wordt de migratie automatisch voltooid en wordt uw oude omgeving verwijderd. Als u meer tijd nodig hebt, kunt u een ondersteuningsaanvraag openen om uw opties te bespreken.

Zodra u hebt bevestigd dat uw apps werken zoals verwacht, kunt u de migratie voltooien door de volgende opdracht uit te voeren. Met deze opdracht verwijdert u ook uw oude omgeving.

Als u problemen ondervindt of op dit moment besluit dat u niet langer wilt doorgaan met de migratie, neemt u contact op met de ondersteuning om uw opties te bespreken. Voer de dns-wijzigingsopdracht niet uit omdat deze opdracht de migratie voltooit.

az rest --method post --uri "${ASE_ID}/NoDowntimeMigrate?phase=DnsChange&api-version=2022-03-01"

Voer de volgende opdracht uit om de status van deze stap te controleren:

az rest --method get --uri "${ASE_ID}?api-version=2022-03-01" --query properties.subStatus

Tijdens deze stap krijgt u de status CompletingMigration. Wanneer u de status krijgt, wordt de stap voor het omleiden van MigrationCompletedverkeer uitgevoerd en is uw migratie voltooid.

Veelvoorkomende bronnen van problemen bij het migreren met behulp van de functie voor side-by-side-migratie

Hier volgen enkele voorbeelden van veelvoorkomende problemen die klanten ondervinden bij het migreren met behulp van de functie voor side-by-side migratie. Bekijk deze gebieden om ervoor te zorgen dat u geen downtime of servicestoringen ondervindt tijdens of na het migratieproces.

• Azure Key Vault moet verkeer van het nieuwe uitgaande IP-adres/subnet toestaan.
• De twee subnetten moeten in beide richtingen met elkaar kunnen communiceren. Klanten staan meestal verkeer van het oude naar het nieuwe subnet toe, maar vergeet het verkeer van het nieuwe naar het oude subnet toe te staan.
• App Gateway moet worden bijgewerkt met de nieuwe IP-adressen.
• DNS-records moeten worden bijgewerkt met de nieuwe IP-adressen.
• Als u IP-adressen in uw toepassingen hebt vastgelegd, moet u deze bijwerken met de nieuwe IP-adressen.
• Routetabellen moeten worden bijgewerkt met nieuwe routes.

Prijzen

Er zijn geen kosten verbonden aan het migreren van uw App Service Environment. U wordt echter gefactureerd voor zowel uw App Service Environment v2 als uw nieuwe App Service Environment v3 zodra u het migratieproces start. Er worden geen kosten meer in rekening gebracht voor uw oude App Service Environment v2 wanneer u de laatste migratiestap voltooit waarbij de oude omgeving wordt verwijderd. U moet uw validatie zo snel mogelijk voltooien om te voorkomen dat overtollige kosten worden opgestapeld. Zie de prijsinformatie voor meer informatie over prijzen voor App Service Environment v3.

Wanneer u vanuit eerdere versies migreert naar App Service Environment v3, zijn er scenario's die u moet overwegen om uw maandelijkse kosten te verlagen. Overweeg reserveringen en spaarplannen om uw kosten verder te verlagen. Zie Kostenbesparende verkoopkansen na een upgrade naar App Service Environment v3 voor informatie over kostenbesparingen.

Notitie

Vanwege de verschillen tussen de prijscategorieën Isolated naar Isolated v2 kunnen uw apps na de migratie te veel worden ingericht omdat de laag Isolated v2 meer geheugen en CPU per bijbehorende instantiegrootte heeft. U hebt de mogelijkheid om uw omgeving zo nodig te schalen zodra de migratie is voltooid. Raadpleeg de SKU-details voor meer informatie.

Uw App Service-abonnementen omlaag schalen

De App Service-plan-SKU's die beschikbaar zijn voor App Service Environment v3 worden uitgevoerd op de laag Isolated v2 (Iv2). Het aantal kernen en de hoeveelheid RAM wordt effectief verdubbeld per bijbehorende laag vergeleken met de geïsoleerde laag. Wanneer u migreert, worden uw App Service-abonnementen geconverteerd naar de bijbehorende laag. Uw I2-exemplaren worden bijvoorbeeld geconverteerd naar I2v2. Hoewel I2 twee kernen en 7 GB RAM heeft, heeft I2v2 vier kernen en 16 GB RAM. Als u verwacht dat uw capaciteitsvereisten hetzelfde blijven, bent u over-ingericht en betaalt u voor reken- en geheugengebruik dat u niet gebruikt. Voor dit scenario kunt u uw I2v2-exemplaar omlaag schalen naar I1v2 en uiteindelijk eindigen met een vergelijkbaar aantal kernen en RAM-geheugen dat u eerder had.

Veelgestelde vragen

• Wat gebeurt er als het migreren van mijn App Service-omgeving momenteel niet wordt ondersteund?
  U kunt op dit moment niet migreren met behulp van de functie voor side-by-side-migratie. Als u een niet-ondersteunde omgeving hebt en onmiddellijk wilt migreren, raadpleegt u de opties voor handmatige migratie.
• Hoe kan ik kiezen welke migratieoptie geschikt is voor mij?
  Bekijk de beslissingsstructuur van het migratiepad om te bepalen welke optie het beste is voor uw use-case.
• Hoe kan ik weten of ik de functie voor migratie naast elkaar moet gebruiken?
  De functie voor side-by-side-migratie is het meest geschikt voor klanten die willen migreren naar App Service Environment v3, maar geen ondersteuning bieden voor downtime van toepassingen. Omdat er een nieuw subnet wordt gebruikt voor uw nieuwe omgeving, zijn er netwerkoverwegingen waarmee u rekening moet houden, inclusief nieuwe IP-adressen. Als u downtime kunt ondersteunen, raadpleegt u de in-place migratiefunctie, wat resulteert in minimale configuratiewijzigingen of de opties voor handmatige migratie. De in-place migratiefunctie maakt uw App Service Environment v3 in hetzelfde subnet als uw bestaande omgeving en maakt gebruik van dezelfde netwerkinfrastructuur.
• Ondervind ik downtime tijdens de migratie?
  Het platform garandeert dat er geen downtime is tijdens het migratieproces naast elkaar. Uw DNS-instellingen kunnen echter downtime veroorzaken tijdens de DNS-wijzigingsstap. Dit kan worden veroorzaakt door problemen met betrekking tot TTL- en cache-instellingen, omdat verkeer mogelijk nog steeds wordt omgeleid naar uw oude App Service Environment na de DNS-wijziging. Controleer uw DNS-instellingen en zorg ervoor dat u een lage TTL hebt en dat uw DNS-provider ondersteuning biedt voor snelle doorgifte.
• Moet ik na de migratie iets doen voor mijn apps om ze uit te voeren in de nieuwe App Service Environment?
  Nee, al uw apps die in de oude omgeving worden uitgevoerd, worden automatisch gemigreerd naar de nieuwe omgeving en worden uitgevoerd zoals voorheen. Er is geen gebruikersinvoer nodig.
• Wat gebeurt er als mijn App Service Environment een aangepast domeinachtervoegsel heeft?
  De functie voor side-by-side-migratie ondersteunt dit migratiescenario.
• Wat gebeurt er als mijn App Service Environment-zone is vastgemaakt?
  De migratiefunctie naast elkaar biedt momenteel geen ondersteuning voor dit migratiescenario . Zie de opties voor handmatige migratie als u een zone vastgemaakte App Service Environment hebt en direct wilt migreren.
• Wat gebeurt er als mijn App Service Environment IP SSL-adressen heeft?
  IP SSL wordt niet ondersteund in App Service Environment v3. U moet alle IP SSL-bindingen verwijderen voordat u migreert met behulp van de migratiefunctie of een van de handmatige opties. Als u de migratiefunctie naast elkaar wilt gebruiken nadat u alle IP SSL-bindingen hebt verwijderd, geeft u die validatiecontrole door en kunt u doorgaan met de geautomatiseerde migratie.
• Welke eigenschappen van mijn App Service Environment worden gewijzigd?
  U bevindt zich in App Service Environment v3, dus zorg ervoor dat u de functies en functieverschillen bekijkt in vergelijking met eerdere versies. Zowel uw binnenkomende als uitgaande IP-adressen worden gewijzigd wanneer u de functie voor side-by-side-migratie gebruikt. Opmerking voor ELB App Service Environment: voorheen was er één IP-adres voor zowel inkomend als uitgaand. Voor App Service Environment v3 zijn ze gescheiden. Zie App Service Environment V3-netwerken voor meer informatie. Zie App Service Environment-versievergelijking voor een volledige vergelijking van de App Service Environment-versies.
• Wat gebeurt er als de migratie mislukt of er een onverwacht probleem is tijdens de migratie?
  Als er een onverwacht probleem is, zijn ondersteuningsteams bij de hand. We raden u aan ontwikkelomgevingen te migreren voordat u eventuele productieomgevingen aanraakt om meer te weten te komen over het migratieproces en te zien hoe dit van invloed is op uw workloads.
• Wat gebeurt er met mijn oude App Service Environment?
  Als u besluit een App Service-omgeving te migreren met behulp van de migratiefunctie naast elkaar, wordt uw oude omgeving gebruikt tot de laatste stap in het migratieproces. Zodra u de laatste stap hebt voltooid, worden de oude omgeving en alle apps die erop worden gehost, afgesloten en verwijderd. Uw oude omgeving is niet meer toegankelijk. Een terug naar de oude omgeving op dit moment is niet mogelijk.
• Wat gebeurt er met mijn App Service Environment v1/v2-resources na 31 augustus 2024?
  Als u na 31 augustus 2024 niet migreert naar App Service Environment v3, zijn uw App Service Environment v1/v2's en de apps die erin zijn geïmplementeerd, niet meer beschikbaar. App Service Environment v1/v2 wordt gehost op App Service-schaaleenheden die worden uitgevoerd in cloudservices (klassiek) architectuur die op 31 augustus 2024 buiten gebruik wordt gesteld. Daarom is App Service Environment v1/v2 na die datum niet meer beschikbaar. Migreer naar App Service Environment v3 om uw apps actief te houden of om resources of gegevens die u moet onderhouden, op te slaan of er een back-up van te maken.

Volgende stappen

App Service Environment v3-netwerken

Een App Service Environment v3 gebruiken

Achtervoegsel van aangepast domein