Delen via


De in-place migratiefunctie gebruiken om App Service Environment v1 en v2 te migreren naar App Service Environment v3

Notitie

De migratiefunctie die in dit artikel wordt beschreven, wordt gebruikt voor geautomatiseerde migratie van App Service Environment v1 en v2 naar App Service Environment v3 .in-place (hetzelfde subnet). Zie Migreren naar App Service Environment v3 met behulp van de functie voor side-by-side-migratie als u op zoek bent naar informatie over de functie voor side-by-side-migratie. 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.

U kunt App Service Environment v1 en v2 automatisch migreren naar App Service Environment v3 met behulp van de in-place migratiefunctie. Zie het overzicht van de in-place migratiefunctie voor meer informatie over het migratieproces en om te zien of uw App Service Environment op dit moment ondersteuning biedt voor migratie.

Belangrijk

We raden u aan deze functie te gebruiken voor ontwikkelomgevingen voordat u productieomgevingen migreert, om onverwachte problemen te voorkomen. Geef feedback met betrekking tot dit artikel of de functie met behulp van de knoppen onder aan de pagina.

Vereisten

Zorg ervoor dat u begrijpt hoe migratie naar App Service Environment v3 van invloed is op uw toepassingen. Bekijk het migratieproces 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 er geen vergrendelingen zijn op uw virtuele netwerk, resourcegroep, resource of abonnement. 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 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.

U wordt aangeraden Azure Portal te gebruiken voor de in-place migratie-ervaring. Als u besluit de Azure CLI te gebruiken voor de migratie, volgt u 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.

1. 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)

2. Valideren dat migratie wordt ondersteund

Met de volgende opdracht wordt gecontroleerd of uw App Service-omgeving wordt ondersteund voor migratie. Als er een fout optreedt of als uw App Service-omgeving de status Niet in orde of onderbroken heeft, kunt u op dit moment niet migreren. Zie de sectie probleemoplossing voor beschrijvingen van de mogelijke foutberichten die u kunt krijgen. Als uw omgeving niet wordt ondersteund voor migratie met behulp van de in-place migratiefunctie of als u wilt migreren naar App Service Environment v3 zonder de in-place migratiefunctie te gebruiken, raadpleegt u de handmatige migratieopties. Met deze opdracht wordt ook gevalideerd of uw App Service-omgeving de ondersteunde buildversie voor migratie heeft. Als uw App Service-omgeving zich niet op de ondersteunde buildversie bevindt, moet u de upgrade zelf starten, wat 8-12 uur of langer kan duren, afhankelijk van de grootte van uw omgeving. Zie Valideren dat migratie wordt ondersteund met behulp van de in-place migratiefunctie voor uw App Service-omgeving voor meer informatie over de upgrade voor premigratie.

az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=validation"

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

Als u een upgrade wilt starten om uw App Service Environment te upgraden naar de ondersteunde buildversie, 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}/migrate?api-version=2021-02-01&phase=PreMigrationUpgrade"

3. IP-adressen genereren voor uw nieuwe App Service Environment v3-resource

Voer de volgende opdracht uit om nieuwe 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}/migrate?api-version=2021-02-01&phase=premigration"

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

az rest --method get --uri "${ASE_ID}?api-version=2021-02-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 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=2021-02-01"

Notitie

Vanwege een bekende fout kan het binnenkomende IP-adres voor ELB App Service Environment-migraties opnieuw worden gewijzigd zodra de migratiestap is voltooid. Wees voorbereid om uw afhankelijke resources opnieuw bij te werken met het nieuwe binnenkomende IP-adres nadat de migratiestap is voltooid. Deze fout wordt opgelost en wordt zo snel mogelijk opgelost. Open een ondersteuningsaanvraag als u vragen of zorgen hebt over dit probleem of hulp nodig hebt bij het migratieproces.

4. Afhankelijke resources bijwerken met nieuwe IP-adressen

Werk met behulp van de nieuwe IP-adressen een van uw resources of netwerkonderdelen bij om ervoor te zorgen dat uw nieuwe omgeving functioneert zoals bedoeld nadat de migratie is voltooid. Het is uw verantwoordelijkheid om eventuele benodigde updates te maken.

Deze stap is ook een goed moment om de binnenkomende en uitgaande netwerkafhankelijkheidswijzigingen te bekijken bij het overstappen naar App Service Environment v3. Deze wijzigingen omvatten de poortwijziging voor Azure Load Balancer, die nu poort 80 gebruikt. Migreer pas nadat u deze stap hebt voltooid.

5. 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

6. 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.

Vergrendelingen kunnen bestaan op drie 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, moet u deze vóór de migratie verwijderen. Zie Uw resources vergrendelen om uw infrastructuur te beveiligen voor meer informatie over vergrendelingen en overname van vergrendelingen.

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.

7. Uw configuraties voorbereiden

U kunt uw nieuwe App Service Environment v3-resourcezone redundant maken als uw bestaande omgeving zich in een regio bevindt die zoneredundantie ondersteunt. U kunt zoneredundantie configureren door de zoneRedundant eigenschap in te stellen op true.

Zoneredundantie is een optionele configuratie. U kunt deze alleen instellen tijdens het maken van uw nieuwe App Service Environment v3-resource. U kunt deze op een later tijdstip niet verwijderen. Zie Uw App Service Environment v3-configuraties kiezen voor meer informatie. Als u zoneredundantie niet wilt configureren, neemt u de zoneRedundant parameter niet op.

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. Migratie mislukt ook als u een aangepast domeinachtervoegsel probeert toe te voegen tijdens de migratie naar een omgeving die niet is geconfigureerd. 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 toevoegt aan uw Azure-sleutelkluis, moet u ervoor zorgen dat uw sleutelkluis toegang toestaat vanaf de nieuwe uitgaande IP-adressen van uw App Service Environment die zijn gegenereerd in stap 3. Als u toegang hebt tot uw sleutelkluis met behulp van een privé-eindpunt, controleert u of u persoonlijke toegang correct hebt geconfigureerd.

Als uw migratie geen aangepast domeinachtervoegsel bevat en u zoneredundantie niet inschakelt, kunt u doorgaan met de migratie.

Als u deze configuraties wilt instellen, maakt u een bestand met de naam parameters.json met de volgende details op basis van uw scenario. 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, omdat deze configuratie na de migratie niet kan worden hersteld. Stel de waarde van de kind eigenschap in op basis van uw bestaande Versie van App Service Environment. Geaccepteerde waarden voor de kind eigenschap zijn ASEV1 en ASEV2.

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

{
    "type": "Microsoft.Web/hostingEnvironments",
    "name": "sample-ase-migration",
    "kind": "ASEV2",
    "location": "westcentralus",
    "properties": {
        "zoneRedundant": true
    }
}

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

{
    "type": "Microsoft.Web/hostingEnvironments",
    "name": "sample-ase-migration",
    "kind": "ASEV2",
    "location": "westcentralus",
    "properties": {
        "zoneRedundant": true,
        "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 en u zoneredundantie niet inschakelt, gebruikt u deze code:

{
    "type": "Microsoft.Web/hostingEnvironments",
    "name": "sample-ase-migration",
    "kind": "ASEV2",
    "location": "westcentralus",
    "properties": {
        "customDnsSuffixConfiguration": {
            "dnsSuffix": "internal.contoso.com",
            "certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
            "keyVaultReferenceIdentity": "SystemAssigned"
        }
    }
}

8. 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 voor v2-naar-v3-migraties en maximaal zes uur voor v1-v3-migraties, afhankelijk van de omgevingsgrootte. Gedurende die tijd is er ongeveer één uur downtime van de toepassing. Schalen, implementaties en wijzigingen in uw bestaande App Service-omgeving worden tijdens deze stap geblokkeerd.

Neem de body parameter op in de volgende opdracht als u zoneredundantie inschakelt en/of een aangepast domeinachtervoegsel configureert. Als geen van deze configuraties van toepassing is op uw migratie, kunt u de parameter uit de opdracht verwijderen.

az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=fullmigration" --body @parameters.json

Voer de volgende opdrachten uit om de gedetailleerde status van uw migratie te controleren. Zie de beschrijvingen van de migratiestatus voor meer informatie over de statussen.

Met de eerste opdracht wordt de bewerkings-id voor de migratie ophaalt. Kopieer de waarde van de ID eigenschap.

az rest --method get --uri "${ASE_ID}/operations?api-version=2022-03-01"

Vervang de tijdelijke aanduiding voor de bewerkings-id in de volgende opdracht door de waarde die u hebt gekopieerd. Met deze opdracht wordt de gedetailleerde status van uw migratie geretourneerd. U kunt deze opdracht zo vaak als nodig uitvoeren om de meest recente status op te halen.

az rest --method get --uri "${ASE_ID}/operations/<operation-id>/details/default?api-version=2022-09-01"

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

Haal de details van uw nieuwe omgeving op door de volgende opdracht uit te voeren of door naar Azure Portal te gaan.

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

Notitie

Vanwege een bekende fout kan het binnenkomende IP-adres voor ELB App Service Environment-migraties worden gewijzigd zodra de migratiestap is voltooid. Controleer de IP-adressen van uw App Service Environment v3 en breng eventuele benodigde updates aan als er wijzigingen zijn aangebracht sinds de stap voor het genereren van IP-adressen. Open een ondersteuningsaanvraag als u vragen of zorgen hebt over dit probleem of hulp nodig hebt bij het bevestigen van de nieuwe IP-adressen.

1. Controleer of migratie wordt ondersteund

Ga in Azure Portal naar de migratiepagina voor de App Service-omgeving die u migreert. U kunt naar de migratiepagina gaan door de banner boven aan de pagina Overzicht voor uw App Service Environment te selecteren of door het migratie-item in het linkermenu te selecteren.

Schermopname van migratietoegangspunten.

Op de pagina Migratie controleert het platform of de migratie wordt ondersteund voor uw App Service-omgeving. Selecteer Valideren en bevestig vervolgens dat u door wilt gaan met de validatie. Het validatieproces duurt enkele seconden.

Schermopname van de knop voor het valideren van de geschiktheid van de migratie.

Als uw omgeving niet wordt ondersteund voor migratie, wordt boven aan de pagina een banner weergegeven met een foutbericht met een reden. Zie Probleemoplossing voor beschrijvingen van de foutberichten die kunnen worden weergegeven als u niet in aanmerking komt voor migratie.

Als uw App Service-omgeving op dit moment niet wordt ondersteund voor migratie of als uw omgeving de status Beschadigd of Onderbroken heeft, kunt u de migratiefunctie niet gebruiken. Als uw omgeving niet wordt ondersteund voor migratie met de in-place migratiefunctie of als u wilt migreren naar App Service Environment v3 zonder de in-place migratiefunctie te gebruiken, raadpleegt u de opties voor handmatige migratie.

Schermopname van een voorbeeld van een portalbericht met de melding dat de migratiefunctie geen ondersteuning biedt voor de App Service Environment.

Als u een upgrade moet starten om uw App Service Environment te upgraden naar de ondersteunde buildversie, wordt u gevraagd om de upgrade te starten. Dit kan 8-12 uur of langer duren, afhankelijk van de grootte van uw omgeving. Selecteer Upgraden om de upgrade te starten. Wanneer de upgrade is voltooid, geeft u de validatie door en kunt u de migratiefunctie gebruiken om de migratie te starten.

Als migratie wordt ondersteund voor uw App Service Environment, gaat u verder met de volgende stap in het proces. De migratiepagina begeleidt u door de reeks stappen om de migratie te voltooien.

Schermopname van een voorbeeldmigratiepagina met niet-voltooide stappen in het proces.

2. IP-adressen genereren voor uw nieuwe App Service Environment v3-resource

Controleer onder Nieuwe IP-adressen ophalen of u de gevolgen begrijpt en selecteer de knop Start . Deze stap duurt ongeveer 15 minuten. U kunt gedurende deze tijd niet schalen of wijzigingen aanbrengen in uw bestaande App Service-omgeving.

3. Afhankelijke resources bijwerken met nieuwe IP-adressen

Wanneer de vorige stap is voltooid, worden de IP-adressen voor uw nieuwe App Service Environment v3-resource weergegeven. Gebruik de nieuwe IP-adressen om resources en netwerkonderdelen bij te werken, zodat uw nieuwe omgeving functioneert zoals bedoeld nadat de migratie is voltooid. Het is uw verantwoordelijkheid om eventuele benodigde updates te maken.

Deze stap is ook een goed moment om de binnenkomende en uitgaande netwerkafhankelijkheidswijzigingen te bekijken bij het overstappen naar App Service Environment v3. Deze wijzigingen omvatten de poortwijziging voor Azure Load Balancer, die nu poort 80 gebruikt. Ga pas verder met de volgende stap nadat u hebt bevestigd dat u deze updates hebt doorgevoerd.

Schermopname van voorbeeld-IP's die tijdens de premigratie zijn gegenereerd.

4. 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. In de portal wordt een koppeling naar uw subnet weergegeven, zodat u indien nodig kunt bevestigen en bijwerken.

Schermopname van subnetdelegering in de portal.

5. Wijzigingen in exemplaargrootte bevestigen

Uw App Service-plannen worden van Geïsoleerd geconverteerd naar de bijbehorende laag Isolated v2. I2 wordt bijvoorbeeld geconverteerd naar I2v2. Uw apps zijn mogelijk te veel ingericht na de migratie, omdat de geïsoleerde v2-laag meer geheugen en CPU heeft per bijbehorende instantiegrootte. U hebt de mogelijkheid om uw omgeving zo nodig te schalen nadat de migratie is voltooid. Raadpleeg de prijsgegevens voor meer informatie.

Schermopname van het bevestigen van de grootte van het exemplaar tijdens de migratie.

6. Controleer of het virtuele netwerk geen vergrendelingen heeft

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.

Vergrendelingen kunnen bestaan op drie 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, moet u deze vóór de migratie verwijderen. Zie Uw resources vergrendelen om uw infrastructuur te beveiligen voor meer informatie over vergrendelingen en overname van vergrendelingen.

Zie Vergrendelingen configureren voor meer informatie over het controleren of uw abonnement of resourcegroep vergrendelingen heeft.

Schermopname van waar u virtuele netwerkvergrendelingen kunt vinden en verwijderen.

7. Kies uw configuraties

U kunt uw nieuwe App Service Environment v3-resourcezone redundant maken als uw bestaande omgeving zich in een regio bevindt die zoneredundantie ondersteunt. Zoneredundantie is een optionele configuratie. U kunt deze alleen instellen tijdens het maken van uw nieuwe App Service Environment v3-resource. U kunt deze op een later tijdstip niet verwijderen. Zie Uw App Service Environment v3-configuraties kiezen voor meer informatie.

Schakel het selectievakje Ingeschakeld in als u zoneredundantie wilt configureren.

Schermopname van het selectievakje voor het inschakelen van zoneredundantie voor een App Service Environment in een ondersteunde regio.

Als uw omgeving zich in een regio bevindt die zoneredundantie niet ondersteunt, is het selectievakje niet beschikbaar. Als u een zoneredundante App Service Environment v3-resource nodig hebt, gebruikt u een van de handmatige migratieopties en maakt u de resource in een van de regio's die zoneredundantie ondersteunen.

Als uw bestaande App Service Environment gebruikmaakt van een aangepast domeinachtervoegsel, moet u er een configureren voor uw nieuwe App Service Environment v3-resource. De configuratieopties voor een aangepast domeinachtervoegsel worden weergegeven als deze situatie op u van toepassing is. U kunt pas migreren als u de vereiste gegevens opgeeft.

Als u een aangepast domeinachtervoegsel wilt gebruiken, maar momenteel nog geen domeinachtervoegsel hebt geconfigureerd, kunt u er een configureren nadat de migratie is voltooid. 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 toevoegt aan uw Azure-sleutelkluis, moet u ervoor zorgen dat uw sleutelkluis toegang toestaat vanaf de nieuwe uitgaande IP-adressen van uw App Service Environment die zijn gegenereerd in stap 2. Als u toegang hebt tot uw sleutelkluis met behulp van een privé-eindpunt, controleert u of u persoonlijke toegang correct hebt geconfigureerd.

Schermopname van de koppeling voor het toevoegen van een aangepast domeinachtervoegsel.

Nadat u de details voor het achtervoegsel van uw aangepaste domein hebt toegevoegd, is de knop Migreren beschikbaar.

Schermopname die laat zien dat de configuratiegegevens worden toegevoegd en dat de omgeving gereed is voor migratie.

8. Migreren naar App Service Environment v3

Nadat u alle voorgaande stappen hebt voltooid, kunt u de migratie starten. Zorg ervoor dat u de gevolgen van de migratie begrijpt, inclusief wat er tijdens deze tijd gebeurt.

Deze stap duurt drie tot zes uur voor v2-naar-v3-migraties en maximaal zes uur voor v1-v3-migraties, afhankelijk van de omgevingsgrootte. Schalen en wijzigingen in uw bestaande App Service-omgeving worden tijdens deze stap geblokkeerd.

Notitie

In zeldzame gevallen ziet u mogelijk een melding in de portal met de tekst 'Migratie naar App Service Environment v3 is mislukt' nadat u de migratie hebt gestart. Er is een bekende fout die deze melding kan activeren, zelfs als de migratie vordert. Controleer het activiteitenlogboek voor de App Service Environment om de geldigheid van dit foutbericht te bepalen. In de meeste gevallen wordt het probleem opgelost door de pagina te vernieuwen en verdwijnt het foutbericht. Als het foutbericht zich blijft voordoen, neemt u contact op met de ondersteuning voor hulp.

Schermopname van de mogelijke foutmelding nadat de migratie is gestart.

Op dit moment zijn gedetailleerde migratiestatussen alleen beschikbaar wanneer u de Azure CLI gebruikt. Zie de sectie Azure CLI voor migratie naar App Service Environment v3 voor meer informatie. U kunt de status van de migratie controleren met de CLI, zelfs als u de portal gebruikt om de migratie uit te voeren.

Wanneer de migratie is voltooid, hebt u een App Service Environment v3-resource en worden al uw apps uitgevoerd in uw nieuwe omgeving. U kunt de versie van de omgeving bevestigen door de configuratiepagina voor uw App Service-omgeving te controleren.

Notitie

Vanwege een bekende fout kan het binnenkomende IP-adres voor ELB App Service Environment-migraties worden gewijzigd zodra de migratiestap is voltooid. Controleer de IP-adressen van uw App Service Environment v3 en breng eventuele benodigde updates aan als er wijzigingen zijn aangebracht sinds de stap voor het genereren van IP-adressen. Open een ondersteuningsaanvraag als u vragen of zorgen hebt over dit probleem of hulp nodig hebt bij het bevestigen van de nieuwe IP-adressen.

Als uw migratie een aangepast domeinachtervoegsel bevat, wordt het domein weergegeven in de sectie Essentials van de overzichtspagina van de portal voor App Service Environment v1/v2, maar wordt het daar niet meer weergegeven in App Service Environment v3. Ga in plaats daarvan voor App Service Environment v3 naar de pagina aangepast domeinachtervoegsel om te bevestigen dat het achtervoegsel van uw aangepaste domein correct is geconfigureerd. U kunt de configuratie ook verwijderen als u deze niet meer nodig hebt of als u er nog geen hebt.

Schermopname van de pagina voor configuratie van aangepast domeinachtervoegsel voor App Service Environment v3.

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.

Schermopname van een voorbeeld van een gedegradeerde configuratie van aangepast domeinachtervoegsel.

Volgende stappen