Dela via

Migrering till App Service-miljön v3 med hjälp av migreringsfunktionen på plats

  • Artikel

Kommentar

Migreringsfunktionen som beskrivs i den här artikeln används för automatisk migrering på plats (samma undernät) av App Service-miljön v1 och v2 till App Service-miljön v3. Om du inte har begärt en respitperiod på 30 dagar granskar du översikten över respitperioden och begär sedan en respitperiod genom att gå till Azure Portal och besöka migreringsbladet för var och en av dina App Service-miljön.

Om du letar efter information om migreringsfunktionen sida vid sida kan du läsa Migrera till App Service-miljön v3 med hjälp av migreringsfunktionen sida vid sida. Information om manuella migreringsalternativ finns i Manuella migreringsalternativ. Mer information om vilket migreringsalternativ som passar dig finns i Beslutsträd för migreringssökväg. Mer information om App Service-miljön v3 finns i översikten över App Service-miljön v3.

App Service kan automatisera migreringen av din App Service-miljön v1 och v2 till en App Service-miljön v3. Det finns olika migreringsalternativ. Granska beslutsträdet för migreringssökvägen för att avgöra vilket alternativ som är bäst för ditt användningsfall. App Service-miljön v3 ger fördelar och funktionsskillnader jämfört med tidigare versioner. Se till att granska funktionerna i App Service-miljön v3 innan du migrerar för att minska risken för ett oväntat programproblem.

Migreringsfunktionen på plats automatiserar migreringen till App Service-miljön v3 genom att uppgradera din befintliga App Service-miljön i samma undernät. Det här migreringsalternativet passar bäst för kunder som vill migrera till App Service-miljön v3 med minimala ändringar i nätverkskonfigurationerna. Du måste också kunna stödja ungefär en timmes programavbrott. Om du inte har stöd för stilleståndstid kan du läsa sidans migreringsfunktion eller alternativen för manuell migrering.

Viktigt!

Vi rekommenderar att du använder den här funktionen för utvecklingsmiljöer först innan du migrerar några produktionsmiljöer för att säkerställa att det inte finns några oväntade problem. Ge feedback om den här artikeln eller funktionen med hjälp av knapparna längst ned på sidan.

Stödda scenarier

För närvarande stöder migreringsfunktionen på plats inte migreringar till App Service-miljön v3 i följande regioner:

Microsoft Azure drivs av 21Vianet

  • Östra Kina 2
  • Norra Kina 2

Följande App Service-miljön konfigurationer kan migreras med hjälp av migreringsfunktionen på plats. Tabellen ger App Service-miljön v3-konfigurationen när du använder migreringsfunktionen på plats baserat på din befintliga App Service-miljön. Alla App Service-miljön som stöds kan migreras till en zonredundant App Service-miljön v3 med hjälp av migreringsfunktionen på plats så länge miljön finns i en region som stöder zonredundans. Du kan konfigurera zonredundans under migreringsprocessen.

Konfiguration App Service-miljön v3-konfiguration
Intern lastbalanserare (ILB) App Service-miljön v2 ILB App Service-miljön v3
Extern (ELB/internetuppkopplad med offentlig IP)-App Service-miljön v2 ELB App Service-miljön v3
ILB App Service-miljön v2 med ett anpassat domänsuffix ILB App Service-miljön v3 med ett anpassat domänsuffix
ILB App Service-miljön v1 ILB App Service-miljön v3
ELB App Service-miljön v1 ELB App Service-miljön v3
ILB App Service-miljön v1 med ett anpassat domänsuffix ILB App Service-miljön v3 med ett anpassat domänsuffix
Zonfäst App Service-miljön v2 App Service-miljön v3 med valfri zonredundanskonfiguration

Om du vill att din nya App Service-miljön v3 ska använda ett anpassat domänsuffix och du inte använder ett för närvarande kan anpassat domänsuffix konfigureras när som helst när migreringen är klar. Mer information finns i Konfigurera anpassat domänsuffix för App Service-miljön.

Du hittar versionen av din App Service-miljön genom att gå till din App Service-miljön i Azure Portal och välja Konfiguration under Inställningar till vänster. Du kan också använda Azure Resource Explorer och granska värdet för kind egenskapen för din App Service-miljön.

Funktionsbegränsningar för migrering på plats

Följande är begränsningar när du använder migreringsfunktionen på plats:

  • Den nya App Service-miljön v3 finns i det befintliga undernätet som användes för din gamla miljö.
  • Du kan inte ändra regionen som App Service-miljön finns i.
  • ELB-App Service-miljön kan inte migreras till ILB App Service-miljön v3 och vice versa.
  • Om din befintliga App Service-miljö använder ett anpassat domänsuffix måste du konfigurera ett anpassat domänsuffix för App Service-miljön v3 under migreringsprocessen.
    • Om du inte längre vill använda ett anpassat domänsuffix tar du bort det när migreringen är klar.

App Service-miljön v3 stöder inte följande funktioner som du kan använda med din aktuella App Service-miljön v1 eller v2.

  • Konfigurera en IP-baserad TLS/SSL-bindning till dina appar.
  • Om de anpassade DNS-servrar du konfigurerat i ditt virtuella nätverk inte kan lösa ett angivet namn, kommer App Service-miljön v3 inte att försöka använda Azure DNS som reserv. För att säkerställa detta beteende bör du antingen ha en vidarebefordrare till en offentlig DNS inställd eller lägga till Azure DNS i din lista över anpassade DNS-servrar.

Migreringsfunktionen på plats stöder inte följande scenarier. Se alternativen för manuell migrering om din App Service-miljön ingår i någon av dessa kategorier.

  • App Service-miljön v1 i en Klassiskt virtuellt nätverk
  • ELB App Service-miljön v2 med IP SSL-adresser
  • ELB App Service-miljön v1 med IP SSL-adresser
  • App Service-miljön med ett namn som inte uppfyller teckengränserna. Hela namnet, inklusive domänsuffixet, måste vara 64 tecken eller färre. Till exempel: my-ase-name.appserviceenvironment.net för ILB och my-ase-name.p.azurewebsites.net för ELB måste vara 64 tecken eller färre. Om du inte uppfyller teckengränsen måste du migrera manuellt. Teckenbegränsningarna specifikt för App Service-miljön namn är följande:
    • ILB App Service-miljön namnteckengräns: 36 tecken
    • ELB App Service-miljön namnteckengräns: 42 tecken

App Service-plattformen granskar din App Service-miljön för att bekräfta stöd för migrering på plats. Om ditt scenario inte klarar alla valideringskontroller kan du inte migrera just nu med hjälp av migreringsfunktionen på plats. Om din miljö är i ett felfritt eller pausat tillstånd kan du inte migrera förrän du gör de nödvändiga uppdateringarna.

Kommentar

App Service-miljön v3 stöder inte IP SSL. Om du använder IP SSL måste du ta bort alla IP SSL-bindningar innan du migrerar till App Service-miljön v3. Migreringsfunktionen stöder din miljö när alla IP SSL-bindningar har tagits bort.

Felsökning

Om App Service-miljön inte klarar valideringskontrollerna eller om du försöker utföra ett migreringssteg i fel ordning kan du se något av följande felmeddelanden:

Felmeddelande beskrivning Rekommendation
Migrering kan bara anropas på en ASE i ARM VNET och denna ASE finns i klassiskt VNET. App Service-miljön i klassiska virtuella nätverk kan inte migreras med hjälp av migreringsfunktionen på plats. Migrera med något av alternativen för manuell migrering.
ASEv3-migreringen är ännu inte klar. Den underliggande infrastrukturen är inte redo att stödja App Service-miljön v3. Migrera med något av alternativen för manuell migrering om du vill migrera direkt. Annars väntar du på att migreringsfunktionen på plats ska vara tillgänglig i din region.
Migrering kan inte anropas på denna ASE. Kontakta supporten för hjälp med migrering. Stöd måste användas för att migrera den här App Service-miljön. Det här problemet kan bero på anpassade inställningar som används av den här miljön. Öppna ett supportärende för att kontakta supporten för att lösa problemet.
Migrering kan inte anropas om IP SSL är aktiverat på någon av platserna. App Service-miljön som har platser med IP SSL aktiverat kan inte migreras med hjälp av migreringsfunktionen. Ta bort IP SSL från alla dina appar i App Service-miljön för att aktivera migreringsfunktionen.
Fullständig migrering kan inte anropas innan IP-adresser genereras. Det här felet visas om du försöker migrera innan du slutför förmigreringsstegen. Se till att du slutför alla förmigreringssteg innan du försöker migrera. Se steg för steg-guiden för migrering.
Migrering till ASEv3 tillåts inte för denna ASE. Du kan inte migrera med hjälp av migreringsfunktionen. Migrera med något av alternativen för manuell migrering.
Prenumerationen har för många App Service-miljön. Ta bort några innan du försöker skapa mer. Den App Service-miljön kvoten för din prenumeration uppfylls. Ta bort onödiga miljöer eller kontakta supporten för att granska dina alternativ.
<ZoneRedundant><DedicatedHosts><ASEv3/ASE> är inte tillgängligt på den här platsen. Det här felet visas om du försöker migrera en App Service-miljön i en region som inte stöder någon av dina begärda funktioner. Migrera med något av alternativen för manuell migrering om du vill migrera direkt. Annars kan du vänta tills migreringsfunktionen har stöd för den här konfigurationen av App Service-miljön.
Migrering kan inte anropas på denna ASE förrän den aktiva uppgraderingen har slutförts. App Service-miljön kan inte migreras under plattformsuppgraderingar. Du kan ange uppgraderingsinställningar från Azure-portalen. Uppgraderingar tar 8–12 timmar eller längre beroende på storleken (antalet instanser/kärnor) för App Service-miljön. Vänta tills uppgraderingen är klar och migrera sedan.
App Service-miljön hanteringsåtgärd pågår. Din App Service-miljön genomgår en hanteringsåtgärd. Dessa åtgärder kan omfatta aktiviteter som distributioner eller uppgraderingar. Migreringen blockeras tills dessa åtgärder har slutförts. Du kan migrera när de här åtgärderna har slutförts.
Migrering är inte tillgängligt för den här prenumerationen. Stöd måste användas för att migrera den här App Service-miljön. Öppna ett supportärende för att kontakta supporten för att lösa problemet.
InteralLoadBalancingMode stöds inte för närvarande. App Service-miljön som har InternalLoadBalancingMode inställt på vissa värden kan inte migreras med hjälp av migreringsfunktionen just nu. InternalLoadBalancingMode måste ändras manuellt av Microsoft-teamet. Öppna ett supportärende för att kontakta supporten för att lösa problemet. Begär en uppdatering av InternalLoadBalancingMode för att tillåta migrering.

Översikt över migreringsprocessen med hjälp av migreringsfunktionen på plats

Migrering på plats består av en serie steg som måste följas i ordning. Viktiga punkter betonas för en delmängd av stegen. Det är viktigt att förstå processerna inom dessa steg samt hur de påverkar din omgivning och program. När du har granskat följande information och du är redo att migrera följer du den stegvisa guiden.

Kontrollera att migrering stöds med hjälp av migreringsfunktionen på plats för din App Service-miljön

Plattformen verifierar att din App Service-miljön kan migreras med hjälp av migreringsfunktionen på plats. Om din App Service-miljön inte klarar alla valideringskontroller kan du inte migrera just nu med hjälp av migreringsfunktionen på plats. Mer information om möjliga orsaker till valideringsfel finns i felsökningsavsnittet. Om din miljö är i ett felfritt eller pausat tillstånd kan du inte migrera förrän du gör de nödvändiga uppdateringarna. Om du inte kan migrera med hjälp av migreringsfunktionen på plats läser du alternativen för manuell migrering.

Valideringen kontrollerar också om din App Service-miljön är på den lägsta version som krävs för migrering. Den här versionen kan vara nyare än den standardversion som distribueras med den rutinmässiga plattformsuppgraderings-/underhållscykeln. Den minsta versionen uppdateras regelbundet för att säkerställa att de senaste felkorrigeringarna och förbättringarna är tillgängliga. Om din App Service-miljön inte är på lägsta version måste du starta uppgraderingen själv. Den här uppgraderingen är en standardprocess där din App Service-miljön inte påverkas, men du kan inte skala eller göra ändringar i App Service-miljön medan uppgraderingen pågår. Du kan inte migrera förrän uppgraderingen har slutförts. Uppgraderingar kan ta 8–12 timmar att slutföra eller längre beroende på miljöns storlek. Om du planerar ett visst tidsfönster för migreringen bör du köra verifieringskontrollen 24–48 timmar före den planerade migreringstiden för att säkerställa att du har tid för en uppgradering om det behövs.

Generera IP-adresser för din nya App Service-miljö v3

Plattformen skapar den nya inkommande IP-adressen (om du migrerar en ELB-App Service-miljön) och de nya utgående IP-adresserna. Under tiden som dessa IP-adresser skapas avbryts inga aktiviteter i din befintliga App Service-miljö, men det går inte att skala eller göra ändringar i den befintliga miljön. Den här processen tar cirka 15 minuter.

När du är klar får du de nya IP-adresser som den framtida App Service-miljön v3 använder. Dessa nya IP-adresser påverkar inte din befintliga miljö. IP-adresserna som används av din befintliga miljö fortsätter att användas tills den befintliga miljön stängs av under migreringssteget.

Uppdatera beroende resurser med nya IP-adresser

När de nya IP-adresserna har skapats har du den nya utgående standardinställningen till de offentliga Internetadresserna. Inför migreringen kan du justera eventuella externa brandväggar, DNS-routning, nätverkssäkerhetsgrupper och andra resurser som är beroende av dessa IP-adresser. För ELB-App Service-miljön har du även den nya inkommande IP-adressen som du kan använda för att konfigurera nya slutpunkter med tjänster som Traffic Manager eller Azure Front Door. Det är ditt ansvar att uppdatera alla resurser som påverkas av DEN IP-adressändring som är associerad med den nya App Service-miljön v3. Gå inte vidare till nästa steg förrän du har gjort alla nödvändiga uppdateringar. Det här steget är också ett bra tillfälle att granska ändringarna av inkommande och utgående nätverksberoende när du flyttar till App Service-miljön v3, inklusive portändringen för Azure Load Balancer-hälsoavsökningen, som nu använder port 80.

Delegera ditt App Service-miljön undernät

App Service-miljön v3 kräver att det undernät som det finns i har en enda delegering av Microsoft.Web/hostingEnvironments. Migreringen kan inte lyckas om App Service-miljön undernät inte delegeras eller om du delegerar det till en annan resurs.

Bekräfta ändringar i instansstorleken

Dina App Service-planer konverteras från Isolerad till motsvarande isolerad v2-nivå som en del av migreringen. Till exempel konverteras I2 till I2v2. Dina appar kan vara överetablerade efter migreringen eftersom nivån Isolerad v2 har mer minne och processor per motsvarande instansstorlek. Du har möjlighet att skala din miljö efter behov när migreringen är klar. Mer information finns i SKU-informationen.

Kontrollera att det inte finns några lås på dina resurser

Virtuellt nätverk låser blockplattformsåtgärder under migreringen. Om det virtuella nätverket har lås måste du ta bort dem innan du migrerar. Låsen kan läsas om det behövs när migreringen är klar. Lås kan finnas i tre olika omfång: prenumeration, resursgrupp och resurs. När du använder ett lås i ett överordnat omfång ärver alla resurser inom det omfånget samma lås. Om du har lås som tillämpas på prenumerationen, resursgruppen eller resursomfånget måste de tas bort före migreringen. Mer information om lås och lås arv finns i Lås dina resurser för att skydda infrastrukturen.

Se till att det inte finns några Azure-principer som blockerar migrering

Azure Policy kan användas för att neka resursskapande och ändring av vissa huvudkonton. Om du har en princip som blockerar skapandet av App Service-miljön eller ändring av undernät måste du ta bort den innan du migrerar. Principen kan läsas om det behövs när migreringen är klar. Mer information om Azure Policy finns i Översikt över Azure Policy.

Välj konfigurationer för din App Service-miljö v3

Din App Service-miljön v3 kan distribueras mellan tillgänglighetszoner i de regioner som stöder den. Den här arkitekturen kallas zonredundans. Zonredundans kan bara konfigureras när App Service-miljön skapas. Om du vill att din nya App Service-miljön v3 ska vara zonredundant aktiverar du konfigurationen under migreringsprocessen. Alla App Service-miljön som använder migreringsfunktionen på plats för att migrera kan konfigureras som zonredundant så länge du använder en region som stöder zonredundans för App Service-miljön v3. Om du är en befintlig miljö i en region som inte stöder zonredundans är konfigurationsalternativet inaktiverat och du kan inte konfigurera det. Migreringsfunktionen på plats stöder inte föränderliga regioner. Om du vill använda en annan region använder du något av alternativen för manuell migrering.

Kommentar

Aktivering av zonredundans kan leda till ytterligare avgifter. Mer information finns i prismodellen för zonredundans.

Om din befintliga App Service-miljön använder ett anpassat domänsuffix uppmanas du att konfigurera ett anpassat domänsuffix för din nya App Service-miljön v3. Du måste ange det anpassade domännamnet, den hanterade identiteten och certifikatet. Mer information om App Service-miljön suffix för anpassad v3-domän, inklusive krav, stegvisa instruktioner och metodtips finns i Konfigurera anpassat domänsuffix för App Service-miljön. Du måste konfigurera ett anpassat domänsuffix för den nya miljön även om du inte längre vill använda den. När migreringen är klar kan du ta bort suffixkonfigurationen för anpassad domän om det behövs.

Om din migrering innehåller ett anpassat domänsuffix för App Service-miljön v3 visas inte den anpassade domänen i avsnittet Essentials på sidan Översikt i portalen som den är för App Service-miljön v1/v2. För App Service-miljön v3 går du i stället till sidan Suffix för anpassad domän där du kan bekräfta att ditt anpassade domänsuffix har konfigurerats korrekt. På App Service-miljön v2, om du har ett anpassat domänsuffix, innehåller standardvärdnamnet ditt anpassade domänsuffix och finns i formuläret APP-NAME.internal.contoso.com. På App Service-miljön v3 använder standardvärdnamnet alltid standarddomänsuffixet och är i formuläret APP-NAME.ASE-NAME.appserviceenvironment.net. Den här skillnaden beror på att App Service-miljön v3 behåller standarddomänsuffixet när du lägger till ett anpassat domänsuffix. Med App Service-miljön v2 finns det bara ett enda domänsuffix.

Migrering till App Service-miljö v3

När du har slutfört föregående steg fortsätter du med migreringen så snart som möjligt.

Viktigt!

Eftersom skalning blockeras under migreringen bör du skala din miljö till önskad storlek innan du påbörjar migreringen. Om du har aktiverat automatisk skalning måste du vänta tills skalningshändelsen har slutförts innan du påbörjar migreringen om en skalningshändelse inträffar innan migreringen påbörjas. Du bör inaktivera automatisk skalning innan du påbörjar migreringen för att undvika det här problemet. Om du behöver skala din miljö efter migreringen kan du göra det när migreringen är klar.

Migrering kräver ett tjänstfönster på tre till sex timmar för App Service-miljön v2 till v3-migreringar. Ett servicefönster på upp till sex timmar krävs beroende på miljöns storlek för v1 till v3-migreringar. Tjänstfönstret kan utökas i sällsynta fall där manuella åtgärder krävs av tjänstteamet. Under migreringen blockeras skalnings- och miljökonfigurationer och följande händelser inträffar:

  • Den befintliga App Service-miljön stängs av och ersätts av den nya App Service-miljön v3.
  • Alla App Service-planer i App Service-miljön konverteras från nivån Isolerad till Isolerad v2.
  • Alla appar som finns på din App Service-miljön är tillfälligt ur funktion. Du bör förvänta dig ungefär en timmes stilleståndstid under den här perioden.
    • Om du inte kan stödja stilleståndstid kan du se migreringsfunktionen sida vid sida eller migreringsalternativen.
  • De offentliga adresser som används av App Service-miljön ändras till IP-adresser som genererades under IP-genereringssteget.

Följande statusar är tillgängliga under migreringsprocessen:

Status beskrivning
Validera och förbereda migreringen. Plattformen validerar migreringsstöd och utför nödvändiga kontroller.
Distribuera App Service-miljön v3-infrastruktur. Din nya App Service-miljön v3-infrastruktur etableras.
Väntar på att infrastrukturen ska slutföras. Plattformen verifierar din nya infrastruktur och utför nödvändiga kontroller.
Konfigurera nätverk. Migreringsavbrottsperioden har startat. Program är inte tillgängliga. Plattformen tar bort din gamla infrastruktur och flyttar alla dina appar till din nya App Service-miljön v3. Dina appar är nere och accepterar inte trafik.
Kör valideringar efter migrering. Plattformen utför nödvändiga kontroller för att säkerställa att migreringen lyckades.
Slutför migreringen. Plattformen slutför migreringen.

Precis som i IP-genereringssteget kan du inte skala, ändra App Service-miljön eller distribuera appar till den under processen. När migreringen är klar körs apparna som fanns i den gamla App Service-miljön i den nya App Service-miljön v3.

Använda migreringsfunktionen på plats

Förutsättningar

Se till att du förstår hur migrering till App Service-miljön v3 påverkar dina program. Granska migreringsprocessen för att förstå processtidslinjen och var och när du behöver engagera dig. Läs även vanliga frågor och svar, som kan besvara några av dina frågor.

Se till att det inte finns några lås på ditt virtuella nätverk, resursgrupp, resurs eller prenumeration. Låser blockplattformsåtgärder under migreringen.

Se till att inga Azure-principer blockerar åtgärder som krävs för migreringen, inklusive ändringar i undernätet och skapande av Azure App Service-resurser. Principer som blockerar resursändringar och skapanden kan orsaka att migreringen fastnar eller misslyckas.

Eftersom skalning blockeras under migreringen bör du skala din miljö till önskad storlek innan du påbörjar migreringen. Om du behöver skala din miljö efter migreringen kan du göra det när migreringen är klar. Om du har aktiverat automatisk skalning blockeras migreringen tills skalningshändelsen har slutförts om en skalningshändelse inträffar innan migreringen startar. Du bör inaktivera automatisk skalning innan du påbörjar migreringen för att undvika det här problemet.

Vi rekommenderar att du använder Azure Portal för migrering på plats. Om du bestämmer dig för att använda Azure CLI för migreringen följer du stegen som beskrivs här i ordning och som skrivs eftersom du gör Azure REST API-anrop. Vi rekommenderar att du använder Azure CLI för att göra dessa API-anrop. Information om andra metoder finns i Azure REST API-referens.

I den här guiden installerar du Azure CLI eller använder Azure Cloud Shell och använder ett Bash-gränssnitt.

Kommentar

Vi rekommenderar att du använder ett Bash-gränssnitt för att köra kommandona som anges i den här guiden. Kommandona kanske inte är kompatibla med PowerShell-konventioner och escape-tecken.

1. Hämta ditt App Service-miljön-ID

Kör följande kommandon för att hämta ditt App Service-miljön-ID och lagra det som en miljövariabel. Ersätt platshållarna för namnet och resursgrupperna med dina värden för den App Service-miljön som du vill migrera. ASE_RGoch VNET_RG är samma om ditt virtuella nätverk och App Service-miljön finns i samma resursgrupp.

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. Kontrollera att migrering stöds

Följande kommando kontrollerar om din App Service-miljön stöds för migrering och verifierar att din App Service-miljön finns på den version som stöds för migrering.

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

Om det inte finns några fel stöds migreringen och du kan fortsätta till nästa steg.

Om du behöver starta en uppgradering för att uppgradera din App Service-miljön till den version som stöds kör du följande kommando. Kör bara det här kommandot om du misslyckas med valideringssteget och du uppmanas att uppgradera din App Service-miljön.

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

3. Generera IP-adresser för din nya App Service-miljön v3-resurs

Kör följande kommando för att skapa nya IP-adresser. Det här steget tar cirka 15 minuter att slutföra. Skala inte eller gör ändringar i din befintliga App Service-miljön under den här tiden.

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

Kör följande kommando för att kontrollera statusen för det här steget:

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

Om steget pågår får du statusen Migrating. När du har fått statusen Readykör du följande kommando för att visa dina nya IP-adresser. Om du inte ser de nya IP-adresserna omedelbart väntar du några minuter och försöker igen.

az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"

4. Uppdatera beroende resurser med nya IP-adresser

Genom att använda de nya IP-adresserna uppdaterar du någon av dina resurser eller nätverkskomponenter för att säkerställa att den nya miljön fungerar som den är avsedd när migreringen är klar. Det är ditt ansvar att göra nödvändiga uppdateringar.

5. Delegera ditt App Service-miljön undernät

App Service-miljön v3 kräver att det undernät som det finns i har en enda delegering av Microsoft.Web/hostingEnvironments. Tidigare versioner krävde inte den här delegeringen. Du måste bekräfta att ditt undernät har delegerats korrekt och uppdatera delegeringen (om det behövs) innan du migrerar. Du kan uppdatera delegeringen antingen genom att köra följande kommando eller genom att gå till undernätet i Azure Portal.

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

6. Bekräfta att det inte finns några lås i det virtuella nätverket

Virtuellt nätverk låser blockplattformsåtgärder under migreringen. Om det virtuella nätverket har lås måste du ta bort dem innan du migrerar. Om det behövs kan du lägga till låsen igen när migreringen är klar.

Använd följande kommando för att kontrollera om det virtuella nätverket har några lås:

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

Ta bort alla befintliga lås med hjälp av följande kommando:

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

Relaterade kommandon för att kontrollera om din prenumeration eller resursgrupp har lås finns i Azure CLI-referensen för lås.

7. Förbered dina konfigurationer

Du kan göra din nya App Service-miljön v3-resurszon redundant om din befintliga miljö finns i en region som stöder zonredundans. Du kan konfigurera zonredundans genom att ange zoneRedundant egenskapen till true.

Om din befintliga App Service-miljön använder ett anpassat domänsuffix måste du konfigurera ett för din nya App Service-miljön v3-resurs under migreringsprocessen. Migreringen misslyckas om du inte konfigurerar ett anpassat domänsuffix och använder ett för närvarande. Migreringen misslyckas också om du försöker lägga till ett anpassat domänsuffix under migreringen till en miljö som inte har något konfigurerat. Mer information om App Service-miljön anpassade v3-domänsuffix, inklusive krav, stegvisa instruktioner och metodtips finns i Suffix för anpassad domän för App Service-miljön.

Kommentar

Om du konfigurerar ett anpassat domänsuffix bör du när du lägger till nätverksbehörigheterna i ditt Azure-nyckelvalv se till att ditt nyckelvalv tillåter åtkomst från din App Service-miljön nya utgående IP-adresser som genererades i steg 3. Om du kommer åt ditt nyckelvalv med hjälp av en privat slutpunkt kontrollerar du att du har konfigurerat privat åtkomst korrekt.

Om migreringen inte innehåller ett anpassat domänsuffix och du inte aktiverar zonredundans kan du gå vidare till migrering.

Om du vill ange dessa konfigurationer skapar du en fil med namnet parameters.json med följande information baserat på ditt scenario. Inkludera inte egenskaperna för ett anpassat domänsuffix om den här funktionen inte gäller för migreringen. Var uppmärksam på värdet för zoneRedundant egenskapen eftersom den här konfigurationen inte kan ångras efter migreringen. Ange värdet för kind egenskapen baserat på din befintliga App Service-miljön version. Godkända värden för egenskapen kind är ASEV1 och ASEV2.

Om du migrerar utan ett anpassat domänsuffix och aktiverar zonredundans använder du den här koden:

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

Om du använder en användartilldelad hanterad identitet för konfigurationen av ditt anpassade domänsuffix och aktiverar zonredundans använder du den här koden:

{
    "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"
        }
    }
}

Om du använder en systemtilldelad hanterad identitet för konfigurationen av ditt anpassade domänsuffix och inte aktiverar zonredundans använder du den här koden:

{
    "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. Migrera till App Service-miljön v3 och kontrollera status

När du har slutfört alla föregående steg kan du starta migreringen. Se till att du förstår konsekvenserna av migreringen.

Det här steget tar tre till sex timmar för v2 till v3-migreringar och upp till sex timmar för v1 till v3-migreringar, beroende på miljöns storlek. Under den tiden är det ungefär en timmes programavbrott. Skalning, distributioner och ändringar av dina befintliga App Service-miljön blockeras under det här steget.

Inkludera parametern body i följande kommando om du aktiverar zonredundans och/eller konfigurerar ett anpassat domänsuffix. Om ingen av dessa konfigurationer gäller för migreringen kan du ta bort parametern från kommandot .

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

Kör följande kommandon för att kontrollera den detaljerade statusen för migreringen. Information om statusarna finns i beskrivningarna av migreringsstatus.

Det första kommandot hämtar åtgärds-ID:t för migreringen. Kopiera värdet för ID egenskapen.

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

Ersätt platshållaren för åtgärds-ID:t i följande kommando med det värde som du kopierade. Det här kommandot returnerar den detaljerade statusen för migreringen. Du kan köra det här kommandot så ofta som behövs för att få den senaste statusen.

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

När du har fått statusen Readyär migreringen klar och du har en App Service-miljön v3-resurs. Dina appar körs nu i den nya miljön.

Hämta information om din nya miljö genom att köra följande kommando eller genom att gå till Azure Portal.

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

1. Kontrollera att migrering stöds

I Azure Portal går du till sidan Migrering för App Service-miljön som du migrerar. Du kan komma till sidan Migrering genom att välja banderollen överst på översiktssidan för din App Service-miljön eller genom att välja migreringsobjektet på den vänstra menyn.

Skärmbild som visar åtkomstpunkter för migrering.

Välj migreringsalternativet "På plats" för att starta migreringsprocessen på plats. Om du väljer alternativet för migrering sida vid sida tas du till dokumentationen för migreringsprocessen. Välj inte alternativet sida vid sida-migrering om du vill använda migreringsfunktionen på plats.

Skärmbild som visar tabellen med migreringsalternativen.

På sidan Migrering verifierar plattformen om migrering stöds för din App Service-miljön. Välj Verifiera och bekräfta sedan att du vill fortsätta med valideringen. Valideringsprocessen tar några sekunder.

Skärmbild som visar knappen för att verifiera migreringsberättigande.

Om din miljö inte stöds för migrering visas en banderoll överst på sidan och innehåller ett felmeddelande med en orsak. Beskrivningar av de felmeddelanden som kan visas om du inte är berättigad till migrering finns i Felsökning.

Skärmbild som visar ett exempel på ett portalmeddelande som säger att migreringsfunktionen inte stöder App Service-miljön.

Om du behöver starta en uppgradering för att uppgradera din App Service-miljön till den version som stöds uppmanas du att starta uppgraderingen, vilket kan ta 8–12 timmar eller längre beroende på miljöns storlek. Välj Uppgradera för att starta uppgraderingen. När uppgraderingen är klar klarar du valideringen och kan använda migreringsfunktionen för att starta migreringen.

Om migrering stöds för din App Service-miljön går du vidare till nästa steg i processen. Sidan Migrering vägleder dig genom en serie steg för att slutföra migreringen.

Skärmbild som visar en exempelmigreringssida med oavslutade steg i processen.

2. Generera IP-adresser för din nya App Service-miljön v3-resurs

Under Hämta nya IP-adresser bekräftar du att du förstår konsekvenserna och väljer knappen Starta . Det här steget tar cirka 15 minuter att slutföra. Du kan inte skala eller göra ändringar i din befintliga App Service-miljön under den här tiden.

3. Uppdatera beroende resurser med nya IP-adresser

När föregående steg är klart visas IP-adresserna för din nya App Service-miljön v3-resurs. Använd de nya IP-adresserna för att uppdatera resurser och nätverkskomponenter så att din nya miljö fungerar som den ska när migreringen är klar. Det är ditt ansvar att göra nödvändiga uppdateringar.

Skärmbild som visar exempel-IP-adresser som genererades under förinvandringen.

4. Delegera ditt App Service-miljön undernät

App Service-miljön v3 kräver att det undernät som det är i har en enda delegering av Microsoft.Web/hostingEnvironments. Tidigare versioner krävde inte den här delegeringen. Du måste bekräfta att ditt undernät har delegerats korrekt och uppdatera delegeringen (om det behövs) innan du migrerar. Portalen visar en länk till ditt undernät så att du kan bekräfta och uppdatera efter behov.

Skärmbild som visar delegering av undernät i portalen.

5. Bekräfta ändringar i instansstorleken

Välj knappen Bekräfta för att bekräfta att du förstår att dina App Service-planer konverteras från den isolerade nivån till motsvarande isolerad v2-nivå som en del av migreringen.

Skärmbild som visar bekräftelse av att instansstorleken ändras vid migrering.

6. Bekräfta att det virtuella nätverket inte har några lås

Virtuellt nätverk låser blockplattformsåtgärder under migreringen. Om det virtuella nätverket har lås måste du ta bort dem innan du migrerar. Mer information om hur du kontrollerar om din prenumeration eller resursgrupp har lås finns i Konfigurera lås.

Skärmbild som visar var du hittar och tar bort lås för virtuella nätverk.

7. Välj dina konfigurationer

Du kan göra din nya App Service-miljön v3-resurszon redundant om din befintliga miljö finns i en region som stöder zonredundans.

Markera kryssrutan Aktiverad om du vill konfigurera zonredundans.

Skärmbild som visar kryssrutan för att aktivera zonredundans för en App Service-miljön i en region som stöds.

Om din miljö finns i en region som inte stöder zonredundans är kryssrutan inte tillgänglig. Om du behöver en zonredundant App Service-miljön v3-resurs använder du något av de manuella migreringsalternativen och skapar resursen i en av de regioner som stöder zonredundans.

Om din befintliga App Service-miljön använder ett anpassat domänsuffix måste du konfigurera ett för din nya App Service-miljön v3-resurs. Konfigurationsalternativen för ett anpassat domänsuffix visas om den här situationen gäller för dig. Du kan inte migrera förrän du har angett nödvändig information.

Om du vill använda ett anpassat domänsuffix men för närvarande inte har något konfigurerat kan du konfigurera ett när migreringen är klar. Mer information om App Service-miljön anpassade v3-domänsuffix, inklusive krav, stegvisa instruktioner och metodtips finns i Suffix för anpassad domän för App Service-miljön.

Kommentar

Om du konfigurerar ett anpassat domänsuffix bör du när du lägger till nätverksbehörigheterna i ditt Azure-nyckelvalv se till att nyckelvalvet tillåter åtkomst från App Service-miljön nya utgående IP-adresser som genererades i steg 2. Om du kommer åt ditt nyckelvalv med hjälp av en privat slutpunkt kontrollerar du att du har konfigurerat privat åtkomst korrekt.

Skärmbild som visar länken för att lägga till ett anpassat domänsuffix.

När du har lagt till information för ditt anpassade domänsuffix är knappen Migrera tillgänglig.

Skärmbild som visar att konfigurationsinformationen läggs till och att miljön är redo för migrering.

8. Migrera till App Service-miljön v3

När du har slutfört alla föregående steg kan du starta migreringen. Se till att du förstår konsekvenserna av migreringen, inklusive vad som händer under den här tiden.

Det här steget tar tre till sex timmar för v2 till v3-migreringar och upp till sex timmar för v1 till v3-migreringar, beroende på miljöns storlek. Skalning och ändringar av dina befintliga App Service-miljön blockeras under det här steget.

Kommentar

I sällsynta fall kan du se ett meddelande i portalen som säger "Migrering till App Service-miljön v3 misslyckades" när du har startat migreringen. Det finns en känd bugg som kan utlösa det här meddelandet även om migreringen pågår. Kontrollera aktivitetsloggen för App Service-miljön för att fastställa giltigheten för det här felmeddelandet. I de flesta fall löser uppdatering av sidan problemet och felmeddelandet försvinner. Kontakta supporten om felmeddelandet kvarstår.

Skärmbild som visar det potentiella felmeddelandet när migreringen startar.

För närvarande är detaljerade migreringsstatusar endast tillgängliga när du använder Azure CLI. Mer information finns i avsnittet Azure CLI för migrering till App Service-miljön v3. Du kan kontrollera statusen för migreringen med CLI även om du använder portalen för att utföra migreringen.

När migreringen är klar har du en App Service-miljön v3-resurs och alla dina appar körs i den nya miljön. Du kan bekräfta miljöns version genom att kontrollera konfigurationssidan för din App Service-miljön.

Om din migrering innehåller ett anpassat domänsuffix visas domänen i avsnittet Essentials på sidan Översikt i portalen för App Service-miljön v1/v2, men den visas inte längre där i App Service-miljön v3. För App Service-miljön v3 går du i stället till sidan Suffix för anpassad domän för att bekräfta att ditt anpassade domänsuffix har konfigurerats korrekt. Du kan också ta bort konfigurationen om du inte längre behöver den eller konfigurera en om du inte hade någon tidigare.

Skärmbild som visar sidan för konfiguration av anpassat domänsuffix för App Service-miljön v3.

Kommentar

Om din migrering innehåller ett anpassat domänsuffix kan din anpassade domänsuffixkonfiguration visas som degraderad när migreringen är klar på grund av en känd bugg. Din App Service-miljön bör fortfarande fungera som förväntat. Den degraderade statusen bör matcha sig själv inom 6–8 timmar. Om konfigurationen har degraderats efter 8 timmar eller om ditt anpassade domänsuffix inte fungerar kontaktar du supporten.

Skärmbild av en exempelkonfiguration med degraderat anpassat domänsuffix.

Prissättning

Det kostar ingenting att migrera App Service-miljön. När du använder migreringsfunktionen på plats slutar du att debiteras för din tidigare App Service-miljön så snart den stängs av under migreringsprocessen. Du börjar debiteras för din nya App Service-miljön v3 så snart den distribueras. För mer information om priser för App Service Environment v3, se Information om priser.

När du migrerar till App Service-miljön v3 från tidigare versioner finns det scenarier som du bör överväga som potentiellt kan minska din månadskostnad. Överväg reservationer och sparplaner för att ytterligare minska dina kostnader. Information om kostnadsbesparingsmöjligheter finns i Kostnadsbesparande affärsmöjligheter efter uppgradering till App Service-miljön v3.

Kommentar

På grund av konverteringen av App Service-planer från Isolerad till Isolerad v2 kan dina appar vara överetablerade efter migreringen eftersom nivån Isolerad v2 har mer minne och processor per motsvarande instansstorlek. Du har möjlighet att skala din miljö efter behov när migreringen är klar. Mer information finns i SKU-informationen.

Skala ned dina App Service-planer

App Service-plan-SKU:er som är tillgängliga för App Service-miljön v3 körs på nivån Isolerad v2 (Iv2). Antalet kärnor och mängden RAM-minne fördubblas effektivt per motsvarande nivå jämfört med den isolerade nivån. När du migrerar konverteras dina App Service-planer till motsvarande nivå. Dina I2-instanser konverteras till exempel till I2v2. Medan I2 har två kärnor och 7 GB RAM har I2v2 fyra kärnor och 16 GB RAM-minne. Om du förväntar dig att dina kapacitetskrav förblir desamma är du överetablerad och betalar för beräkning och minne som du inte använder. I det här scenariot kan du skala ned din I2v2-instans till I1v2 och sluta med ett liknande antal kärnor och RAM-minne som du hade tidigare.

Vanliga frågor och svar

  • Vad händer om migrering av min App Service-miljön inte stöds för närvarande?
    Du kan inte migrera med hjälp av migreringsfunktionen på plats just nu. Om du har en miljö som inte stöds och vill migrera omedelbart kan du läsa alternativen för manuell migrering.
  • Hur gör jag för att välja vilket migreringsalternativ som passar mig bäst?
    Granska beslutsträdet för migreringssökvägen för att avgöra vilket alternativ som är bäst för ditt användningsfall.
  • Hur gör jag för att vet om jag ska använda migreringsfunktionen på plats?
    Migreringsfunktionen på plats passar bäst för kunder som vill migrera till App Service-miljön v3 med minimala ändringar i sina nätverkskonfigurationer och som har stöd för ungefär en timmes programavbrott. Om du inte har stöd för stilleståndstid kan du läsa sidans migreringsfunktion eller alternativen för manuell migrering. Migreringsfunktionen på plats skapar din App Service-miljön v3 i samma undernät som din befintliga miljö och använder samma nätverksinfrastruktur. Du kan behöva ta hänsyn till de inkommande och utgående IP-adressändringarna om du har några beroenden för dessa specifika IP-adresser.
  • Kommer det att uppstå avbrott under migreringen?
    Ja, du bör förvänta dig ungefär en timmes stilleståndstid under tjänstfönstret på tre till sex timmar under migreringssteget, så planera därefter. Om du har en annan App Service-miljön som du kan peka trafik till när du migrerar med hjälp av migreringsfunktionen på plats kan du eliminera programavbrott. Om du inte har någon annan App Service-miljön och du inte kan stödja stilleståndstid kan du se migreringsfunktionen sida vid sida eller alternativen för manuell migrering.
  • Kommer jag att behöva göra något med mina appar efter migreringen för att få dem att köras på den nya App Service-miljön?
    Nej, alla dina appar som körs i den gamla miljön migreras automatiskt till den nya miljön och kan köras som tidigare. Inga användarindata behövs.
  • Vad händer om App Service-miljön har ett anpassat domänsuffix?
    Migreringsfunktionen på plats stöder det här migreringsscenariot.
  • Vad händer om min App Service-miljön är zonfäst?
    Zonfäst App Service-miljön v2 är nu ett scenario som stöds för migrering med hjälp av migreringsfunktionen. App Service-miljön v3 stöder inte zonanvändning. När du migrerar till App Service-miljön v3 kan du välja att konfigurera zonredundans eller inte.
  • Vad händer om min App Service-miljön har IP SSL-adresser? IP SSL stöds inte på App Service-miljön v3. Du måste ta bort alla IP SSL-bindningar innan du migrerar med hjälp av migreringsfunktionen eller något av de manuella alternativen. Om du tänker använda migreringsfunktionen på plats, när du tar bort alla IP SSL-bindningar, klarar du verifieringskontrollen och kan fortsätta med den automatiserade migreringen.
  • Vilka egenskaper för min App Service-miljön ändras?
    Du är på App Service-miljön v3 så se till att granska funktionerna och funktionsskillnaderna jämfört med tidigare versioner. För ILB-App Service-miljön behåller du samma ILB-IP-adress. För internetuppkopplade App Service-miljöer ändras den offentliga IP-adressen och den utgående IP-adressen. Obs! För ELB-App Service-miljöer fanns det tidigare en enda IP-adress som användes som både inkommande och utgående. För App Service-miljön v3 används separata adresser. Mer information finns i Nätverk för App Service-miljö V3. En fullständig jämförelse av olika versioner av App Service-miljön finns i Versionsjämförelse för App Service-miljön.
  • Vad händer om migreringen misslyckas eller om det uppstår ett oväntat problem under migreringen?
    Om det uppstår ett oväntat problem finns supportteam på plats. Du bör migrera utvecklingsmiljöer innan du rör vid produktionsmiljöer för att lära dig mer om migreringsprocessen och se hur den påverkar dina arbetsbelastningar.
  • Vad händer med min gamla App Service-miljön?
    Om du bestämmer dig för att migrera en App Service-miljön med hjälp av migreringsfunktionen på plats, stängs den gamla miljön av, tas bort och alla dina appar migreras till en ny miljö. Din gamla miljö är inte längre tillgänglig. Det går inte att återställa till den gamla miljön.
  • Vad händer med resurser i App Service-miljön v1/v2 efter den 31 augusti 2024?
    Om du inte vill App Service-miljön v3 efter den 31 augusti 2024 är dina App Service-miljön v1/v2s och apparna som distribueras i dem inte längre tillgängliga. App Service-miljön v1/v2 finns på App Service-skalningsenheter som körs på Cloud Services-arkitektur (klassisk) som kommer att tas ur bruk den 31 augusti 2024. Därför kommer App Service-miljön v1/v2 inte längre vara tillgänglig efter det datumet. För att säkerställa att dina appar fortsätter att fungera, bör du migrera till App Service-miljön v3. Se även till att spara eller ta säkerhetskopior av resurser och data som du vill bevara.

Nästa steg

App Service-miljön v3-nätverk

Använda en App Service-miljön v3

Suffix för anpassad domän