Migrowanie środowiska App Service Environment w wersji 1 i 2 do środowiska App Service Environment w wersji 3 za pomocą funkcji migracji w miejscu

Uwaga

Funkcja migracji opisana w tym artykule jest używana do automatycznej migracji środowiska App Service Environment w wersji 1 i 2 do środowiska App Service Environment w wersji 3 w miejscu (tej samej podsieci). Jeśli szukasz informacji na temat funkcji migracji równoległej, zobacz Migrowanie do środowiska App Service Environment w wersji 3 przy użyciu funkcji migracji równoległej. 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.

Środowisko App Service Environment w wersji 1 i 2 można automatycznie migrować do środowiska App Service Environment w wersji 3 przy użyciu funkcji migracji w miejscu. Aby dowiedzieć się więcej na temat procesu migracji i sprawdzić, czy środowisko App Service Environment obsługuje migrację w tej chwili, zobacz omówienie funkcji migracji w miejscu.

Ważne

Zalecamy użycie tej funkcji w środowiskach deweloperskich przed migracją jakichkolwiek środowisk produkcyjnych, aby uniknąć nieoczekiwanych problemów. Przekaż wszelkie opinie związane z tym artykułem lub funkcją, korzystając z przycisków w dolnej części strony.

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, 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, grupie zasobów, zasobie 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ż 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.

Zalecamy użycie witryny Azure Portal do środowiska migracji w miejscu. Jeśli zdecydujesz się użyć interfejsu wiersza polecenia platformy Azure do 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.

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

2. Sprawdź, czy migracja jest obsługiwana

Następujące polecenie sprawdza, czy środowisko App Service Environment jest obsługiwane do migracji. Jeśli wystąpi błąd lub jeśli środowisko App Service Environment jest w złej kondycji lub jest w stanie wstrzymania, nie możesz przeprowadzić migracji w tej chwili. Zobacz sekcję rozwiązywania problemów, aby uzyskać opisy potencjalnych komunikatów o błędach, które można uzyskać. Jeśli środowisko nie jest obsługiwane w przypadku migracji przy użyciu funkcji migracji w miejscu lub chcesz przeprowadzić migrację do środowiska App Service Environment w wersji 3 bez korzystania z funkcji migracji w miejscu, zobacz opcje migracji ręcznej. 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 w miejscu dla środowiska App Service Environment.

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

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, 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}/migrate?api-version=2021-02-01&phase=PreMigrationUpgrade"

3. Generowanie adresów IP dla nowego zasobu środowiska App Service Environment w wersji 3

Uruchom następujące polecenie, aby utworzyć nowe 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}/migrate?api-version=2021-02-01&phase=premigration"

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

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

Uwaga

Ze względu na znaną usterkę w przypadku migracji środowiska ELB App Service Environment adres IP dla ruchu przychodzącego może ulec zmianie po zakończeniu kroku migracji. Przygotuj się do ponownego zaktualizowania zasobów zależnych przy użyciu nowego przychodzącego adresu IP po zakończeniu kroku migracji. Ta usterka jest rozwiązywana i zostanie usunięta tak szybko, jak to możliwe. Otwórz zgłoszenie do pomocy technicznej, jeśli masz pytania lub wątpliwości dotyczące tego problemu lub potrzebujesz pomocy dotyczącej procesu migracji.

4. Aktualizowanie zasobów zależnych przy użyciu nowych adresów IP

Korzystając z nowych adresów IP, zaktualizuj dowolne zasoby lub składniki sieciowe, aby upewnić się, że nowe środowisko działa zgodnie z oczekiwaniami po zakończeniu migracji. Twoim obowiązkiem jest wprowadzenie wszelkich niezbędnych aktualizacji.

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. Te zmiany obejmują zmianę portu dla usługi Azure Load Balancer, która teraz używa portu 80. Nie przeprowadzaj migracji, dopóki nie wykonasz tego kroku.

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

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

Blokady mogą istnieć w trzech 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 zastosowano blokady 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.

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.

7. Przygotowywanie konfiguracji

Możesz zwolnić nową strefę zasobów środowiska App Service Environment w wersji 3, jeśli istniejące środowisko znajduje się w regionie obsługującym nadmiarowość strefy. Nadmiarowość strefy można skonfigurować, ustawiając zoneRedundant właściwość na true.

Nadmiarowość strefy jest opcjonalną konfiguracją. Można go ustawić tylko podczas tworzenia nowego zasobu środowiska App Service Environment w wersji 3. Nie można go usunąć w późniejszym czasie. Aby uzyskać więcej informacji, zobacz Wybieranie konfiguracji środowiska App Service Environment w wersji 3. Jeśli nie chcesz konfigurować nadmiarowości strefy, nie dołączaj parametru zoneRedundant .

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. Migracja również nie powiedzie się, jeśli spróbujesz dodać sufiks domeny niestandardowej podczas migracji do środowiska, które nie ma skonfigurowanego. 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 nowych wychodzących adresów IP środowiska App Service Environment, które zostały wygenerowane w kroku 3.

Jeśli migracja nie zawiera sufiksu domeny niestandardowej i nie włączasz nadmiarowości strefy, możesz przejść do migracji.

Aby ustawić te konfiguracje, utwórz plik o nazwie parameters.json z następującymi szczegółami na podstawie danego scenariusza. 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, ponieważ ta konfiguracja jest nieodwracalna po migracji. Ustaw wartość kind właściwości na podstawie istniejącej wersji środowiska App Service Environment. Akceptowane wartości właściwości kind to ASEV1 i ASEV2.

Jeśli przeprowadzasz migrację bez sufiksu domeny niestandardowej i włączasz nadmiarowość strefy, użyj tego kodu:

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

Jeśli używasz tożsamości zarządzanej przypisanej przez użytkownika dla niestandardowej konfiguracji sufiksu domeny i włączasz nadmiarowość strefy, użyj tego kodu:

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

Jeśli używasz przypisanej przez system tożsamości zarządzanej dla niestandardowej konfiguracji sufiksów domeny i nie włączasz nadmiarowości strefy, użyj tego kodu:

{
    "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. 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 przypadku migracji z wersji 2 do 3 i do sześciu godzin w przypadku migracji z wersji 1 do 3 w zależności od rozmiaru środowiska. W tym czasie występuje około godziny przestoju aplikacji. Skalowanie, wdrożenia i modyfikacje istniejącego środowiska App Service Environment są blokowane w tym kroku.

Uwzględnij body parametr w poniższym poleceniu, jeśli włączasz nadmiarowość strefy i/lub konfigurujesz sufiks domeny niestandardowej. Jeśli żadna z tych konfiguracji nie ma zastosowania do migracji, możesz usunąć parametr z polecenia .

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

Uruchom następujące polecenia, aby sprawdzić szczegółowy stan migracji. Aby uzyskać informacje na temat stanów, zobacz opisy stanu migracji.

Pierwsze polecenie pobiera identyfikator operacji migracji. Skopiuj wartość ID właściwości .

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

Zastąp symbol zastępczy identyfikatora operacji w poniższym poleceniu wartością skopiowaną. To polecenie zwraca szczegółowy stan migracji. Możesz uruchomić to polecenie tak często, jak to konieczne, aby uzyskać najnowszy stan.

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

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

Pobierz szczegóły nowego środowiska, uruchamiając następujące polecenie lub przechodząc do witryny Azure Portal.

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

Uwaga

Ze względu na znaną usterkę w przypadku migracji środowiska ELB App Service Environment adres IP dla ruchu przychodzącego może ulec zmianie po zakończeniu kroku migracji. Sprawdź adresy IP środowiska App Service Environment w wersji 3 i wprowadź wymagane aktualizacje, jeśli nastąpiły zmiany od kroku generowania adresów IP. Otwórz zgłoszenie do pomocy technicznej, jeśli masz pytania lub wątpliwości dotyczące tego problemu lub potrzebujesz pomocy przy potwierdzaniu nowych adresów IP.

1. Sprawdź, czy migracja jest obsługiwana

W witrynie Azure Portal przejdź do strony Migracja dla migrowania środowiska App Service Environment. Możesz przejść do strony Migracja , wybierając baner w górnej części strony Przegląd środowiska App Service Environment lub wybierając element Migracja w menu po lewej stronie.

Zrzut ekranu przedstawiający punkty dostępu do migracji.

Na stronie Migracja platforma sprawdza, czy migracja jest obsługiwana w środowisku App Service Environment. Wybierz pozycję Zweryfikuj, a następnie potwierdź, że chcesz kontynuować walidację. Proces weryfikacji trwa kilka sekund.

Zrzut ekranu przedstawiający przycisk weryfikacji uprawnień do migracji.

Jeśli środowisko nie jest obsługiwane w przypadku migracji, w górnej części strony zostanie wyświetlony baner zawierający komunikat o błędzie z przyczyną. Opisy komunikatów o błędach, które mogą pojawić się, jeśli nie kwalifikujesz się do migracji, zobacz Rozwiązywanie problemów.

Jeśli środowisko App Service Environment nie jest obecnie obsługiwane w przypadku migracji lub środowisko jest w złej kondycji lub jest w stanie wstrzymania, nie możesz użyć funkcji migracji. Jeśli środowisko nie jest obsługiwane w przypadku migracji z funkcją migracji w miejscu lub chcesz przeprowadzić migrację do środowiska App Service Environment w wersji 3 bez korzystania z funkcji migracji w miejscu, zobacz opcje migracji ręcznej.

Zrzut ekranu przedstawiający przykładowy komunikat portalu z informacją, że funkcja migracji nie obsługuje środowiska App Service Environment.

Jeśli musisz uruchomić uaktualnienie w celu uaktualnienia środowiska App Service Environment do obsługiwanej wersji kompilacji, zostanie wyświetlony monit o uruchomienie uaktualnienia. Wybierz pozycję Uaktualnij , aby rozpocząć uaktualnianie. Po zakończeniu uaktualniania można przejść walidację i użyć funkcji migracji, aby rozpocząć migrację.

Jeśli migracja jest obsługiwana w środowisku App Service Environment, przejdź do następnego kroku w procesie. Strona Migracja przeprowadzi Cię przez serię kroków do ukończenia migracji.

Zrzut ekranu przedstawiający przykładową stronę migracji z niedokończonymi krokami w procesie.

2. Generowanie adresów IP dla nowego zasobu środowiska App Service Environment w wersji 3

W obszarze Uzyskaj nowe adresy IP upewnij się, że rozumiesz implikacje i wybierz przycisk Rozpocznij . Wykonanie tego kroku trwa około 15 minut. W tym czasie nie można skalować ani wprowadzać zmian w istniejącym środowisku App Service Environment.

3. Aktualizowanie zasobów zależnych przy użyciu nowych adresów IP

Po zakończeniu poprzedniego kroku będą wyświetlane adresy IP nowego zasobu środowiska App Service Environment w wersji 3. Użyj nowych adresów IP, aby zaktualizować wszystkie zasoby i składniki sieciowe, aby nowe środowisko działało zgodnie z oczekiwaniami po zakończeniu migracji. Twoim obowiązkiem jest wprowadzenie wszelkich niezbędnych aktualizacji.

Ten krok to również dobry moment na przejrzenie zmian zależności sieci dla ruchu przychodzącego i wychodzącego w przejściu do środowiska App Service Environment w wersji 3. Te zmiany obejmują zmianę portu dla usługi Azure Load Balancer, która teraz używa portu 80. Nie przechodzij do następnego kroku, dopóki nie potwierdzisz, że te aktualizacje zostały wprowadzone.

Zrzut ekranu przedstawiający przykładowe adresy IP wygenerowane podczas premii.

4. Delegowanie podsieci środowiska App Service Environment

Środowisko App Service Environment w wersji 3 wymaga podsieci, w ramach którego znajduje się pojedyncze delegowanie Microsoft.Web/hostingEnvironmentselementu . Poprzednie wersje nie wymagały tego delegowania. Przed migracją należy potwierdzić, że podsieć jest delegowana prawidłowo i zaktualizować delegowanie (w razie potrzeby). W portalu zostanie wyświetlony link do podsieci, aby można było potwierdzić i zaktualizować w razie potrzeby.

Zrzut ekranu przedstawiający delegowanie podsieci w portalu.

5. Potwierdzanie zmian rozmiaru wystąpienia

Plany usługi App Service są konwertowane z izolowanej na odpowiednią warstwę Izolowana w wersji 2. Na przykład I2 jest konwertowany na 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. Masz możliwość skalowania środowiska zgodnie z potrzebami po zakończeniu migracji. Aby uzyskać więcej informacji, zapoznaj się ze szczegółami cennika.

Zrzut ekranu przedstawiający potwierdzenie zmiany rozmiaru wystąpienia podczas migracji.

6. Upewnij się, że sieć wirtualna nie ma 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.

Blokady mogą istnieć w trzech 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 zastosowano blokady 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.

Aby uzyskać szczegółowe informacje na temat sprawdzania, czy subskrypcja lub grupa zasobów ma blokady, zobacz Konfigurowanie blokad.

Zrzut ekranu pokazujący, gdzie znaleźć i usunąć blokady sieci wirtualnej.

7. Wybierz konfiguracje

Możesz zwolnić nową strefę zasobów środowiska App Service Environment w wersji 3, jeśli istniejące środowisko znajduje się w regionie obsługującym nadmiarowość strefy. Nadmiarowość strefy jest opcjonalną konfiguracją. Można go ustawić tylko podczas tworzenia nowego zasobu środowiska App Service Environment w wersji 3. Nie można go usunąć w późniejszym czasie. Aby uzyskać więcej informacji, zobacz Wybieranie konfiguracji środowiska App Service Environment w wersji 3.

Zaznacz pole wyboru Włączone, jeśli chcesz skonfigurować nadmiarowość strefy.

Zrzut ekranu przedstawiający pole wyboru włączania nadmiarowości strefy dla środowiska App Service Environment w obsługiwanym regionie.

Jeśli środowisko znajduje się w regionie, który nie obsługuje nadmiarowości strefy, pole wyboru jest niedostępne. Jeśli potrzebujesz zasobu strefowo nadmiarowego środowiska App Service Environment w wersji 3, użyj jednej z opcji migracji ręcznej i utwórz zasób w jednym z regionów obsługujących nadmiarowość strefy.

Jeśli istniejące środowisko App Service Environment używa niestandardowego sufiksu domeny, musisz skonfigurować jeden dla nowego zasobu środowiska App Service Environment w wersji 3. Opcje konfiguracji dla sufiksu domeny niestandardowej są wyświetlane, jeśli ta sytuacja ma zastosowanie do Ciebie. Nie można przeprowadzić migracji, dopóki nie podasz wymaganych informacji.

Jeśli chcesz użyć niestandardowego sufiksu domeny, ale nie masz obecnie skonfigurowanego sufiksu, możesz skonfigurować jeden po zakończeniu migracji. 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 nowych wychodzących adresów IP środowiska App Service Environment, które zostały wygenerowane w kroku 2.

Zrzut ekranu przedstawiający link do dodawania niestandardowego sufiksu domeny.

Po dodaniu szczegółów sufiksu domeny niestandardowej dostępny jest przycisk Migruj.

Zrzut ekranu pokazujący, że szczegóły konfiguracji są dodawane, a środowisko jest gotowe do migracji.

8. Migrowanie do środowiska App Service Environment w wersji 3

Po wykonaniu wszystkich powyższych kroków możesz rozpocząć migrację. Upewnij się, że rozumiesz konsekwencje migracji, w tym co się dzieje w tym czasie.

Ten krok trwa od trzech do sześciu godzin w przypadku migracji z wersji 2 do 3 i do sześciu godzin w przypadku migracji z wersji 1 do 3 w zależności od rozmiaru środowiska. Skalowanie i modyfikacje istniejącego środowiska App Service Environment są blokowane w tym kroku.

Uwaga

W rzadkich przypadkach może zostać wyświetlone powiadomienie w portalu z komunikatem "Migracja do środowiska App Service Environment w wersji 3 nie powiodła się" po rozpoczęciu migracji. Istnieje znana usterka, która może wyzwolić to powiadomienie, nawet jeśli migracja trwa. Sprawdź dziennik aktywności środowiska App Service Environment, aby określić ważność tego komunikatu o błędzie. W większości przypadków odświeżanie strony rozwiązuje problem, a komunikat o błędzie zniknie. Jeśli komunikat o błędzie będzie się powtarzać, skontaktuj się z pomocą techniczną, aby uzyskać pomoc.

Zrzut ekranu przedstawiający potencjalne powiadomienie o błędzie po rozpoczęciu migracji.

Obecnie szczegółowe stany migracji są dostępne tylko wtedy, gdy używasz interfejsu wiersza polecenia platformy Azure. Aby uzyskać więcej informacji, zobacz sekcję interfejsu wiersza polecenia platformy Azure dotyczącą migracji do środowiska App Service Environment w wersji 3. Stan migracji można sprawdzić za pomocą interfejsu wiersza polecenia, nawet jeśli do przeprowadzenia migracji jest używany portal.

Po zakończeniu migracji masz zasób środowiska App Service Environment w wersji 3, a wszystkie aplikacje są uruchomione w nowym środowisku. Wersję środowiska można potwierdzić, sprawdzając stronę Konfiguracja środowiska App Service Environment.

Uwaga

Ze względu na znaną usterkę w przypadku migracji środowiska ELB App Service Environment adres IP dla ruchu przychodzącego może ulec zmianie po zakończeniu kroku migracji. Sprawdź adresy IP środowiska App Service Environment w wersji 3 i wprowadź wymagane aktualizacje, jeśli nastąpiły zmiany od kroku generowania adresów IP. Otwórz zgłoszenie do pomocy technicznej, jeśli masz pytania lub wątpliwości dotyczące tego problemu lub potrzebujesz pomocy przy potwierdzaniu nowych adresów IP.

Jeśli migracja zawiera sufiks domeny niestandardowej, domena zostanie wyświetlona w sekcji Podstawy na stronie Przegląd portalu dla środowiska App Service Environment w wersji 1/2, ale nie jest już wyświetlana w środowisku App Service Environment w wersji 3. Zamiast tego w przypadku środowiska App Service Environment w wersji 3 przejdź do strony sufiksu domeny niestandardowej , aby potwierdzić poprawną konfigurację sufiksu domeny niestandardowej. Możesz również usunąć konfigurację, jeśli nie jest już potrzebna, lub skonfigurować ją, jeśli nie masz jej wcześniej.

Zrzut ekranu przedstawiający stronę konfiguracji sufiksu domeny niestandardowej dla środowiska App Service Environment w wersji 3.

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.

Następne kroki