Migrace do služby App Service Environment v3 s využitím funkce místní migrace
Poznámka:
Funkce migrace popsaná v tomto článku se používá pro místní (stejnou podsíť) automatizovanou migraci služby App Service Environment v1 a v2 do služby App Service Environment v3. Pokud jste nepožadovali 30denní období odkladu, projděte si přehled období odkladu a pak požádejte o období odkladu tak, že přejdete na web Azure Portal a přejdete do okna Migrace pro každou službu App Service Environment.
Pokud hledáte informace o funkci souběžné migrace, přečtěte si téma Migrace do služby App Service Environment v3 pomocí funkce souběžné migrace. Pokud hledáte informace o možnostech ruční migrace, přečtěte si téma Možnosti ruční migrace. Nápovědu k rozhodování o tom, která možnost migrace je pro vás nejvhodnější, najdete v rozhodovacím stromu cesty migrace. Další informace o službě App Service Environment v3 najdete v přehledu služby App Service Environment v3.
App Service dokáže automatizovat migraci služby App Service Environment verze 1 a v2 do služby App Service Environment v3. Existují různé možnosti migrace. Zkontrolujte rozhodovací strom cesty migrace a rozhodněte se, která možnost je pro váš případ použití nejvhodnější. App Service Environment v3 poskytuje výhody a rozdíly mezi funkcemi oproti dřívějším verzím. Před migrací nezapomeňte zkontrolovat podporované funkce služby App Service Environment v3, abyste snížili riziko neočekávaného problému s aplikací.
Funkce místní migrace automatizuje migraci do služby App Service Environment v3 upgradem existujícího prostředí App Service Environment ve stejné podsíti. Tato možnost migrace je nejvhodnější pro zákazníky, kteří chtějí migrovat do služby App Service Environment v3 s minimálními změnami konfigurace sítě. Musíte být také schopni podporovat přibližně jednu hodinu výpadku aplikace. Pokud nemůžete podporovat výpadek, podívejte se na funkci migrace na straně nebo možnosti ruční migrace.
Důležité
Před migrací produkčních prostředí doporučujeme tuto funkci nejprve použít pro vývojová prostředí, aby se zajistilo, že nedojde k neočekávaným problémům. Pomocí tlačítek v dolní části stránky uveďte zpětnou vazbu související s tímto článkem nebo funkcí.
Podporované scénáře
V tuto chvíli místní funkce migrace nepodporuje migrace do služby App Service Environment v3 v následujících oblastech:
Platforma Microsoft Azure provozovaná společností 21Vianet
- Čína – východ 2
- Čína – sever 2
Následující konfigurace služby App Service Environment je možné migrovat pomocí místní funkce migrace. Tabulka poskytuje konfiguraci služby App Service Environment v3 při použití místní funkce migrace na základě existující služby App Service Environment. Všechna podporovaná prostředí App Service Environment je možné migrovat do zónově redundantního prostředí App Service Environment v3 s využitím funkce místní migrace, pokud je prostředí v oblasti, která podporuje redundanci zón. Během procesu migrace můžete nakonfigurovat redundanci zón.
| Konfigurace | Konfigurace služby App Service Environment v3 |
|---|---|
| Interní nástroj pro vyrovnávání zatížení (ILB) App Service Environment v2 | App Service Environment v3 s interním nástrojem pro vyrovnávání zatížení |
| Externí (ELB/internet s veřejnou IP adresou) App Service Environment v2 | ELB App Service Environment v3 |
| ILB App Service Environment v2 s příponou vlastní domény | ILB App Service Environment v3 s příponou vlastní domény |
| App Service Environment v1 s interním nástrojem pro vyrovnávání zatížení | App Service Environment v3 s interním nástrojem pro vyrovnávání zatížení |
| ELB App Service Environment v1 | ELB App Service Environment v3 |
| ILB App Service Environment v1 s příponou vlastní domény | ILB App Service Environment v3 s příponou vlastní domény |
| Zone pinned App Service Environment v2 | App Service Environment v3 s volitelnou konfigurací redundance zón |
Pokud chcete, aby vaše nová služba App Service Environment v3 používala vlastní příponu domény a v současné době ji nepoužíváte, můžete po dokončení migrace kdykoli nakonfigurovat vlastní příponu domény. Další informace najdete v tématu Konfigurace přípony vlastní domény pro App Service Environment.
Verzi služby App Service Environment najdete tak, že přejdete do služby App Service Environment na webu Azure Portal a v části Nastavení na levé straně vyberete Možnost Konfigurace. Můžete také použít Azure Resource Explorer a zkontrolovat hodnotu kind vlastnosti služby App Service Environment.
Omezení funkcí místní migrace
Při používání místní funkce migrace platí následující omezení:
- Vaše nové prostředí App Service Environment v3 se nachází ve stávající podsíti, která byla použita pro staré prostředí.
- Oblast, ve které se nachází prostředí App Service Environment, nemůžete změnit.
- ElB App Service Environment nejde migrovat do služby App Service Environment s interním nástrojem pro vyrovnávání zatížení verze 3 a naopak.
- Pokud vaše stávající prostředí App Service Environment používá příponu vlastní domény, musíte během procesu migrace nakonfigurovat příponu vlastní domény pro prostředí App Service Environment v3.
- Pokud již nechcete používat vlastní příponu domény, můžete ji po dokončení migrace odebrat.
App Service Environment v3 nepodporuje následující funkce, které můžete použít s aktuální službou App Service Environment v1 nebo v2.
- Konfigurace vazby TLS/SSL založené na protokolu IP s aplikacemi.
- Pokud vaše nakonfigurované vlastní servery DNS ve virtuální síti nemůžou přeložit daný název, prostředí App Service Environment v3 se nevrátí do Azure DNS. Pokud je toto chování potřeba, ujistěte se, že máte předávací modul na veřejnou DNS nebo zahrňte Azure DNS do seznamu vlastních serverů DNS.
Funkce místní migrace nepodporuje následující scénáře. Pokud vaše služba App Service Environment spadá do jedné z těchto kategorií, podívejte se na možnosti ruční migrace.
- App Service Environment v1 ve virtuální síti Classic
- ELB App Service Environment v2 s adresami IP SSL
- ELB App Service Environment v1 s adresami IP SSL
- App Service Environment s názvem, který nesplňuje omezení znaků. Celý název, včetně přípony domény, musí být 64 znaků nebo méně. Například: my-ase-name.appserviceenvironment.net pro interní vyrovnávání zatížení a my-ase-name.p.azurewebsites.net pro ELB musí být 64 znaků nebo méně. Pokud limit znaků nesplňujete, musíte provést migraci ručně. Omezení znaků speciálně pro název služby App Service Environment jsou následující:
- Limit znaků názvu služby App Service Environment s interním nástrojem pro vyrovnávání zatížení: 36 znaků
- Limit znaků názvu prostředí App Service Environment ELB: 42 znaků
Platforma App Service zkontroluje vaši službu App Service Environment a potvrdí podporu místní migrace. Pokud váš scénář neprojde všemi kontrolami ověření, nemůžete v tuto chvíli migrovat pomocí funkce místní migrace. Pokud je vaše prostředí ve špatném nebo pozastaveném stavu, nemůžete migrovat, dokud neprovádíte potřebné aktualizace.
Poznámka:
App Service Environment v3 nepodporuje PROTOKOL SSL protokolu IP. Pokud používáte PROTOKOL SSL protokolu IP, musíte před migrací do služby App Service Environment v3 odebrat všechny vazby PROTOKOLU IP SSL. Funkce migrace bude podporovat vaše prostředí, jakmile se odeberou všechny vazby SSL PROTOKOLU IP.
Řešení problému
Pokud vaše služba App Service Environment neprojde ověřovacími kontrolami nebo se pokusíte provést krok migrace v nesprávném pořadí, zobrazí se jedna z následujících chybových zpráv:
| Chybová zpráva | Popis | Doporučení |
|---|---|---|
| Migraci je možné volat pouze ve virtuální síti ASE ve virtuální síti ARM a tato funkce ASE je v klasické virtuální síti. | Služba App Service Environment ve virtuálních sítích Classic se nedá migrovat pomocí místní funkce migrace. | Migrujte pomocí jedné z možností ruční migrace. |
| Migrace ASEv3 ještě není připravená. | Základní infrastruktura není připravená k podpoře služby App Service Environment v3. | Pokud chcete migrovat okamžitě, proveďte migraci pomocí jedné z možností ruční migrace. Jinak počkejte, až bude funkce místní migrace dostupná ve vaší oblasti. |
| K této službě ASE nelze volat migraci. Pokud potřebujete pomoc s migrací, obraťte se na podporu. | Pro migraci této služby App Service Environment je potřeba zapojit podporu. Tento problém může být způsobený vlastními nastaveními používanými tímto prostředím. | Otevřete případ podpory a obraťte se na podporu pro vyřešení vašeho problému. |
| Migrace se nedá volat, pokud je na některé lokalitě povolený PROTOKOL SSL protokolu IP. | Služba App Service Environment s povoleným protokolem IP SSL nejde migrovat pomocí funkce migrace. | Odeberte PROTOKOL SSL PROTOKOLU IP ze všech vašich aplikací ve službě App Service Environment a povolte funkci migrace. |
| Úplnou migraci nelze volat před vygenerováním IP adres. | Tato chyba se zobrazí, pokud se pokusíte migrovat před dokončením kroků předběžné migrace. | Před pokusem o migraci se ujistěte, že jste dokončili všechny kroky předběžné migrace. Podrobný průvodce migrací najdete v podrobném průvodci. |
| Pro tuto službu ASE není povolená migrace do ASEv3. | Pomocí funkce migrace nemůžete migrovat. | Migrujte pomocí jedné z možností ruční migrace. |
| Předplatné má příliš mnoho prostředí App Service Environment. Před pokusem o vytvoření dalších souborů prosím některé odeberte. | Splní se kvóta služby App Service Environment pro vaše předplatné . | Odeberte nepotřebná prostředí nebo se obraťte na podporu a zkontrolujte možnosti. |
<ZoneRedundant><DedicatedHosts><ASEv3/ASE> není v tomto umístění k dispozici. |
Tato chyba se zobrazí, pokud se pokoušíte migrovat službu App Service Environment v oblasti, která nepodporuje některou z vašich požadovaných funkcí. | Pokud chcete migrovat okamžitě, proveďte migraci pomocí jedné z možností ruční migrace. V opačném případě počkejte, až bude funkce migrace podporovat tuto konfiguraci služby App Service Environment. |
| Migraci nelze v této službě ASE volat, dokud se nedokončí aktivní upgrade. | Během upgradů platformy nejde migrovat prostředí App Service Environment. Předvolbu upgradu můžete nastavit na webu Azure Portal. Upgrade trvá 8 až 12 hodin nebo déle v závislosti na velikosti (počtu instancí/jader) služby App Service Environment. | Počkejte, až se upgrade dokončí, a pak proveďte migraci. |
| Probíhá operace správy služby App Service Environment. | Vaše služba App Service Environment prochází operací správy. Tyto operace můžou zahrnovat aktivity, jako jsou nasazení nebo upgrady. Migrace se zablokuje, dokud tyto operace nebudou dokončeny. | Po dokončení těchto operací můžete migrovat. |
| Migrace není pro toto předplatné k dispozici. | Pro migraci této služby App Service Environment je potřeba zapojit podporu. | Otevřete případ podpory a obraťte se na podporu pro vyřešení vašeho problému. |
| Váš InteralLoadBalancingMode se v současné době nepodporuje. | Služba App Service Environment, která mají vlastnost InternalLoadBalancingMode nastavenou na určité hodnoty, nejde v tuto chvíli migrovat pomocí funkce migrace. InternalLoadBalancingMode musí být ručně změněn týmem Microsoftu. | Otevřete případ podpory a obraťte se na podporu pro vyřešení vašeho problému. Požádejte o aktualizaci internalLoadBalancingMode, aby bylo možné migraci povolit. |
Přehled procesu migrace pomocí funkce místní migrace
Místní migrace se skládá z řady kroků, které je potřeba dodržovat v pořadí. Klíčové body jsou uvedeny pro podskupinu kroků. Je důležité pochopit, co se během těchto kroků děje a jaký dopad mají na vaše prostředí a aplikace. Jakmile si prohlédnete následující informace a až budete připraveni k migraci, postupujte podle podrobného průvodce.
Pomocí funkce místní migrace pro službu App Service Environment ověřte, že je migrace podporovaná.
Platforma ověří, že je možné migrovat službu App Service Environment pomocí místní funkce migrace. Pokud vaše služba App Service Environment neprojde všemi kontrolami ověření, nemůžete v tuto chvíli migrovat pomocí funkce místní migrace. Podrobnosti o možných příčinách selhání ověření najdete v části řešení potíží . Pokud je vaše prostředí ve špatném nebo pozastaveném stavu, nemůžete migrovat, dokud neprovádíte potřebné aktualizace. Pokud nemůžete migrovat pomocí funkce místní migrace, podívejte se na možnosti ruční migrace.
Ověření také zkontroluje, jestli je vaše služba App Service Environment na minimálním sestavení potřebném pro migraci. Toto sestavení může být novější než standardní sestavení, které je nasazené s cyklem pravidelného upgradu nebo údržby platformy. Minimální build se pravidelně aktualizuje, aby se zajistilo, že jsou k dispozici nejnovější opravy chyb a vylepšení. Pokud vaše služba App Service Environment není na minimálním buildu, musíte upgrade spustit sami. Tento upgrade je standardní proces, ve kterém není ovlivněná služba App Service Environment, ale během upgradu nemůžete škálovat ani provádět změny ve službě App Service Environment. Dokud se upgrade nedokončí, nemůžete migrovat. Dokončení upgradů může trvat 8 až 12 hodin nebo déle v závislosti na velikosti vašeho prostředí. Pokud plánujete konkrétní časové období migrace, měli byste spustit kontrolu ověření 24–48 hodin před plánovaným časem migrace, abyste měli čas na upgrade, pokud je potřeba.
Generování IP adres pro nové prostředí App Service Environment v3
Platforma vytvoří novou příchozí IP adresu (pokud migrujete prostředí ELB App Service Environment) a nové odchozí IP adresy. Během vytváření těchto IP adres není činnost s vaším stávajícím prostředím App Service Environment přerušena, nemůžete však škálovat ani provádět změny ve stávajícím prostředí. Dokončení tohoto procesu trvá přibližně 15 minut.
Po dokončení budete mít nové IP adresy, které používá vaše budoucí prostředí App Service Environment v3. Tyto nové IP adresy nemají žádný vliv na vaše stávající prostředí. IP adresy používané vaším stávajícím prostředím se budou dál používat, dokud se během kroku migrace nevypnou vaše stávající prostředí.
Aktualizace závislých prostředků pomocí nových IP adres
Po vytvoření nových IP adres máte nové výchozí odchozí odchozí adresy na veřejné internetové adresy. Při přípravě na migraci můžete upravit všechny externí brány firewall, směrování DNS, skupiny zabezpečení sítě a všechny další prostředky, které na těchto IP adresách spoléhají. Pro ELB App Service Environment máte také novou příchozí IP adresu, kterou můžete použít k nastavení nových koncových bodů se službami, jako je Traffic Manager nebo Azure Front Door. Je vaší zodpovědností aktualizovat všechny a všechny prostředky, které budou mít vliv na změnu IP adresy přidružené k nové službě App Service Environment v3. Nepřecházejte k dalšímu kroku, dokud neuděláte všechny požadované aktualizace. Tento krok je také vhodný čas zkontrolovat změny příchozích a odchozích závislostí sítě při přechodu do služby App Service Environment v3, včetně změny portu sondy stavu Azure Load Balanceru, která teď používá port 80.
Delegování podsítě služby App Service Environment
App Service Environment v3 vyžaduje, aby podsíť, ve které je, měla jediné delegování Microsoft.Web/hostingEnvironments. Migrace nemůže být úspěšná, pokud podsíť služby App Service Environment není delegovaná nebo ji delegujete na jiný prostředek.
Potvrzení změn velikosti instance
Plány služby App Service se v rámci migrace převedou z Izolované na odpovídající vrstvu Izolované verze 2. Například I2 se převede na I2v2. Vaše aplikace můžou být po migraci příliš zřízené, protože úroveň Izolované verze 2 má více paměti a procesoru na odpovídající velikost instance. Po dokončení migrace máte možnost škálovat prostředí podle potřeby. Další informace najdete v podrobnostech skladové položky.
Zajistěte, aby prostředky nebyly uzamčeny
Virtuální síť během migrace blokuje operace platformy. Pokud má vaše virtuální síť zámky, musíte je před migrací odebrat. Zámky je možné přečíst v případě potřeby po dokončení migrace. Zámky můžou existovat ve třech různých oborech: předplatné, skupina prostředků a prostředek. Když zámek použijete u nadřazeného oboru, všechny prostředky v daném oboru dědí stejný zámek. Pokud máte zámky použité v rámci předplatného, skupiny prostředků nebo rozsahu prostředků, je potřeba je před migrací odebrat. Další informace o zámcích a dědičnosti zámků najdete v tématu Uzamčení prostředků za účelem ochrany infrastruktury.
Ujistěte se, že migrace neblokuje žádné zásady Azure.
Azure Policy se dá použít k odepření vytváření a úprav prostředků na určité objekty zabezpečení. Pokud máte zásadu, která blokuje vytváření prostředí App Service Environment nebo úpravu podsítí, musíte ji před migrací odebrat. Po dokončení migrace je možné tuto zásadu přečíst. Další informace o službě Azure Policy najdete v přehledu služby Azure Policy.
Volba konfigurací prostředí App Service Environment v3
Vaše služba App Service Environment v3 se dá nasadit napříč zónami dostupnosti v oblastech, které ji podporují. Tato architektura se označuje jako redundance zón. Redundanci zón je možné nakonfigurovat pouze při vytváření služby App Service Environment. Pokud chcete, aby nová služba App Service Environment v3 byla zónově redundantní, povolte konfiguraci během procesu migrace. Všechny služby App Service Environment, které k migraci používají místní funkci migrace, je možné nakonfigurovat jako zónově redundantní, pokud používáte oblast, která podporuje redundanci zón pro App Service Environment v3. Pokud máte existující prostředí v oblasti, která nepodporuje redundanci zón, je možnost konfigurace zakázaná a nemůžete ji nakonfigurovat. Funkce místní migrace nepodporuje změny oblastí. Pokud chcete použít jinou oblast, použijte jednu z možností ruční migrace.
Poznámka:
Povolení redundance zón může vést k dalším poplatkům. Další informace najdete v cenovém modelu redundance zón.
Pokud vaše stávající služba App Service Environment používá příponu vlastní domény, zobrazí se výzva ke konfiguraci přípony vlastní domény pro novou službu App Service Environment v3. Musíte zadat vlastní název domény, spravovanou identitu a certifikát. Další informace o příponě vlastní domény služby App Service Environment v3, včetně požadavků, podrobných pokynů a osvědčených postupů, najdete v tématu Konfigurace přípony vlastní domény pro App Service Environment. Pro nové prostředí musíte nakonfigurovat vlastní příponu domény, i když ji už nechcete používat. Po dokončení migrace můžete v případě potřeby odebrat konfiguraci přípony vlastní domény.
Pokud vaše migrace obsahuje příponu vlastní domény pro App Service Environment v3, vlastní doména se nezobrazí v části Základy na stránce Přehled portálu, protože je určená pro App Service Environment v1/v2. Místo toho přejděte ve službě App Service Environment v3 na stránku přípony vlastní domény, kde můžete potvrdit, že je přípona vlastní domény správně nakonfigurovaná. Pokud máte také příponu vlastní domény ve službě App Service Environment v2, bude výchozí název hostitele obsahovat příponu vlastní domény a je ve formuláři APP-NAME.internal.contoso.com. Ve službě App Service Environment v3 výchozí název hostitele vždy používá výchozí příponu domény a je ve formuláři APP-NAME.ASE-NAME.appserviceenvironment.net. Tento rozdíl spočívá v tom, že služba App Service Environment v3 uchovává výchozí příponu domény při přidání přípony vlastní domény. Ve službě App Service Environment v2 existuje jenom jedna přípona domény.
Migrace na službu App Service Environment v3
Po dokončení předchozích kroků byste měli co nejdříve pokračovat v migraci.
Důležité
Vzhledem k tomu, že během migrace je škálování zablokované, měli byste před zahájením migrace škálovat prostředí na požadovanou velikost. Pokud máte povolené automatické škálování, pokud nastane událost škálování před zahájením migrace, musíte před zahájením migrace počkat, až se událost škálování dokončí. Před zahájením migrace byste měli zakázat automatické škálování, abyste se tomuto problému vyhnuli. Pokud po migraci potřebujete škálovat prostředí, můžete to udělat po dokončení migrace.
Migrace vyžaduje 3 až šestihodinový interval služby pro migrace služby App Service Environment v2 na verzi 3. Pro migraci z v1 na v3 je v závislosti na velikosti prostředí vyžadováno až šestihodinové servisní okno. Okno služby může být rozšířeno ve výjimečných případech, kdy je vyžadován ruční zásah týmu služeb. Během migrace se zablokují konfigurace škálování a prostředí a dojde k následujícím událostem:
- Stávající prostředí App Service Environment se vypne a bude nahrazeno novým prostředím App Service Environment v3.
- Všechny plány služby App Service ve službě App Service Environment se převedou z izolované na izolovanou vrstvu v2.
- Všechny aplikace, které jsou v prostředí App Service Environment, jsou dočasně vypnuty. Během tohoto období byste měli očekávat přibližně jednu hodinu výpadku.
- Pokud nemůžete podporovat výpadky, podívejte se na funkci souběžné migrace nebo alternativy migrace.
- Veřejné adresy používané prostředím App Service Environment se mění na IP adresy vygenerované během kroku generování IP adres.
Během procesu migrace jsou k dispozici následující stavy:
| Status | Popis |
|---|---|
| Ověřování a příprava migrace | Platforma ověřuje podporu migrace a provádí nezbytné kontroly. |
| Nasazení infrastruktury služby App Service Environment v3 | Vaše nová infrastruktura služby App Service Environment v3 se zřizuje. |
| Čeká se na dokončení infrastruktury. | Platforma ověřuje novou infrastrukturu a provádí nezbytné kontroly. |
| Nastavení sítě. Doba výpadku migrace začala. Aplikace nejsou přístupné. | Platforma odstraňuje starou infrastrukturu a přesouvá všechny vaše aplikace do nové služby App Service Environment v3. Vaše aplikace jsou nedostupné a nepřijímají provoz. |
| Spuštění ověření po migraci | Platforma provádí nezbytné kontroly, aby byla migrace úspěšná. |
| Dokončení migrace | Platforma dokončuje migraci. |
Stejně jako v kroku generování IP adres nemůžete během tohoto procesu škálovat, upravovat ani nasazovat aplikace do prostředí App Service Environment. Po dokončení migrace jsou aplikace, které byly ve starém prostředí App Service Environment, spuštěny v novém prostředí App Service Environment v3.
Použití funkce místní migrace
Požadavky
Ujistěte se, že rozumíte tomu, jak migrace do služby App Service Environment v3 ovlivňuje vaše aplikace. Projděte si proces migrace, abyste pochopili časovou osu procesu a kde a kdy se potřebujete zapojit. Projděte si také nejčastější dotazy, které vám můžou odpovědět na některé otázky.
Ujistěte se, že ve virtuální síti, skupině prostředků, prostředku nebo předplatném nejsou žádné zámky. Během migrace zamkne blokované operace platformy.
Ujistěte se, že žádné zásady Azure neblokují akce, které jsou potřeba k migraci, včetně úprav podsítě a vytváření prostředků služby Aplikace Azure. Zásady, které blokují úpravy a vytváření prostředků, můžou způsobit zablokování nebo selhání migrace.
Vzhledem k tomu, že během migrace je škálování zablokované, měli byste před zahájením migrace škálovat prostředí na požadovanou velikost. Pokud po migraci potřebujete škálovat prostředí, můžete to udělat po dokončení migrace. Pokud máte povolené automatické škálování, pokud dojde k události škálování před zahájením migrace, bude migrace blokovaná, dokud se událost škálování nekončí. Před zahájením migrace byste měli zakázat automatické škálování, abyste se tomuto problému vyhnuli.
Pro místní prostředí migrace doporučujeme použít Azure Portal . Pokud se rozhodnete pro migraci použít Azure CLI , postupujte podle kroků popsaných tady a podle pokynů, protože provádíte volání rozhraní Azure REST API. K volání těchto rozhraní API doporučujeme použít Azure CLI. Informace o dalších metodách najdete v referenčních informacích k rozhraní Azure REST API.
Pro účely této příručky nainstalujte Azure CLI nebo použijte Azure Cloud Shell a použijte prostředí Bash.
Poznámka:
Ke spuštění příkazů uvedených v této příručce doporučujeme použít prostředí Bash. Příkazy nemusí být kompatibilní s konvencemi PowerShellu a řídicími znaky.
1. Získání ID služby App Service Environment
Spuštěním následujících příkazů získejte ID služby App Service Environment a uložte ho jako proměnnou prostředí. Zástupné symboly pro název a skupiny prostředků nahraďte hodnotami služby App Service Environment, kterou chcete migrovat. ASE_RG a VNET_RG jsou stejné, pokud jsou vaše virtuální síť a App Service Environment ve stejné skupině prostředků.
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. Ověřte, že je migrace podporovaná.
Následující příkaz zkontroluje, jestli je vaše služba App Service Environment podporovaná pro migraci, a ověří, jestli je vaše služba App Service Environment v podporované verzi sestavení pro migraci.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=validation"
Pokud nedojde k žádným chybám, migrace se podporuje a můžete pokračovat dalším krokem.
Pokud potřebujete spustit upgrade pro upgrade služby App Service Environment na podporovanou verzi sestavení, spusťte následující příkaz. Tento příkaz spusťte pouze v případě, že krok ověření selže a budete vyzváni k upgradu služby App Service Environment.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=PreMigrationUpgrade"
3. Generování IP adres pro nový prostředek služby App Service Environment v3
Spuštěním následujícího příkazu vytvořte nové IP adresy. Dokončení tohoto kroku trvá přibližně 15 minut. Během této doby neudělávejte škálování ani neprovádejte změny ve stávající službě App Service Environment.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=premigration"
Spuštěním následujícího příkazu zkontrolujte stav tohoto kroku:
az rest --method get --uri "${ASE_ID}?api-version=2021-02-01" --query properties.status
Pokud krok probíhá, zobrazí se stav Migrating. Po zobrazení Readynových IP adres spusťte následující příkaz. Pokud nové IP adresy nevidíte okamžitě, počkejte několik minut a zkuste to znovu.
az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"
4. Aktualizace závislých prostředků pomocí nových IP adres
Pomocí nových IP adres aktualizujte všechny prostředky nebo síťové komponenty, abyste zajistili, že nové prostředí bude fungovat podle očekávání po dokončení migrace. Je vaší zodpovědností provést potřebné aktualizace.
5. Delegování podsítě služby App Service Environment
App Service Environment v3 vyžaduje, aby podsíť, ve které je, měla jediné delegování Microsoft.Web/hostingEnvironments. Předchozí verze nepožadovali toto delegování. Před migrací musíte ověřit, že je vaše podsíť správně delegovaná, a v případě potřeby delegování aktualizovat. Delegování můžete aktualizovat spuštěním následujícího příkazu nebo přechodem do podsítě na webu Azure Portal.
az network vnet subnet update --resource-group $VNET_RG --name <subnet-name> --vnet-name <vnet-name> --delegations Microsoft.Web/hostingEnvironments
6. Ověřte, že virtuální síť neobsahuje žádné zámky.
Virtuální síť během migrace blokuje operace platformy. Pokud má vaše virtuální síť zámky, musíte je před migrací odebrat. V případě potřeby můžete po dokončení migrace přidat zámky zpět.
Pomocí následujícího příkazu zkontrolujte, jestli má vaše virtuální síť nějaké zámky:
az lock list --resource-group $VNET_RG --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Pomocí následujícího příkazu odstraňte všechny existující zámky:
az lock delete --resource-group $VNET_RG --name <lock-name> --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Související příkazy pro kontrolu, jestli vaše předplatné nebo skupina prostředků mají zámky, najdete v referenčních informacích k Azure CLI pro zámky.
7. Příprava konfigurací
Novou zónu prostředků služby App Service Environment v3 můžete nastavit jako redundantní, pokud je vaše stávající prostředí v oblasti, která podporuje redundanci zón. Redundanci zóny můžete nakonfigurovat nastavením zoneRedundant vlastnosti na truehodnotu .
Pokud vaše stávající služba App Service Environment používá vlastní příponu domény, musíte ji nakonfigurovat pro nový prostředek služby App Service Environment v3 během procesu migrace. Migrace selže, pokud nenakonfigurujete vlastní příponu domény a aktuálně ji používáte. Migrace se také nezdaří, pokud se během migrace pokusíte přidat příponu vlastní domény do prostředí, které nemá nakonfigurovanou. Další informace o příponách vlastní domény služby App Service Environment v3, včetně požadavků, podrobných pokynů a osvědčených postupů, najdete v tématu Vlastní přípona domény pro app Service Environment.
Poznámka:
Pokud konfigurujete vlastní příponu domény, při přidávání síťových oprávnění do trezoru klíčů Azure se ujistěte, že váš trezor klíčů umožňuje přístup z nových odchozích IP adres služby App Service Environment generovaných v kroku 3. Pokud přistupujete ke svému trezoru klíčů pomocí privátního koncového bodu, ujistěte se, že jste správně nakonfigurovali privátní přístup.
Pokud migrace neobsahuje příponu vlastní domény a nepovolujete redundanci zón, můžete přejít k migraci.
Pokud chcete tyto konfigurace nastavit, vytvořte soubor s názvem parameters.json s následujícími podrobnostmi na základě vašeho scénáře. Nezahrnujte vlastnosti pro příponu vlastní domény, pokud se tato funkce nevztahuje na vaši migraci. Věnujte pozornost hodnotě zoneRedundant vlastnosti, protože tato konfigurace je po migraci nevratná. Nastavte hodnotu kind vlastnosti na základě vaší stávající verze služby App Service Environment. Přijaté hodnoty pro kind vlastnost jsou ASEV1 a ASEV2.
Pokud migrujete bez přípony vlastní domény a povolíte redundanci zón, použijte tento kód:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"zoneRedundant": true
}
}
Pokud pro konfiguraci přípony vlastní domény používáte spravovanou identitu přiřazenou uživatelem a povolíte redundanci zón, použijte tento kód:
{
"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"
}
}
}
Pokud pro konfiguraci přípony vlastní domény používáte spravovanou identitu přiřazenou systémem a nepovolujete redundanci zón, použijte tento kód:
{
"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. Migrace do služby App Service Environment v3 a kontrola stavu
Po dokončení všech předchozích kroků můžete migraci spustit. Ujistěte se, že rozumíte důsledkům migrace.
V závislosti na velikosti prostředí tento krok trvá tři až šest hodin pro migraci v2 až v3 a až šest hodin pro migraci v1 až v3. Během této doby dochází k přibližně hodině výpadku aplikace. Během tohoto kroku se zablokují škálování, nasazení a úpravy stávajícího prostředí App Service Environment.
body Pokud povolujete redundanci zón nebo konfigurujete příponu vlastní domény, zahrňte parametr do následujícího příkazu. Pokud pro migraci neplatí žádná z těchto konfigurací, můžete parametr z příkazu odebrat.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=fullmigration" --body @parameters.json
Spuštěním následujících příkazů zkontrolujte podrobný stav migrace. Informace o stavech najdete v popisu stavu migrace.
První příkaz získá ID operace pro migraci. Zkopírujte hodnotu ID vlastnosti.
az rest --method get --uri "${ASE_ID}/operations?api-version=2022-03-01"
Nahraďte zástupný symbol ID operace v následujícím příkazu hodnotou, kterou jste zkopírovali. Tento příkaz vrátí podrobný stav migrace. Tento příkaz můžete spustit tak často, jak je potřeba, abyste získali nejnovější stav.
az rest --method get --uri "${ASE_ID}/operations/<operation-id>/details/default?api-version=2022-09-01"
Jakmile se zobrazí stav Ready, migrace se dokončí a máte prostředek služby App Service Environment v3. Vaše aplikace teď běží ve vašem novém prostředí.
Podrobnosti o novém prostředí získáte spuštěním následujícího příkazu nebo na webu Azure Portal.
az appservice ase show --name $ASE_NAME --resource-group $ASE_RG
1. Ověřte, že je migrace podporovaná.
Na webu Azure Portal přejděte na stránku Migrace pro službu App Service Environment, kterou migrujete. Na stránku Migrace se dostanete tak, že v horní části stránky Přehled služby App Service Environment vyberete banner nebo vyberete položku Migrace v nabídce vlevo.
Vyberte možnost místní migrace a spusťte místní proces migrace. Pokud vyberete možnost souběžné migrace, přejdete do dokumentace pro tento proces migrace. Pokud chcete použít místní funkci migrace, nevybírejte možnost souběžné migrace.
Na stránce Migrace platforma ověří, jestli je pro službu App Service Environment podporovaná migrace. Vyberte Ověřit a potvrďte, že chcete pokračovat v ověřování. Proces ověření trvá několik sekund.
Pokud vaše prostředí není pro migraci podporované, zobrazí se v horní části stránky banner s chybovou zprávou s důvodem. Popis chybových zpráv, které se můžou zobrazit, pokud nemáte nárok na migraci, najdete v tématu Řešení potíží.
Pokud potřebujete spustit upgrade služby App Service Environment na podporovanou verzi buildu, zobrazí se výzva k spuštění upgradu, což může trvat 8 až 12 hodin nebo déle v závislosti na velikosti vašeho prostředí. Vyberte Upgradovat a spusťte upgrade. Po dokončení upgradu předáte ověření a můžete k zahájení migrace použít funkci migrace.
Pokud je migrace pro službu App Service Environment podporovaná, přejděte k dalšímu kroku procesu. Stránka Migrace vás provede řadou kroků k dokončení migrace.
2. Generování IP adres pro nový prostředek služby App Service Environment v3
V části Získat nové IP adresy potvrďte, že rozumíte důsledkům, a vyberte tlačítko Start . Dokončení tohoto kroku trvá přibližně 15 minut. Během této doby nemůžete škálovat ani měnit stávající službu App Service Environment.
3. Aktualizace závislých prostředků pomocí nových IP adres
Po dokončení předchozího kroku se zobrazí IP adresy nového prostředku služby App Service Environment v3. Pomocí nových IP adres aktualizujte všechny prostředky a síťové komponenty tak, aby nové prostředí fungovalo podle očekávání po dokončení migrace. Je vaší zodpovědností provést potřebné aktualizace.
4. Delegování podsítě služby App Service Environment
App Service Environment v3 vyžaduje podsíť, ve které je, aby měla jedno delegování Microsoft.Web/hostingEnvironments. Předchozí verze nepožadovali toto delegování. Před migrací musíte ověřit, že je vaše podsíť správně delegovaná, a v případě potřeby delegování aktualizovat. Portál zobrazí odkaz na vaši podsíť, abyste je mohli podle potřeby potvrdit a aktualizovat.
5. Potvrzení změn velikosti instance
Výběrem tlačítka Potvrdit potvrďte, že v rámci migrace se plány služby App Service převedou z izolované úrovně na odpovídající vrstvu Izolované verze 2.
6. Ověřte, že virtuální síť nemá žádné zámky.
Virtuální síť během migrace blokuje operace platformy. Pokud má vaše virtuální síť zámky, musíte je před migrací odebrat. Podrobnosti o tom, jak zkontrolovat, jestli má vaše předplatné nebo skupina prostředků zámky, najdete v tématu Konfigurace zámků.
7. Zvolte konfigurace
Novou zónu prostředků služby App Service Environment v3 můžete nastavit jako redundantní, pokud je vaše stávající prostředí v oblasti, která podporuje redundanci zón.
Pokud chcete nakonfigurovat redundanci zóny, zaškrtněte políčko Povoleno.
Pokud je vaše prostředí v oblasti, která nepodporuje redundanci zón, není zaškrtávací políčko k dispozici. Pokud potřebujete zónově redundantní prostředek služby App Service Environment v3, použijte jednu z možností ruční migrace a vytvořte prostředek v jedné z oblastí, které podporují redundanci zón.
Pokud vaše stávající služba App Service Environment používá příponu vlastní domény, musíte ji nakonfigurovat pro nový prostředek služby App Service Environment v3. Pokud se tato situace týká vás, zobrazí se možnosti konfigurace pro příponu vlastní domény. Nemůžete migrovat, dokud nezadáte požadované informace.
Pokud chcete použít vlastní příponu domény, ale aktuálně ji nemáte nakonfigurovanou, můžete ji nakonfigurovat po dokončení migrace. Další informace o příponách vlastní domény služby App Service Environment v3, včetně požadavků, podrobných pokynů a osvědčených postupů, najdete v tématu Vlastní přípona domény pro app Service Environment.
Poznámka:
Pokud konfigurujete vlastní příponu domény, nezapomeňte při přidávání síťových oprávnění do trezoru klíčů Azure zajistit, aby váš trezor klíčů umožňoval přístup z nových odchozích IP adres služby App Service Environment generovaných v kroku 2. Pokud přistupujete ke svému trezoru klíčů pomocí privátního koncového bodu, ujistěte se, že jste správně nakonfigurovali privátní přístup.
Po přidání podrobností o příponě vlastní domény je tlačítko Migrovat dostupné.
8. Migrace do služby App Service Environment v3
Po dokončení všech předchozích kroků můžete migraci spustit. Ujistěte se, že rozumíte důsledkům migrace, včetně toho, co se během této doby stane.
V závislosti na velikosti prostředí tento krok trvá tři až šest hodin pro migraci v2 až v3 a až šest hodin pro migraci v1 až v3. Během tohoto kroku se zablokují změny a škálování stávajícího prostředí App Service Environment.
Poznámka:
Ve výjimečných případech se může na portálu zobrazit oznámení o tom, že migrace do služby App Service Environment v3 selhala. Existuje známá chyba, která může toto oznámení aktivovat, i když migrace postupuje. Zkontrolujte protokol aktivit služby App Service Environment a zjistěte platnost této chybové zprávy. Ve většině případů se problém vyřeší aktualizací stránky a chybová zpráva zmizí. Pokud chybová zpráva přetrvává, obraťte se na podporu a požádejte o pomoc.
V tuto chvíli jsou podrobné stavy migrace dostupné jenom v případě, že používáte Azure CLI. Další informace najdete v části Azure CLI pro migraci do služby App Service Environment v3. Stav migrace můžete zkontrolovat pomocí rozhraní příkazového řádku, i když k migraci použijete portál.
Po dokončení migrace máte prostředek služby App Service Environment v3 a všechny aplikace běží ve vašem novém prostředí. Verzi prostředí můžete ověřit tak, že zkontrolujete stránku Konfigurace vaší služby App Service Environment.
Pokud migrace obsahuje vlastní příponu domény, zobrazí se doména v části Základy na stránce Přehled portálu pro App Service Environment verze 1/v2, ale už se tam nezobrazí ve službě App Service Environment v3. Místo toho přejděte ve službě App Service Environment v3 na stránku přípony vlastní domény a ověřte, že je vaše přípona vlastní domény správně nakonfigurovaná. Konfiguraci můžete také odebrat, pokud ji už nepotřebujete, nebo ji nakonfigurovat, pokud jste ji ještě neměli.
Poznámka:
Pokud migrace obsahuje příponu vlastní domény, konfigurace přípony vlastní domény se může po dokončení migrace projevit jako degradovaná kvůli známé chybě. Vaše služba App Service Environment by měla i nadále fungovat podle očekávání. Degradovaný stav by se měl vyřešit během 6 až 8 hodin. Pokud je konfigurace po 8 hodinách degradovaná nebo pokud vaše vlastní přípona domény nefunguje, obraťte se na podporu.
Ceny
Migrace služby App Service Environment není spojena s žádnými náklady. Když použijete funkci místní migrace, přestanou se vám účtovat poplatky za předchozí službu App Service Environment, jakmile se během procesu migrace vypne. Jakmile se nasadí, začnou se vám účtovat nové služby App Service Environment v3. Další informace o cenách služby App Service Environment v3 najdete v podrobnostech o cenách.
Při migraci do služby App Service Environment v3 z předchozích verzí byste měli zvážit scénáře, které by mohly snížit měsíční náklady. Zvažte plány rezervací a úspor, abyste snížili náklady. Informace o příležitostech úspor nákladů najdete v tématu Příležitosti k úsporám nákladů po upgradu na App Service Environment v3.
Poznámka:
Vzhledem k převodu plánů služby App Service z izolovaného na izolovaný v2 může být vaše aplikace po migraci nadměrně zřízená, protože úroveň Izolované verze 2 má více paměti a procesoru na odpovídající velikost instance. Po dokončení migrace budete mít možnost škálovat prostředí podle potřeby. Další informace najdete v podrobnostech skladové položky.
Vertikální snížení kapacity plánů služby App Service
Skladové položky plánu služby App Service dostupné pro App Service Environment v3 běží na úrovni Izolované verze 2 (Iv2). Počet jader a množství paměti RAM se v porovnání s izolovanou vrstvou efektivně zdvojnásobí na odpovídající úroveň. Při migraci se plány služby App Service převedou na odpovídající úroveň. Například vaše instance I2 se převedou na I2v2. I2 má dvě jádra a 7 GB RAM, I2v2 má čtyři jádra a 16 GB RAM. Pokud očekáváte, že vaše požadavky na kapacitu zůstanou stejné, budete zřizované a platíte za výpočetní prostředky a paměť, které nepoužíváte. V tomto scénáři můžete vertikálně snížit kapacitu instance I2v2 na I1v2 a nakonec s podobným počtem jader a paměti RAM, které jste měli dříve.
Nejčastější dotazy
- Co když migrace služby App Service Environment není aktuálně podporovaná?
V tuto chvíli nemůžete migrovat pomocí funkce místní migrace. Pokud máte nepodporované prostředí a chcete migrovat okamžitě, podívejte se na možnosti ruční migrace. - Návody zvolit, která možnost migrace je pro mě správná?
Zkontrolujte rozhodovací strom cesty migrace a rozhodněte se, která možnost je pro váš případ použití nejvhodnější. - Návody vědět, jestli mám použít místní funkci migrace?
Funkce místní migrace je nejvhodnější pro zákazníky, kteří chtějí migrovat do služby App Service Environment v3 s minimálními změnami konfigurace sítě a můžou podporovat přibližně hodinu výpadků aplikací. Pokud nemůžete podporovat výpadek, podívejte se na funkci migrace na straně nebo možnosti ruční migrace. Funkce místní migrace vytvoří službu App Service Environment v3 ve stejné podsíti jako vaše stávající prostředí a používá stejnou síťovou infrastrukturu. Pokud máte nějaké závislosti na těchto konkrétních IP adresách, budete možná muset počítat se změnami příchozích a odchozích IP adres. - Dojde během migrace k výpadku?
Ano, během kroku migrace byste měli očekávat přibližně jednu hodinu výpadku během 3 až šestihodinového intervalu služby, takže odpovídajícím způsobem naplánujte. Pokud máte jiné prostředí App Service Environment, na které můžete během migrace směrovat provoz pomocí funkce místní migrace, můžete eliminovat výpadky aplikací. Pokud nemáte jiné prostředí App Service Environment a nemůžete podporovat výpadky, podívejte se na funkci souběžné migrace nebo možnosti ruční migrace. - Budu muset po migraci udělat něco pro své aplikace, aby se spustily v nové službě App Service Environment?
Ne, všechny vaše aplikace spuštěné ve starém prostředí se automaticky migrují do nového prostředí a spustí se stejně jako dříve. Není potřeba žádný uživatelský vstup. - Co když má moje služba App Service Environment příponu vlastní domény?
Funkce místní migrace podporuje tento scénář migrace. - Co když je moje služba App Service Environment připnutá?
Zónový připnutý App Service Environment v2 je teď podporovaný scénář migrace pomocí funkce migrace. App Service Environment v3 nepodporuje připnutí zóny. Při migraci do služby App Service Environment v3 se můžete rozhodnout nakonfigurovat redundanci zón nebo ne. - Co když má služba App Service Environment IP adresy SSL? PROTOKOL SSL protokolu IP není ve službě App Service Environment v3 podporovaný. Před migrací pomocí funkce migrace nebo jedné z ručních možností je nutné odebrat všechny vazby SSL protokolu IP. Pokud máte v úmyslu používat funkci místní migrace, po odebrání všech vazeb PROTOKOLU IP SSL předáte tuto kontrolu ověření a můžete pokračovat v automatizované migraci.
- Jaké vlastnosti služby App Service Environment se změní?
Pracujete ve službě App Service Environment verze 3, proto si nezapomeňte projít rozdíly mezi funkcemi a funkcemi v porovnání s předchozími verzemi. V případě prostředí ILB App Service Environment ponecháte stejnou IP adresu ILB. Pro internetové prostředí App Service Environment se změní veřejná IP adresa a odchozí IP adresa. Všimněte si, že pro ELB App Service Environment existovala dříve jedna IP adresa pro příchozí i odchozí provoz. Pro prostředí App Service Environment v3 jsou oddělené. Další informace najdete v tématu Sítě prostředí App Service Environment v3. Úplné porovnání verzí prostředí App Service Environment najdete ve v porovnání verzí prostředí App Service Environment. - Co se stane, když migrace selže nebo během migrace dojde k neočekávanému problému?
Pokud dojde k neočekávanému problému, týmy podpory jsou k dispozici. Než se dotknete jakýchkoli produkčních prostředí, měli byste migrovat vývojová prostředí, abyste se dozvěděli o procesu migrace a zjistili, jak ovlivňuje vaše úlohy. - Co se stane se starou službou App Service Environment?
Pokud se rozhodnete migrovat službu App Service Environment pomocí místní funkce migrace, staré prostředí se vypne, odstraní a všechny vaše aplikace se migrují do nového prostředí. Vaše staré prostředí už není přístupné. Vrácení zpět do starého prostředí není možné. - Co se stane s prostředky prostředí App Service Environment v1/v2 po 31. srpnu 2024?
Po 31. srpnu 2024 už nebudou vaše aplikace App Service Environment v1/v2 a nasazené aplikace už dostupné. Prostředí App Service Environment v1/v2 je hostované v jednotkách škálování služby App Service běžících na architektuře Cloud Services (Classic),, která bude vyřazena 31. srpna 2024. Z tohoto důvodu nebude prostředí App Service Environment v1/v2 po tomto datu dostupné. Přechodem na prostředí App Service Environment v3 můžete udržovat aplikace v chodu nebo ukládat a zálohovat prostředky či data, která potřebujete udržovat.