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

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.

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.

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.

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:

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

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.

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:

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.

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)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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