Udostępnij za pośrednictwem


Migracja do środowiska App Service Environment w wersji 3 przy użyciu funkcji migracji równoległej

Uwaga

Funkcja migracji opisana w tym artykule jest używana do automatycznej migracji środowiska App Service Environment w wersji 2 do środowiska App Service Environment w wersji 3 obok siebie (innej podsieci).

Jeśli szukasz informacji na temat funkcji migracji w miejscu, zobacz Migrowanie do środowiska App Service Environment w wersji 3 przy użyciu funkcji migracji w miejscu. Jeśli szukasz informacji na temat opcji migracji ręcznej, zobacz Opcje migracji ręcznej. Aby uzyskać pomoc przy podejmowaniu decyzji o tym, która opcja migracji jest odpowiednia, zobacz Drzewo decyzyjne ścieżki migracji. Aby uzyskać więcej informacji na temat środowiska App Service Environment w wersji 3, zobacz Omówienie środowiska App Service Environment w wersji 3.

Usługa App Service może zautomatyzować migrację środowiska App Service Environment w wersji 1 i 2 do środowiska App Service Environment w wersji 3. Istnieją różne opcje migracji. Przejrzyj drzewo decyzyjne ścieżki migracji, aby zdecydować, która opcja jest najlepsza dla twojego przypadku użycia. Środowisko App Service Environment w wersji 3 zapewnia zalety i różnice funkcji w porównaniu z wcześniejszymi wersjami . Przed migracją sprawdź obsługiwane funkcje środowiska App Service Environment w wersji 3 przed migracją, aby zmniejszyć ryzyko nieoczekiwanego problemu z aplikacją.

Funkcja migracji równoległej automatyzuje migrację do środowiska App Service Environment w wersji 3. Funkcja migracji równoległej tworzy nowe środowisko App Service Environment w wersji 3 ze wszystkimi aplikacjami w innej podsieci. Istniejące środowisko App Service Environment nie zostanie usunięte do momentu zainicjowania jego usunięcia na końcu procesu migracji. Ta opcja migracji jest najlepsza dla klientów, którzy chcą przeprowadzić migrację do środowiska App Service Environment w wersji 3 z zerowym przestojem i mogą obsługiwać użycie innej podsieci dla nowego środowiska. Jeśli musisz użyć tej samej podsieci i może obsługiwać około godziny przestoju aplikacji, zobacz funkcję migracji w miejscu. Aby uzyskać opcje migracji ręcznej, które umożliwiają migrację we własnym tempie, zobacz opcje migracji ręcznej.

Ważne

Jeśli nie wykonasz wszystkich kroków opisanych w tym samouczku, wystąpi przestój. Jeśli na przykład nie zaktualizujesz wszystkich zasobów zależnych przy użyciu nowych adresów IP lub nie zezwolisz na dostęp do/z nowej podsieci, na przykład w przypadku niestandardowego magazynu kluczy sufiksów domeny, nastąpi przestój do czasu rozwiązania tego problemu.

Zaleca się używanie tej funkcji w środowiskach deweloperskich przed migracją wszystkich środowisk produkcyjnych do próby procesu i upewnienia się, że nie ma nieoczekiwanych problemów. Przekaż wszelkie opinie dotyczące tego artykułu lub funkcji przy użyciu przycisków w dolnej części strony.

Obsługiwane scenariusze

Obecnie funkcja migracji równoległej nie obsługuje migracji do środowiska App Service Environment w wersji 3 w następujących regionach:

Publiczna platforma Azure

  • Środkowe Zjednoczone Emiraty Arabskie

Azure Government

  • US DoD (region środkowy)
  • US DoD (region wschodni)
  • US Gov Arizona
  • US Gov Teksas
  • US Gov Wirginia

Platforma Microsoft Azure obsługiwana przez firmę 21Vianet

  • Chiny Wschodnie 2
  • Chiny Północne 2

Następujące konfiguracje środowiska App Service Environment można migrować przy użyciu funkcji migracji równoległej. Tabela zawiera konfigurację środowiska App Service Environment w wersji 3 w przypadku korzystania z funkcji migracji równoległej na podstawie istniejącego środowiska App Service Environment.

Konfigurowanie Konfiguracja środowiska App Service Environment w wersji 3
Środowisko App Service Environment wewnętrznego modułu równoważenia obciążenia (ILB) w wersji 2 Środowisko App Service Environment modułu równoważenia obciążenia w wersji 3
Zewnętrzne (ELB/Internet połączone z publicznym adresem IP) App Service Environment w wersji 2 ELB App Service Environment v3
Środowisko App Service Environment modułu równoważenia obciążenia w wersji 2 z sufiksem domeny niestandardowej Środowisko App Service Environment modułu równoważenia obciążenia w wersji 3 z sufiksem domeny niestandardowej

Środowisko App Service Environment w wersji 3 można wdrożyć jako strefowo nadmiarowe. Nadmiarowość strefy można włączyć, o ile środowisko App Service Environment w wersji 3 znajduje się w regionie obsługującym nadmiarowość strefy.

Jeśli chcesz, aby nowe środowisko App Service Environment w wersji 3 używało sufiksu domeny niestandardowej i obecnie nie używasz tego sufiksu domeny niestandardowej, można skonfigurować w dowolnym momencie po zakończeniu migracji. Aby uzyskać więcej informacji, zobacz Konfigurowanie niestandardowego sufiksu domeny dla środowiska App Service Environment. Jeśli istniejące środowisko ma sufiks domeny niestandardowej i nie chcesz go już używać, musisz skonfigurować sufiks domeny niestandardowej na potrzeby migracji. Po zakończeniu migracji można usunąć sufiks domeny niestandardowej.

Ograniczenia funkcji migracji równoległej

Poniżej przedstawiono ograniczenia dotyczące korzystania z funkcji migracji równoległej:

  • Nowe środowisko App Service Environment w wersji 3 znajduje się w innej podsieci, ale w tej samej sieci wirtualnej co istniejące środowisko.
  • Nie można zmienić regionu, w którym znajduje się środowisko App Service Environment.
  • Nie można migrować środowiska ELB App Service Environment do środowiska App Service Environment usługi równoważenia obciążenia w wersji 3 i na odwrót.
  • Jeśli istniejące środowisko App Service Environment używa niestandardowego sufiksu domeny, podczas procesu migracji należy skonfigurować niestandardowy sufiks domeny dla środowiska App Service Environment w wersji 3.
    • Jeśli nie chcesz już używać niestandardowego sufiksu domeny, możesz go usunąć po zakończeniu migracji.
  • Funkcja migracji równoległej jest dostępna tylko przy użyciu interfejsu wiersza polecenia lub interfejsu API REST. Ta funkcja nie jest dostępna w witrynie Azure Portal.

Środowisko App Service Environment w wersji 3 nie obsługuje następujących funkcji, których można używać z bieżącym środowiskiem App Service Environment w wersji 2.

  • Konfiguracja powiązania protokołu TLS/SSL opartego na adresach IP z aplikacjami.
  • Środowisko App Service Environment w wersji 3 nie wraca do usługi Azure DNS, jeśli skonfigurowane niestandardowe serwery DNS w sieci wirtualnej nie mogą rozpoznać danej nazwy. Jeśli to zachowanie jest wymagane, upewnij się, że korzystasz z usługi przesyłania dalej do publicznego systemu DNS lub dołącz usługę Azure DNS na liście niestandardowych serwerów DNS.

Funkcja migracji równoległej nie obsługuje następujących scenariuszy. Zobacz opcje migracji ręcznej, jeśli środowisko App Service Environment należy do jednej z tych kategorii.

  • Środowisko App Service Environment w wersji 1
    • Wersję środowiska App Service Environment można znaleźć, przechodząc do środowiska App Service Environment w witrynie Azure Portal i wybierając pozycję Konfiguracja w obszarze Ustawienia po lewej stronie. Możesz również użyć Eksploratora zasobów platformy Azure i przejrzeć wartość kind właściwości dla środowiska App Service Environment.
    • Jeśli masz środowisko App Service Environment w wersji 1, możesz przeprowadzić migrację przy użyciu funkcji migracji w miejscu lub jednej z opcji migracji ręcznej.
  • ELB App Service Environment w wersji 2 z adresami SSL IP
  • Przypięte strefy środowisko App Service Environment w wersji 2
  • Środowisko App Service Environment o nazwie, która nie spełnia limitów znaków. Cała nazwa, w tym sufiks domeny, musi zawierać maksymalnie 64 znaki. Na przykład: my-ase-name.appserviceenvironment.net dla modułu równoważenia obciążenia i my-ase-name.p.azurewebsites.net dla elB musi zawierać 64 znaki lub mniej. Jeśli nie spełniasz limitu znaków, musisz przeprowadzić migrację ręcznie. Limity znaków dotyczące nazwy środowiska App Service Environment są następujące:
    • Limit znaków nazwy środowiska App Service Environment modułu równoważenia obciążenia: 36 znaków
    • Limit znaków nazwy środowiska APLIKACJI ELB: 42 znaki

Platforma App Service przegląda środowisko App Service Environment w celu potwierdzenia obsługi migracji równoległej. Jeśli scenariusz nie przejdzie wszystkich testów weryfikacji, nie możesz przeprowadzić migracji w tej chwili przy użyciu funkcji migracji równoległej. Jeśli środowisko jest w złej kondycji lub jest w stanie wstrzymania, nie można przeprowadzić migracji, dopóki nie wprowadzisz wymaganych aktualizacji.

Uwaga

Środowisko App Service Environment w wersji 3 nie obsługuje protokołu IP SSL. Jeśli używasz protokołu IP SSL, przed migracją do środowiska App Service Environment w wersji 3 należy usunąć wszystkie powiązania SSL ip. Funkcja migracji będzie obsługiwać środowisko po usunięciu wszystkich powiązań PROTOKOŁU SSL protokołu IP.

Rozwiązywanie problemów

Jeśli środowisko App Service Environment nie przejdzie kontroli poprawności lub spróbujesz wykonać krok migracji w nieprawidłowej kolejności, zostanie wyświetlony jeden z następujących komunikatów o błędach:

Komunikat o błędzie opis Zalecenie
Migracja może być wywoływana tylko w środowisku ASE w sieci wirtualnej arm, a to środowisko ASE znajduje się w klasycznej sieci wirtualnej. Środowiska App Service Environment w klasycznych sieciach wirtualnych nie mogą migrować przy użyciu funkcji migracji równoległej. Migrowanie przy użyciu jednej z opcji migracji ręcznej.
Migracja ASEv3 nie jest jeszcze gotowa. Podstawowa infrastruktura nie jest gotowa do obsługi środowiska App Service Environment w wersji 3. Migrowanie przy użyciu jednej z opcji migracji ręcznej, jeśli chcesz przeprowadzić migrację natychmiast. W przeciwnym razie poczekaj, aż funkcja migracji równoległej będzie dostępna w Twoim regionie.
Nie można włączyć nadmiarowości strefy dla tego środowiska ASE. Region, w którym znajduje się środowisko App Service Environment, nie obsługuje nadmiarowości strefy. Jeśli musisz włączyć nadmiarowość strefy, użyj jednej z opcji migracji ręcznej, aby przeprowadzić migrację do regionu obsługującego nadmiarowość strefy.
W tej chwili nie można wywołać migracji dla tego niestandardowego środowiska ASE sufiksu DNS. Migracja sufiksu domeny niestandardowej jest zablokowana. Otwórz zgłoszenie do pomocy technicznej, aby zaangażować pomoc techniczną w celu rozwiązania problemu.
W tej chwili nie można wywołać strefowo nadmiarowej migracji środowiska ASE. Migracja strefowo nadmiarowego środowiska App Service Environment jest zablokowana. Otwórz zgłoszenie do pomocy technicznej, aby zaangażować pomoc techniczną w celu rozwiązania problemu.
Nie można wywołać migracji w przypadku środowiska ASEv2 przypiętego do strefy. W tej chwili nie można migrować przypiętego środowiska App Service Environment w wersji 2 przy użyciu funkcji migracji równoległej. Migrowanie przy użyciu jednej z opcji migracji ręcznej, jeśli chcesz przeprowadzić migrację natychmiast.
Istniejąca operacja przywracania migracji trwa, spróbuj ponownie później. Poprzednia próba migracji jest przywracana. Przed ponowną próbą rozpoczęcia migracji poczekaj na zakończenie przywracania, który jest w toku.
Properties.VirtualNetwork.Id powinien zawierać identyfikator zasobu podsieci. Błąd pojawia się, jeśli próbujesz przeprowadzić migrację bez podawania nowej podsieci do umieszczenia środowiska App Service Environment w wersji 3. Upewnij się, że postępuj zgodnie ze wskazówkami i wykonaj krok w celu zidentyfikowania podsieci używanej dla środowiska App Service Environment w wersji 3.
Nie można przejść do <requested phase> z bieżącej fazy <previous phase> migracji przestojów. Ten błąd pojawia się, jeśli próbujesz wykonać krok migracji w nieprawidłowej kolejności. Upewnij się, że wykonasz kroki migracji w podanej kolejności.
Nie można uruchomić operacji przywracania w środowisku ASE w stanie hybrydowym. Spróbuj ponownie później. Ten błąd pojawia się, jeśli spróbujesz przywrócić migrację, ale coś pójdzie nie tak. Ten błąd nie ma wpływu na stare lub nowe środowisko. Otwórz zgłoszenie do pomocy technicznej, aby zaangażować pomoc techniczną w celu rozwiązania problemu.
Nie można migrować tego środowiska ASE bez przestoju. Ten błąd pojawia się, jeśli spróbujesz użyć funkcji migracji równoległej w środowisku App Service Environment w wersji 1. Funkcja migracji równoległej nie obsługuje środowiska App Service Environment w wersji 1. Migrowanie przy użyciu funkcji migracji w miejscu lub jednej z opcji migracji ręcznej.
Migracja nie jest dostępna dla tej subskrypcji. Pomoc techniczna musi być zaangażowana w migrację tego środowiska App Service Environment. Otwórz zgłoszenie do pomocy technicznej, aby zaangażować pomoc techniczną w celu rozwiązania problemu.
Nie można wywołać migracji strefowo nadmiarowej, ponieważ adresy IP utworzone podczas wstępnej migracji nie są strefowo nadmiarowe. Ten błąd pojawia się w przypadku próby migracji strefowo nadmiarowej, ale adresy IP wygenerowane podczas kroku generowania adresów IP nie zostały utworzone jako strefowo nadmiarowe. Platforma próbuje zwolnić wszystkie adresy IP strefowo, aby zapewnić odporność zaplecza. Otwórz zgłoszenie do pomocy technicznej, aby zaangażować pomoc techniczną, jeśli musisz włączyć nadmiarowość strefy. Inżynierowie będą przywracać migrację i zezwalać na kolejną próbę utworzenia adresów IP. W przeciwnym razie można przeprowadzić migrację bez włączania nadmiarowości strefy.
Nie można wywołać migracji, jeśli protokół IP SSL jest włączony w żadnej z lokacji. Nie można migrować środowisk App Service Environment z włączoną obsługą protokołu IP SSL przy użyciu funkcji migracji równoległej. Usuń protokół IP SSL ze wszystkich aplikacji w środowisku App Service Environment, aby włączyć funkcję migracji.
Nie można przeprowadzić migracji w tej samej podsieci. Błąd zostanie wyświetlony, jeśli określisz tę samą podsieć, w której znajduje się bieżące środowisko w celu umieszczenia środowiska App Service Environment w wersji 3. Musisz określić inną podsieć dla środowiska App Service Environment w wersji 3. Jeśli musisz użyć tej samej podsieci, przeprowadź migrację przy użyciu funkcji migracji w miejscu.
Subskrypcja ma zbyt wiele środowisk App Service Environment. Usuń niektóre przed próbą utworzenia więcej. Przekroczono limit przydziału środowiska App Service Environment dla twojej subskrypcji . Usuń niepotrzebne środowiska lub skontaktuj się z pomocą techniczną, aby przejrzeć opcje.
Nie można wywołać migracji w tym ase do momentu zakończenia aktywnego uaktualnienia. Nie można migrować środowisk App Service Environment podczas uaktualniania platformy. Możesz ustawić preferencje uaktualniania w witrynie Azure Portal. Uaktualnienie trwa od 8 do 12 godzin lub dłużej w zależności od rozmiaru (liczby wystąpień/rdzeni) środowiska App Service Environment. Poczekaj na zakończenie uaktualnienia, a następnie zmigruj.
Trwa operacja zarządzania środowiska App Service Environment. Środowisko App Service Environment przechodzi operację zarządzania. Te operacje mogą obejmować działania, takie jak wdrożenia lub uaktualnienia. Migracja zostanie zablokowana do czasu ukończenia tych operacji. Po zakończeniu tych operacji można przeprowadzić migrację.
Moduł InteralLoadBalancingMode nie jest obecnie obsługiwany. Środowiska usługi App Service, które mają ustawienie InternalLoadBalancingMode na określone wartości, nie mogą być obecnie migrowane przy użyciu funkcji migracji. Zespół firmy Microsoft musi ręcznie zmienić element InternalLoadBalancingMode. Otwórz zgłoszenie do pomocy technicznej, aby zaangażować pomoc techniczną w celu rozwiązania problemu. Zażądaj aktualizacji elementu InternalLoadBalancingMode.
Nie można wywołać pełnej migracji przed wygenerowaniem adresów IP. Ten błąd pojawia się, jeśli próbujesz przeprowadzić migrację przed zakończeniem kroków premii. Przed podjęciem próby migracji upewnij się, że wykonasz wszystkie kroki premigration. Zobacz przewodnik krok po kroku dotyczący migracji.
Nie można wywołać pełnej migracji na platformie Ase z niestandardowym zestawem sufiksów DNS, ale bez skonfigurowanej niestandardowej konfiguracji sufiksu DNS asev3. Istniejące środowisko App Service Environment używa niestandardowego sufiksu domeny. Podczas procesu migracji należy skonfigurować sufiks domeny niestandardowej dla środowiska App Service Environment w wersji 3. Konfigurowanie sufiksu domeny niestandardowej. Jeśli nie chcesz już używać niestandardowego sufiksu domeny, możesz go usunąć po zakończeniu migracji.

Omówienie procesu migracji przy użyciu funkcji migracji równoległej

Migracja równoległa składa się z serii kroków, które należy wykonać w podanej kolejności. Dla każdego zbioru kroków podane są kluczowe elementy. Ważne jest, aby zrozumieć, co się dzieje podczas tych kroków i jak ma to wpływ na środowisko i aplikacje. Po przejrzeniu poniższych informacji i dokonaniu migracji postępuj zgodnie z przewodnikiem krok po kroku..

Sprawdź, czy migracja jest obsługiwana przy użyciu funkcji migracji równoległej dla środowiska App Service Environment

Platforma sprawdza, czy środowisko App Service Environment można migrować przy użyciu funkcji migracji równoległej. Jeśli środowisko App Service Environment nie przejdzie wszystkich testów sprawdzania poprawności, nie można w tej chwili przeprowadzić migracji przy użyciu funkcji migracji równoległej. Zobacz sekcję rozwiązywania problemów, aby uzyskać szczegółowe informacje o możliwych przyczynach niepowodzenia walidacji. Jeśli środowisko jest w złej kondycji lub jest w stanie wstrzymania, nie można przeprowadzić migracji, dopóki nie wprowadzisz wymaganych aktualizacji. Jeśli nie możesz przeprowadzić migracji przy użyciu funkcji migracji równoległej, zobacz opcje migracji ręcznej.

Walidacja sprawdza również, czy środowisko App Service Environment korzysta z minimalnej kompilacji wymaganej do migracji. Ta kompilacja może być nowsza niż standardowa kompilacja wdrożona z rutynowym cyklem uaktualniania/konserwacji platformy. Minimalna kompilacja jest okresowo aktualizowana w celu zapewnienia dostępności najnowszych poprawek błędów i ulepszeń. Jeśli środowisko App Service Environment nie korzysta z minimalnej kompilacji, musisz samodzielnie rozpocząć uaktualnianie. To standardowy proces, w którym nie ma to wpływu na środowisko App Service Environment, ale nie można skalować ani wprowadzać zmian w środowisku App Service Environment podczas uaktualniania. Nie można przeprowadzić migracji do momentu zakończenia uaktualniania. Ukończenie uaktualnienia może potrwać od 8 do 12 godzin w zależności od rozmiaru środowiska. Jeśli planujesz określony przedział czasu migracji, należy uruchomić sprawdzanie poprawności 24–48 godzin przed zaplanowanym czasem migracji, aby upewnić się, że masz czas na uaktualnienie, jeśli jest to konieczne.

Wybierz i przygotuj podsieć dla nowego środowiska App Service Environment w wersji 3

Platforma tworzy nowe środowisko App Service Environment w wersji 3 w innej podsieci niż istniejące środowisko App Service Environment. Musisz wybrać podsieć spełniającą następujące wymagania:

  • Podsieć musi znajdować się w tej samej sieci wirtualnej, a tym samym regionie, co istniejące środowisko App Service Environment.
    • Jeśli sieć wirtualna nie ma dostępnej podsieci, musisz je utworzyć. Może być konieczne zwiększenie przestrzeni adresowej sieci wirtualnej w celu utworzenia nowej podsieci. Aby uzyskać więcej informacji, zobacz Tworzenie sieci wirtualnej.
  • Podsieć musi być w stanie komunikować się z podsiecią, w których znajduje się istniejące środowisko App Service Environment. Upewnij się, że nie istnieją sieciowe grupy zabezpieczeń ani inne konfiguracje sieci, które uniemożliwiłyby komunikację między podsieciami.
  • Podsieć musi mieć pojedyncze delegowanie Microsoft.Web/hostingEnvironments.
  • Podsieć musi mieć wystarczającą ilość dostępnych adresów IP, aby obsługiwać nowe środowisko App Service Environment w wersji 3. Wymagana liczba adresów IP zależy od liczby wystąpień, których chcesz użyć dla nowego środowiska App Service Environment w wersji 3. Aby uzyskać więcej informacji, zobacz Sieć środowiska usługi App Service v3.
  • Podsieć nie może mieć żadnych blokad zastosowanych do niej. Jeśli istnieją blokady, należy je usunąć przed migracją. Blokady można odczytać w razie potrzeby po zakończeniu migracji. Aby uzyskać więcej informacji na temat blokad i dziedziczenia blokad, zobacz Blokowanie zasobów w celu ochrony infrastruktury.
  • Nie można zablokować żadnych zasad platformy Azure blokujących migrację ani powiązanych akcji. Jeśli istnieją zasady blokujące tworzenie środowisk App Service Environment lub modyfikację podsieci, należy je usunąć przed migracją. Zasady można odczytywać w razie potrzeby po zakończeniu migracji. Aby uzyskać więcej informacji na temat usługi Azure Policy, zobacz Omówienie usługi Azure Policy.

Generowanie wychodzących adresów IP dla nowego środowiska App Service Environment w wersji 3

Platforma tworzy nowe wychodzące adresy IP. Chociaż te adresy IP są tworzone, aktywność z istniejącym środowiskiem App Service Environment nie jest przerywana, nie można jednak skalować ani wprowadzać zmian w istniejącym środowisku. Ten proces zajmuje około 15 minut.

Po zakończeniu zostaną utworzone nowe adresy IP ruchu wychodzącego używane przez przyszłe środowisko App Service Environment w wersji 3. Te nowe adresy IP nie mają wpływu na istniejące środowisko.

Po zakończeniu migracji otrzymasz nowy adres IP dla ruchu przychodzącego, ale przed wprowadzeniem zmiany DNS w celu przekierowania ruchu klienta do nowego środowiska App Service Environment w wersji 3. Nie uzyskujesz w tym momencie przychodzącego adresu IP w tym procesie, ponieważ istnieją zależności od zasobów środowiska App Service Environment w wersji 3, które są tworzone podczas kroku migracji. Przed przekierowaniem ruchu do nowego środowiska App Service Environment w wersji 3 możesz zaktualizować wszystkie zasoby zależne od nowego adresu IP przychodzącego.

Aktualizowanie zasobów zależnych przy użyciu nowych wychodzących adresów IP

Nowe adresy IP ruchu wychodzącego są tworzone i przekazywane przed rozpoczęciem rzeczywistej migracji. Nowy domyślny ruch wychodzący do internetowych adresów publicznych jest podawany, aby można było dostosować wszelkie zewnętrzne zapory, routing DNS, sieciowe grupy zabezpieczeń i wszelkie inne zasoby, które opierają się na tych adresach IP przed ukończeniem migracji. Twoim obowiązkiem jest zaktualizowanie wszystkich zasobów, które będą mieć wpływ na zmianę adresu IP skojarzona z nowym środowiskiem App Service Environment w wersji 3. Nie przechodzij do następnego kroku, dopóki nie wprowadzisz wszystkich wymaganych aktualizacji. W trakcie i po kroku migracji może wystąpić przestój, jeśli masz zależności od wychodzących adresów IP i nie można wprowadzić wszystkich niezbędnych aktualizacji. Jest to spowodowane tym, że po rozpoczęciu migracji, mimo że ruch nadal przechodzi do frontonów środowiska App Service Environment w wersji 2, bazowe zasoby obliczeniowe są nowym środowiskiem App Service Environment w wersji 3 w nowej podsieci.

Ten krok to również dobry moment na przejrzenie zmian zależności sieci dla ruchu przychodzącego i wychodzącego podczas przechodzenia do środowiska App Service Environment w wersji 3, w tym zmiany portu dla sondy kondycji usługi Azure Load Balancer, która teraz używa portu 80.

Delegowanie podsieci środowiska App Service Environment

Środowisko App Service Environment w wersji 3 wymaga, aby podsieć miała pojedyncze delegowanie Microsoft.Web/hostingEnvironments. Migracja nie powiedzie się, jeśli podsieć środowiska App Service Environment nie jest delegowana lub delegujesz ją do innego zasobu. Upewnij się, że podsieć wybrana dla nowego środowiska App Service Environment w wersji 3 ma jedno delegowanie Microsoft.Web/hostingEnvironments.

Potwierdzanie zmian rozmiaru wystąpienia

Plany usługi App Service są tworzone przy użyciu odpowiedniej jednostki SKU izolowanej w wersji 2 w ramach migracji. Na przykład plany I2 odpowiadają I2v2. Aplikacje mogą być nadmiernie aprowizowane po migracji, ponieważ warstwa Izolowana w wersji 2 ma więcej pamięci i procesora CPU na odpowiedni rozmiar wystąpienia. Istnieje możliwość skalowania środowiska zgodnie z potrzebami po zakończeniu migracji. Aby uzyskać więcej informacji, zapoznaj się ze szczegółami jednostki SKU.

Upewnij się, że nie ma żadnych blokad zasobów

Sieć wirtualna blokuje operacje platformy podczas migracji. Jeśli sieć wirtualna ma blokady, przed migracją należy je usunąć. Blokady można odczytać w razie potrzeby po zakończeniu migracji. Blokady mogą istnieć w trzech różnych zakresach: subskrypcji, grupie zasobów i zasobie. Po zastosowaniu blokady w zakresie nadrzędnym wszystkie zasoby w tym zakresie dziedziczą tę samą blokadę. Jeśli blokady zostały zastosowane w ramach subskrypcji, grupy zasobów lub zakresu zasobów, należy je usunąć przed migracją. Aby uzyskać więcej informacji na temat blokad i dziedziczenia blokad, zobacz Blokowanie zasobów w celu ochrony infrastruktury.

Upewnij się, że nie ma żadnych zasad platformy Azure blokujących migrację

Usługa Azure Policy może służyć do odmowy tworzenia zasobów i modyfikowania określonych podmiotów zabezpieczeń. Jeśli masz zasady blokujące tworzenie środowisk App Service Environment lub modyfikację podsieci, należy ją usunąć przed migracją. Zasady można odczytywać w razie potrzeby po zakończeniu migracji. Aby uzyskać więcej informacji na temat usługi Azure Policy, zobacz Omówienie usługi Azure Policy.

Dodawanie niestandardowego sufiksu domeny (opcjonalnie)

Jeśli istniejące środowisko App Service Environment używa niestandardowego sufiksu domeny, należy skonfigurować niestandardowy sufiks domeny dla nowego środowiska App Service Environment w wersji 3. Niestandardowy sufiks domeny w środowisku App Service Environment w wersji 3 jest implementowany inaczej niż w środowisku App Service Environment w wersji 2. Musisz podać niestandardową nazwę domeny, tożsamość zarządzaną i certyfikat, który musi być przechowywany w usłudze Azure Key Vault. Aby uzyskać więcej informacji na temat niestandardowego sufiksu domeny środowiska App Service Environment w wersji 3, w tym wymagań, instrukcji krok po kroku i najlepszych rozwiązań, zobacz Konfigurowanie niestandardowego sufiksu domeny dla środowiska App Service Environment. Jeśli środowisko App Service Environment w wersji 2 ma niestandardowy sufiks domeny, należy skonfigurować niestandardowy sufiks domeny dla nowego środowiska, nawet jeśli nie chcesz już go używać. Po zakończeniu migracji można w razie potrzeby usunąć konfigurację sufiksu domeny niestandardowej.

Jeśli migracja zawiera sufiks domeny niestandardowej, w przypadku środowiska App Service Environment w wersji 3 domena niestandardowa nie jest wyświetlana w sekcji Podstawy na stronie Przegląd portalu, ponieważ dotyczy środowiska App Service Environment w wersji 1/2. Zamiast tego w przypadku środowiska App Service Environment w wersji 3 przejdź do strony sufiksu domeny niestandardowej, na której można potwierdzić poprawną konfigurację sufiksu domeny niestandardowej. Ponadto w środowisku App Service Environment w wersji 2, jeśli masz sufiks domeny niestandardowej, domyślna nazwa hosta zawiera sufiks domeny niestandardowej i znajduje się w formularzu APP-NAME.internal.contoso.com. W środowisku App Service Environment w wersji 3 domyślna nazwa hosta zawsze używa domyślnego sufiksu domeny i ma postać APP-NAME.ASE-NAME.appserviceenvironment.net. Ta różnica polega na tym, że środowisko App Service Environment w wersji 3 zachowuje domyślny sufiks domeny podczas dodawania niestandardowego sufiksu domeny. W środowisku App Service Environment w wersji 2 istnieje tylko jeden sufiks domeny.

Migracja do środowiska App Service Environment w wersji 3

Po wykonaniu poprzednich kroków należy jak najszybciej kontynuować migrację.

Podczas migracji nie ma przestoju aplikacji, ale podobnie jak w kroku generowania adresów IP, nie można skalować, modyfikować istniejącego środowiska App Service Environment ani wdrażać w nim aplikacji podczas tego procesu.

Ważne

Ponieważ skalowanie jest blokowane podczas migracji, przed rozpoczęciem migracji należy skalować środowisko do żądanego rozmiaru.

W tym kroku decydujesz się również, czy chcesz włączyć nadmiarowość strefową dla nowego środowiska App Service Environment w wersji 3. Nadmiarowość strefy można włączyć, o ile środowisko App Service Environment w wersji 3 znajduje się w regionie obsługującym nadmiarowość strefy.

Migracja równoległa wymaga od trzech do sześciu godzin okna usługi dla migracji środowiska App Service Environment w wersji 2 do wersji 3. Podczas migracji konfiguracje skalowania i środowiska są blokowane i występują następujące zdarzenia:

  • Nowe środowisko App Service Environment w wersji 3 jest tworzone w wybranej podsieci.
  • Nowe plany usługi App Service są tworzone w nowym środowisku App Service Environment w wersji 3 z odpowiednią warstwą Izolowana w wersji 2.
  • Aplikacje są tworzone w nowym środowisku App Service Environment w wersji 3.
  • Podstawowe zasoby obliczeniowe/procesy robocze dla aplikacji są przenoszone do nowego środowiska App Service Environment w wersji 3, co oznacza, że aplikacje są teraz uruchomione w środowisku App Service Environment w wersji 3. Jednak frontony środowiska App Service Environment w wersji 2 są domyślnie nadal uruchomione i obsługują ruch. Stary adres IP ruchu przychodzącego pozostaje w użyciu, ale nowe adresy IP ruchu wychodzącego są używane. Ponadto nowe frontony środowiska App Service Environment w wersji 3 są tworzone i gotowe do obsługi ruchu.
    • W przypadku środowisk App Service Environment wewnętrznego modułu równoważenia obciążenia frontony środowiska App Service Environment w wersji 3 nie są używane do momentu zaktualizowania prywatnych stref DNS przy użyciu nowego przychodzącego adresu IP.
    • W przypadku środowisk ELB App Service Environment proces migracji nie przekierowuje ruchu do frontonów środowiska App Service Environment w wersji 3 do momentu ukończenia ostatniego kroku migracji.

Po zakończeniu tego kroku ruch aplikacji będzie nadal kierowany do starych frontonów środowiska App Service Environment w wersji 2 i przypisanego do niego adresu IP ruchu przychodzącego. Jednak twoje aplikacje działają w przypadku procesów roboczych w nowym środowisku App Service Environment w wersji 3.

Uwaga

Ze względu na znaną usterkę zadania sieci Web mogą nie być uruchamiane podczas kroku wdrażania hybrydowego. Jeśli używasz zadań internetowych, ta usterka może spowodować problemy/przestój aplikacji. Otwórz zgłoszenie do pomocy technicznej, jeśli masz pytania lub wątpliwości dotyczące tego problemu.

Uzyskiwanie przychodzącego adresu IP dla nowego środowiska App Service Environment w wersji 3 i aktualizowanie zasobów zależnych

Nowy adres IP dla ruchu przychodzącego jest podawany tak, aby można było skonfigurować nowe punkty końcowe z usługami, takimi jak Traffic Manager lub Azure Front Door , i zaktualizować dowolne z prywatnych stref DNS. Nie przechodzij do następnego kroku, dopóki nie wprowadzisz tych zmian. Występuje przestój, jeśli nie zaktualizujesz zasobów zależnych przy użyciu nowego przychodzącego adresu IP. Twoim zadaniem jest zaktualizowanie wszystkich zasobów, na które ma wpływ zmiana adresu IP skojarzona z nowym środowiskiem App Service Environment w wersji 3. Nie przechodzij do następnego kroku, dopóki nie wprowadzisz wszystkich wymaganych aktualizacji.

Przekieruj ruch klientów, zweryfikuj środowisko App Service Environment w wersji 3 i ukończ migrację

Ostatnim krokiem jest przekierowanie ruchu do nowego frontonu środowiska App Service Environment w wersji 3 i ukończenie migracji. Przed wykonaniem tego kroku należy przejrzeć nowe środowisko App Service Environment w wersji 3 i wykonać wszelkie wymagane testy, aby sprawdzić, czy działa zgodnie z oczekiwaniami. Domyślnie ruch przechodzi do frontonów środowiska App Service Environment w wersji 2. Jeśli używasz środowiska App Service Environment wewnętrznego modułu równoważenia obciążenia w wersji 3, możesz przetestować frontony środowiska App Service Environment w wersji 3, aktualizując prywatną strefę DNS przy użyciu nowego przychodzącego adresu IP. Jeśli używasz środowiska ELB App Service Environment w wersji 3, proces testowania zależy od określonej konfiguracji sieci. Jedną z prostych metod testowania dla środowisk ELB jest zaktualizowanie pliku hostów w celu użycia nowego adresu IP przychodzącego środowiska App Service Environment w wersji 3. Jeśli masz domeny niestandardowe przypisane do poszczególnych aplikacji, możesz też zaktualizować ich system DNS tak, aby wskazywał nowy przychodzący adres IP. Testowanie tej zmiany pozwala w pełni zweryfikować środowisko App Service Environment w wersji 3 przed zainicjowanym ostatnim krokiem migracji, w którym stare środowisko App Service Environment zostało usunięte.

Gdy wszystko będzie gotowe do przekierowania ruchu, możesz ukończyć ostatni krok migracji. Ten krok aktualizuje wewnętrzne/platformowe rekordy DNS, aby wskazywały adres IP modułu równoważenia obciążenia nowego środowiska App Service Environment w wersji 3 oraz frontony utworzone podczas migracji. Zmiany są skuteczne w ciągu kilku minut. Twoim zadaniem jest zaktualizowanie rekordów DNS w celu wskazania nowego przychodzącego adresu IP. Jeśli wystąpią problemy lub przestój aplikacji, sprawdź ustawienia pamięci podręcznej i czasu wygaśnięcia. Ten krok powoduje również zamknięcie starego środowiska App Service Environment i usunięcie go. Nowe środowisko App Service Environment w wersji 3 jest teraz środowiskiem produkcyjnym.

Ważne

Platforma gwarantuje środowisko migracji bez przestojów. Jednak ustawienia DNS mogą spowodować przestój podczas kroku zmiany DNS. Może to być spowodowane problemami TTL i ustawieniami pamięci podręcznej, ponieważ ruch może być nadal kierowany do starego środowiska App Service Environment po zmianie dns. Należy przejrzeć ustawienia DNS i upewnić się, że masz niski czas wygaśnięcia i że dostawca DNS obsługuje szybką propagację. Jeśli masz wysoki czas wygaśnięcia, może wystąpić przestój podczas kroku zmiany DNS.

Uwaga

Ważne jest, aby wykonać ten krok tak szybko, jak to możliwe. Gdy środowisko App Service Environment jest w stanie hybrydowym, nie może odbierać uaktualnień platformy i poprawek zabezpieczeń, co sprawia, że jest bardziej podatny na niestabilność i zagrożenia bezpieczeństwa.

Jeśli wykryjesz jakiekolwiek problemy z nowym środowiskiem App Service Environment w wersji 3, nie uruchom polecenia w celu przekierowania ruchu klientów. To polecenie inicjuje również usunięcie środowiska App Service Environment w wersji 2. Jeśli znajdziesz problem, skontaktuj się z pomocą techniczną.

Używanie funkcji migracji równoległej

Wymagania wstępne

Upewnij się, że rozumiesz, jak migracja do środowiska App Service Environment w wersji 3 wpływa na aplikacje. Zapoznaj się z procesem migracji w całości, aby zrozumieć oś czasu procesu i gdzie i kiedy trzeba się zaangażować. Zapoznaj się również z często zadawanych pytań, które mogą odpowiedzieć na niektóre pytania.

Upewnij się, że w sieci wirtualnej, grupach zasobów, zasobach lub subskrypcji nie ma żadnych blokad. Blokuje operacje platformy podczas migracji.

Upewnij się, że żadne zasady platformy Azure nie blokują akcji wymaganych do migracji, w tym modyfikacji podsieci i tworzenia zasobów usługi aplikacja systemu Azure. Zasady blokujące modyfikacje zasobów i tworzenie mogą spowodować zablokowanie lub niepowodzenie migracji.

Ponieważ środowisko App Service Environment w wersji 3 znajduje się w innej podsieci w sieci wirtualnej, musisz upewnić się, że masz dostępną podsieć w sieci wirtualnej, która spełnia wymagania dotyczące podsieci dla środowiska App Service Environment w wersji 3. Wybrana podsieć musi również mieć możliwość komunikowania się z podsiecią, w której znajduje się istniejące środowisko App Service Environment. Upewnij się, że komunikacja między dwiema podsieciami nie blokuje żadnych blokowania. Jeśli nie masz dostępnej podsieci, musisz go utworzyć przed migracją. Utworzenie nowej podsieci może obejmować zwiększenie przestrzeni adresowej sieci wirtualnej. Aby uzyskać więcej informacji, zobacz Tworzenie sieci wirtualnej i podsieci.

Ponieważ skalowanie jest blokowane podczas migracji, przed rozpoczęciem migracji należy skalować środowisko do żądanego rozmiaru. Jeśli musisz skalować środowisko po migracji, możesz to zrobić po zakończeniu migracji.

Wykonaj kroki opisane tutaj w kolejności i zgodnie z opisem, ponieważ wywołujesz interfejs API REST platformy Azure. Zalecamy użycie interfejsu wiersza polecenia platformy Azure do wykonania tych wywołań interfejsu API. Aby uzyskać informacje o innych metodach, zobacz Dokumentacja interfejsu API REST platformy Azure.

W tym przewodniku zainstaluj interfejs wiersza polecenia platformy Azure lub użyj usługi Azure Cloud Shell i użyj powłoki Bash.

Uwaga

Zalecamy użycie powłoki Bash do uruchamiania poleceń podanych w tym przewodniku. Polecenia mogą nie być zgodne z konwencjami programu PowerShell i znakami ucieczki.

Ważne

Podczas migracji witryna Azure Portal może wyświetlać niepoprawne informacje o środowisku App Service Environment i aplikacjach. Nie przejdź do środowiska migracji w witrynie Azure Portal, ponieważ funkcja migracji równoległej nie jest dostępna. Zalecamy sprawdzenie stanu migracji przy użyciu interfejsu wiersza polecenia platformy Azure. Jeśli masz jakiekolwiek pytania dotyczące stanu migracji lub aplikacji, skontaktuj się z pomocą techniczną.

1. Wybierz podsieć dla nowego środowiska App Service Environment w wersji 3

Wybierz podsieć w środowisku App Service Environment w wersji 3 spełniającą wymagania podsieci środowiska App Service Environment w wersji 3. Zanotuj nazwę wybranej podsieci. Ta podsieć musi być inna niż podsieć, w których znajduje się istniejące środowisko App Service Environment.

2. Uzyskiwanie identyfikatora środowiska App Service Environment

Uruchom następujące polecenia, aby pobrać identyfikator środowiska App Service Environment i zapisać go jako zmienną środowiskową. Zastąp symbole zastępcze nazw i grup zasobów wartościami środowiska App Service Environment, które chcesz zmigrować. ASE_RG i VNET_RG są takie same, jeśli sieć wirtualna i środowisko App Service Environment znajdują się w tej samej grupie zasobów.

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

3. Sprawdzanie, czy migracja jest obsługiwana

Następujące polecenie sprawdza, czy środowisko App Service Environment jest obsługiwane do migracji. To polecenie sprawdza również, czy środowisko App Service Environment znajduje się w obsługiwanej wersji kompilacji na potrzeby migracji. Jeśli środowisko App Service Environment nie korzysta z obsługiwanej wersji kompilacji, musisz samodzielnie uruchomić uaktualnienie. Aby uzyskać więcej informacji na temat uaktualniania premii, zobacz Weryfikowanie, czy migracja jest obsługiwana przy użyciu funkcji migracji równoległej dla środowiska App Service Environment.

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

Jeśli nie ma żadnych błędów, migracja jest obsługiwana i możesz przejść do następnego kroku.

Jeśli musisz uruchomić uaktualnienie w celu uaktualnienia środowiska App Service Environment do obsługiwanej wersji kompilacji, co może potrwać od 8 do 12 godzin lub dłużej w zależności od rozmiaru środowiska, uruchom następujące polecenie. Uruchom to polecenie tylko wtedy, gdy krok weryfikacji zakończy się niepowodzeniem i zostanie wyświetlony monit o uaktualnienie środowiska App Service Environment.

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

4. Generowanie wychodzących adresów IP dla nowego środowiska App Service Environment w wersji 3

Uruchom następujące polecenie, aby utworzyć nowe wychodzące adresy IP. Wykonanie tego kroku trwa około 15 minut. Nie skaluj ani nie wprowadzaj zmian w istniejącym środowisku App Service Environment w tym czasie.

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

Uruchom następujące polecenie, aby sprawdzić stan tego kroku:

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

Jeśli krok jest w toku, otrzymasz stan Migrating. Po otrzymaniu Readystanu uruchom następujące polecenie, aby wyświetlić nowe adresy IP ruchu wychodzącego. Jeśli nowe adresy IP nie są widoczne natychmiast, zaczekaj kilka minut i spróbuj ponownie.

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

5. Aktualizowanie zasobów zależnych przy użyciu nowych wychodzących adresów IP

Korzystając z nowych adresów IP ruchu wychodzącego, zaktualizuj dowolne zasoby lub składniki sieciowe, aby upewnić się, że nowe środowisko działa zgodnie z oczekiwaniami po rozpoczęciu migracji. Twoim obowiązkiem jest wprowadzenie wszelkich niezbędnych aktualizacji. Nowe adresy IP ruchu wychodzącego są używane po utworzeniu środowiska App Service Environment w wersji 3 podczas kroku migracji. Jeśli na przykład masz niestandardowy sufiks domeny i usługę Azure Key Vault i zarządzasz ograniczeniami dostępu za pomocą zapory, musisz zaktualizować zaporę usługi Azure Key Vault, aby zezwolić tylko na nowe adresy IP ruchu wychodzącego lub całą nową podsieć.

6. Delegowanie podsieci środowiska App Service Environment

Środowisko App Service Environment w wersji 3 wymaga, aby podsieć miała pojedyncze delegowanie Microsoft.Web/hostingEnvironments. Poprzednie wersje nie wymagały tego delegowania. Przed migracją należy potwierdzić, że podsieć jest delegowana prawidłowo i zaktualizować delegowanie (w razie potrzeby). Delegowanie można zaktualizować, uruchamiając następujące polecenie lub przechodząc do podsieci w witrynie Azure Portal.

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

7. Upewnij się, że w sieci wirtualnej nie ma żadnych blokad

Sieć wirtualna blokuje operacje platformy podczas migracji. Jeśli sieć wirtualna ma blokady, przed migracją należy je usunąć. W razie potrzeby możesz dodać blokady po zakończeniu migracji.

Użyj następującego polecenia, aby sprawdzić, czy sieć wirtualna ma jakiekolwiek blokady:

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

Usuń wszystkie istniejące blokady przy użyciu następującego polecenia:

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

Aby uzyskać powiązane polecenia, aby sprawdzić, czy subskrypcja lub grupa zasobów ma blokady, zobacz dokumentację interfejsu wiersza polecenia platformy Azure dotyczącą blokad.

8. Przygotowywanie konfiguracji

Jeśli istniejące środowisko App Service Environment używa niestandardowego sufiksu domeny, należy skonfigurować go dla nowego zasobu środowiska App Service Environment w wersji 3 podczas procesu migracji. Migracja nie powiedzie się, jeśli nie skonfigurujesz niestandardowego sufiksu domeny i obecnie używasz go. Aby uzyskać więcej informacji na temat niestandardowych sufiksów domeny środowiska App Service Environment w wersji 3, w tym wymagań, instrukcji krok po kroku i najlepszych rozwiązań, zobacz Niestandardowy sufiks domeny dla środowisk App Service Environment.

Uwaga

Jeśli konfigurujesz sufiks domeny niestandardowej, podczas dodawania uprawnień sieci w magazynie kluczy platformy Azure upewnij się, że magazyn kluczy zezwala na dostęp z nowej podsieci środowiska App Service Environment w wersji 3. Jeśli uzyskujesz dostęp do magazynu kluczy przy użyciu prywatnego punktu końcowego, upewnij się, że dostęp prywatny został poprawnie skonfigurowany z nową podsiecią. Wystąpił przestój, jeśli nie można poprawnie ustawić tego dostępu przed migracją.

Możesz zwolnić nową strefę środowiska App Service Environment w wersji 3, jeśli istniejące środowisko znajduje się w regionie obsługującym nadmiarowość stref. Nadmiarowość strefy można skonfigurować, ustawiając zoneRedundant właściwość na true. Nadmiarowość strefy jest opcjonalną konfiguracją. Tę konfigurację można ustawić tylko podczas tworzenia nowego środowiska App Service Environment w wersji 3 i nie można jej usunąć później.

Aby ustawić te konfiguracje, w tym zidentyfikować wybraną wcześniej podsieć, utwórz plik o nazwie parameters.json z następującymi szczegółami na podstawie danego scenariusza. Pamiętaj, aby użyć nowej podsieci wybranej dla nowego środowiska App Service Environment w wersji 3. Nie uwzględniaj właściwości sufiksu domeny niestandardowej, jeśli ta funkcja nie ma zastosowania do migracji. Zwróć uwagę na wartość zoneRedundant właściwości i ustaw ją zgodnie z wymaganiami odporności.

Jeśli przeprowadzasz migrację bez sufiksu domeny niestandardowej, użyj tego kodu:

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

Jeśli używasz tożsamości zarządzanej przypisanej przez użytkownika do konfiguracji sufiksu domeny niestandardowej, użyj tego kodu:

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

Jeśli używasz przypisanej przez system tożsamości zarządzanej dla niestandardowej konfiguracji sufiksu domeny, użyj tego kodu:

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

9. Migrowanie do środowiska App Service Environment w wersji 3 i sprawdzanie stanu

Po wykonaniu wszystkich powyższych kroków możesz rozpocząć migrację. Upewnij się, że rozumiesz implikacje migracji.

Ten krok trwa od trzech do sześciu godzin. W tym czasie nie ma przestoju aplikacji, jeśli wykonano poprzednie kroki. Skalowanie, wdrożenia i modyfikacje istniejącego środowiska App Service Environment są blokowane w tym kroku.

Uwaga

Ze względu na znaną usterkę zadania sieci Web mogą nie być uruchamiane podczas kroku wdrażania hybrydowego. Jeśli używasz zadań internetowych, ta usterka może spowodować problemy z aplikacją/przestój. Otwórz zgłoszenie do pomocy technicznej, jeśli masz pytania lub wątpliwości dotyczące tego problemu.

Uruchom następujące polecenie, aby rozpocząć migrację:

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

Uruchom następujące polecenie, aby sprawdzić stan migracji:

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

Po zakończeniu MigrationPendingDnsChangemigracji jest wyświetlany stan i masz zasób środowiska App Service Environment w wersji 3. Twoje aplikacje działają teraz w nowym środowisku i w starym środowisku.

Pobierz szczegóły nowego środowiska, uruchamiając następujące polecenie:

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

Ważne

Podczas migracji, a także w trakcie MigrationPendingDnsChange kroku witryna Azure Portal wyświetla niepoprawne informacje o środowisku App Service Environment i aplikacjach. Użyj interfejsu wiersza polecenia platformy Azure, aby sprawdzić stan migracji. Jeśli masz jakiekolwiek pytania dotyczące stanu migracji lub aplikacji, skontaktuj się z pomocą techniczną.

Uwaga

Jeśli migracja zawiera sufiks domeny niestandardowej, konfiguracja sufiksu domeny niestandardowej może być wyświetlana jako obniżona po zakończeniu migracji z powodu znanej usterki. Środowisko App Service Environment powinno nadal działać zgodnie z oczekiwaniami. Stan obniżonej wydajności powinien zostać rozwiązany w ciągu 6–8 godzin. Jeśli konfiguracja jest obniżona po upływie 8 godzin lub jeśli sufiks domeny niestandardowej nie działa, skontaktuj się z pomocą techniczną.

Zrzut ekranu przedstawiający przykładową konfigurację sufiksu domeny niestandardowej o obniżonej wydajności.

10. Pobierz przychodzące adresy IP dla nowego środowiska App Service Environment w wersji 3 i zaktualizuj zasoby zależne

Na tym etapie w procesie migracji znajdują się dwa zestawy frontonów środowiska App Service Environment, a oba zestawy mogą obsługiwać ruch aplikacji. System DNS nie jest zmieniany, więc domyślnie ruch jest wysyłany do starych frontonów środowiska App Service Environment. Należy zaktualizować wszystkie zasoby zależne, aby używać nowego adresu przychodzącego IP dla nowego środowiska App Service Environment w wersji 3. W przypadku środowisk App Service Environment z wewnętrznym modułem równoważenia obciążenia należy zaktualizować prywatne strefy DNS, aby wskazywały nowy przychodzący adres IP.

Nowy adres IP dla ruchu przychodzącego dla nowego środowiska App Service Environment w wersji 3 można uzyskać, uruchamiając następujące polecenie odpowiadające typowi modułu równoważenia obciążenia środowiska App Service Environment. Twoim obowiązkiem jest wprowadzenie wszelkich niezbędnych aktualizacji.

W przypadku środowisk App Service Environment z wewnętrznym modułem równoważenia obciążenia pobierz prywatny adres IP dla ruchu przychodzącego, uruchamiając następujące polecenie:

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

W przypadku środowisk ELB App Service Environment pobierz publiczny adres IP dla ruchu przychodzącego, uruchamiając następujące polecenie:

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

Ważne

Jeśli migracja zawiera sufiks domeny niestandardowej, domyślne zachowanie nazwy hosta dla środowiska App Service Environment w wersji 3 jest inne niż w przypadku środowiska App Service Environment w wersji 2. W przypadku środowiska App Service Environment w wersji 3 domyślna nazwa hosta zawsze używa domyślnego sufiksu domeny i znajduje się w APP-NAME.ASE-NAME.appserviceenvironment.net formularza. Przejrzyj wszystkie zasoby zależne, takie jak usługa App Gateway, korzystające z nazw hostów aplikacji, aby upewnić się, że zostały zaktualizowane pod kątem tego zachowania. Aby uzyskać więcej informacji na temat różnic funkcji środowiska App Service Environment między różnymi wersjami, zobacz Porównanie wersji środowiska App Service Environment.

11. Przekieruj ruch klientów, zweryfikuj środowisko App Service Environment w wersji 3 i ukończ migrację

Ten krok jest okazją do przetestowania i zweryfikowania nowego środowiska App Service Environment w wersji 3.

Po potwierdzeniu, że aplikacje działają zgodnie z oczekiwaniami, możesz sfinalizować migrację, uruchamiając następujące polecenie. To polecenie powoduje również usunięcie starego środowiska.

Jeśli znajdziesz jakiekolwiek problemy lub zdecydujesz, że nie chcesz już kontynuować migracji, skontaktuj się z pomocą techniczną, aby omówić opcje. Nie uruchamiaj polecenia zmiany DNS, ponieważ to polecenie kończy migrację.

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

Uruchom następujące polecenie, aby sprawdzić stan tego kroku:

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

W tym kroku zostanie wyświetlony stan CompletingMigration. Po otrzymaniu MigrationCompletedstanu krok przekierowania ruchu zostanie wykonany i migracja zostanie ukończona.

Cennik

Migracja środowiska App Service Environment nie jest związana z żadnym kosztem. Opłaty są jednak naliczane zarówno za środowisko App Service Environment w wersji 2, jak i nowe środowisko App Service Environment w wersji 3 po rozpoczęciu procesu migracji. Opłaty za stare środowisko App Service Environment w wersji 2 przestaną być naliczane po zakończeniu ostatniego kroku migracji, w którym stare środowisko zostanie usunięte. Należy przeprowadzić walidację tak szybko, jak to możliwe, aby zapobiec zebraniu nadmiarowych opłat. Aby uzyskać więcej informacji na temat cennika środowiska App Service Environment w wersji 3, zapoznaj się z cennikiem.

Podczas migracji do środowiska App Service Environment w wersji 3 z poprzednich wersji istnieją scenariusze, które należy wziąć pod uwagę, które mogą potencjalnie zmniejszyć miesięczny koszt. Rozważ rezerwacje i plany oszczędności, aby jeszcze bardziej zmniejszyć koszty. Aby uzyskać informacje na temat możliwości oszczędzania kosztów, zobacz Możliwości oszczędzania kosztów po uaktualnieniu do środowiska App Service Environment w wersji 3.

Uwaga

Ze względu na różnice między warstwami cenowymi Izolowane izolowane w wersji 2 aplikacje mogą być nadmiernie aprowizowane po migracji, ponieważ warstwa Izolowana w wersji 2 ma więcej pamięci i procesora CPU na odpowiedni rozmiar wystąpienia. Po zakończeniu migracji będziesz mieć możliwość skalowania środowiska zgodnie z potrzebami. Aby uzyskać więcej informacji, zapoznaj się ze szczegółami jednostki SKU.

Skalowanie w dół planów usługi App Service

Jednostki SKU planu usługi App Service dostępne dla środowiska App Service Environment w wersji 3 są uruchamiane w warstwie Izolowane w wersji 2 (Iv2). Liczba rdzeni i ilość pamięci RAM jest skutecznie podwoina na odpowiednią warstwę w porównaniu z warstwą Izolowana. Podczas migracji plany usługi App Service są konwertowane na odpowiednią warstwę. Na przykład wystąpienia I2 są konwertowane na I2v2. Chociaż I2 ma dwa rdzenie i 7 GB pamięci RAM, I2v2 ma cztery rdzenie i 16 GB pamięci RAM. Jeśli oczekujesz, że wymagania dotyczące pojemności pozostaną takie same, aprowizujesz się i płacisz za zasoby obliczeniowe i pamięci, których nie używasz. W tym scenariuszu można skalować wystąpienie I2v2 w dół do I1v2 i kończyć się podobną liczbą rdzeni i pamięci RAM, które wcześniej.

Często zadawane pytania

  • Co zrobić, jeśli migracja środowiska App Service Environment nie jest obecnie obsługiwana?
    Obecnie nie można przeprowadzić migracji przy użyciu funkcji migracji równoległej. Jeśli masz nieobsługiwane środowisko i chcesz przeprowadzić migrację natychmiast, zobacz opcje migracji ręcznej.
  • Jak mogę wybrać, która opcja migracji jest odpowiednia dla mnie?
    Przejrzyj drzewo decyzyjne ścieżki migracji, aby zdecydować, która opcja jest najlepsza dla twojego przypadku użycia.
  • Jak mogę wiedzieć, czy należy używać funkcji migracji równoległej?
    Funkcja migracji równoległej jest najlepsza dla klientów, którzy chcą przeprowadzić migrację do środowiska App Service Environment w wersji 3, ale nie mogą obsługiwać przestojów aplikacji. Ponieważ nowa podsieć jest używana w nowym środowisku, należy pamiętać o sieci, w tym o nowych adresach IP. Jeśli możesz obsługiwać przestój, zobacz funkcję migracji w miejscu, która powoduje minimalne zmiany konfiguracji lub opcje migracji ręcznej. Funkcja migracji w miejscu tworzy środowisko App Service Environment w wersji 3 w tej samej podsieci co istniejące środowisko i używa tej samej infrastruktury sieciowej.
  • Czy podczas migracji wystąpi przestój?
    Platforma gwarantuje, że nie ma przestojów podczas procesu migracji równoległej. Jednak ustawienia DNS mogą spowodować przestój podczas kroku zmiany DNS. Może to być spowodowane problemami TTL i ustawieniami pamięci podręcznej, ponieważ ruch może być nadal kierowany do starego środowiska App Service Environment po zmianie dns. Należy przejrzeć ustawienia DNS i upewnić się, że masz niski czas wygaśnięcia i że dostawca DNS obsługuje szybką propagację.
  • Czy muszę wykonać cokolwiek z moich aplikacji po migracji, aby można było je uruchomić w nowym środowisku App Service Environment?
    Nie, wszystkie aplikacje uruchomione w starym środowisku są automatycznie migrowane do nowego środowiska i uruchamiane podobnie jak wcześniej. Żadne dane wejściowe użytkownika nie są potrzebne.
  • Co zrobić, jeśli środowisko App Service Environment posiada niestandardowy sufiks domeny?
    Funkcja migracji równoległej obsługuje ten scenariusz migracji.
  • Co zrobić, jeśli środowisko App Service Environment jest przypięte do strefy?
    Funkcja migracji równoległej nie obsługuje obecnie tego scenariusza migracji. Jeśli masz przypięte środowisko App Service Environment i chcesz przeprowadzić migrację natychmiast, zobacz opcje migracji ręcznej.
  • Co zrobić, jeśli środowisko App Service Environment ma adresy SSL ip?
    Protokół IP SSL nie jest obsługiwany w środowisku App Service Environment w wersji 3. Przed migracją przy użyciu funkcji migracji lub jednej z opcji ręcznych należy usunąć wszystkie powiązania SSL ip. Jeśli zamierzasz korzystać z funkcji migracji równoległej, po usunięciu wszystkich powiązań PROTOKOŁU SSL ip należy przejść tę kontrolę weryfikacji i kontynuować automatyczną migrację.
  • Jakie właściwości środowiska App Service Environment zmienią?
    Korzystasz z środowiska App Service Environment w wersji 3, więc zapoznaj się z funkcjami i różnicami funkcji w porównaniu z poprzednimi wersjami . Zarówno przychodzące, jak i wychodzące adresy IP zmieniają się podczas korzystania z funkcji migracji równoległej. Uwaga dotycząca środowiska ELB App Service Environment, wcześniej istniał pojedynczy adres IP dla ruchu przychodzącego i wychodzącego. W przypadku środowiska App Service Environment w wersji 3 są one oddzielne. Aby uzyskać więcej informacji, zobacz Sieć środowiska usługi App Service v3. Aby uzyskać pełne porównanie wersji środowiska App Service Environment, zobacz Porównanie wersji środowiska App Service Environment.
  • Co się stanie w przypadku niepowodzenia migracji lub wystąpienia nieoczekiwanego problemu podczas migracji?
    Jeśli wystąpi nieoczekiwany problem, zespoły pomocy technicznej są pod ręką. Zalecamy przeprowadzenie migracji środowisk deweloperskich przed dotknięciem wszystkich środowisk produkcyjnych, aby dowiedzieć się więcej o procesie migracji i zobaczyć, jak ma to wpływ na obciążenia.
  • Co się stanie ze starym środowiskiem App Service Environment?
    Jeśli zdecydujesz się na migrację środowiska App Service Environment przy użyciu funkcji migracji równoległej, stare środowisko będzie używane do ostatniego kroku procesu migracji. Po zakończeniu ostatniego kroku stare środowisko i wszystkie hostowane w nim aplikacje zostaną zamknięte i usunięte. Stare środowisko nie jest już dostępne. Przywrócenie starego środowiska w tym momencie nie jest możliwe.
  • Co się stanie z zasobami środowiska App Service Environment w wersji 1/2 po 31 sierpnia 2024 r.?
    Po 31 sierpnia 2024 r., jeśli nie przeprowadzisz migracji do środowiska App Service Environment w wersji 3, środowisko App Service Environment v1/v2s i wdrożone w nich aplikacje nie będą już dostępne. Środowisko App Service Environment w wersji 1/v2 jest hostowane w jednostkach skalowania usługi App Service działających w architekturze usług Cloud Services (wersja klasyczna), która zostanie wycofana 31 sierpnia 2024 r. W związku z tym środowisko App Service Environment w wersji 1/v2 nie będzie już dostępne po tej dacie. Przeprowadź migrację do środowiska App Service Environment w wersji 3, aby zachować działanie aplikacji lub zapisz lub utwórz kopię zapasową wszystkich zasobów lub danych, które należy zachować.

Następne kroki