Udostępnij za pośrednictwem

Migrowanie wystąpienia usługi API Management innej niż sieć wirtualna do platformy obliczeniowej stv2

  • Artykuł

DOTYCZY: Developer | Podstawowa | Standardowa | Premia

Ten artykuł zawiera kroki migracji wystąpienia usługi API Management hostowanego na stv1 platformie obliczeniowej w miejscu, stv2 gdy wystąpienie nie jest wstrzykiwane (wdrożone) w zewnętrznej lub wewnętrznej sieci wirtualnej. W tym scenariuszu przeprowadź migrację wystąpienia przy użyciu witryny Azure Portal lub interfejsu API REST migracji do wersji stv2 . Dowiedz się, czy musisz to zrobić.

Jeśli musisz przeprowadzić migrację usługi API Management z wstrzykniętą siecią wirtualną hostowaną na stv1 platformie, zobacz Migrowanie wystąpienia usługi API Management z wstrzykniętą siecią wirtualną do platformy stv2.

Ważne

Obsługa wystąpień usługi API Management hostowanych na stv1 platformie jest wycofywana. Na globalnej platformie Azure data wycofania to 31 sierpnia 2024 r. W usłudze Azure Government i na platformie Azure obsługiwanej przez firmę 21Vianet (Azure w Chinach) data wycofania to 24 lutego 2025 r. Jeśli masz wystąpienia hostowane na stv1 platformie, przeprowadź migrację ich na stv2 platformę przed datą wycofania, aby uniknąć przerw w działaniu usługi.

Uwaga

  • Migracja wystąpienia usługi API Management do nowej infrastruktury to długotrwała operacja.
  • W zależności od procesu migracji może wystąpić tymczasowy przestój podczas migracji i może być konieczne zaktualizowanie zależności sieci po migracji w celu uzyskania dostępu do wystąpienia usługi API Management. Zaplanuj migrację odpowiednio.
  • Migracja do stv2 programu nie jest odwracalna.

Co się dzieje podczas migracji?

Migracja platformy API Management z stv1 platformy do stv2 obejmuje aktualizowanie samego bazowego środowiska obliczeniowego i nie ma wpływu na konfigurację usługi/interfejsu API utrwalonej w warstwie magazynu. W przypadku wystąpienia, które nie zostało wdrożone w sieci wirtualnej:

  • Możesz wybrać, czy adres VIP wystąpienia ulegnie zmianie, czy też oryginalny adres VIP zostanie zachowany.
  • Proces uaktualniania obejmuje utworzenie nowego środowiska obliczeniowego równolegle ze starymi obliczeniami.
  • Stan usługi API Management w portalu będzie aktualizowany.
  • Jeśli zdecydujesz się zachować adres VIP, migracja obejmuje dodatkowy krok przenoszenia adresu VIP ze starego środowiska obliczeniowego do nowego obliczenia, podczas którego interfejsy API nie odpowiadają.
  • Platforma Azure zarządza systemem DNS punktu końcowego zarządzania i aktualizuje nowe zasoby obliczeniowe natychmiast po pomyślnej migracji.
  • Brama domyślna i brama DNS portalu natychmiast wskazują nowe zasoby obliczeniowe.
  • Jeśli zdecydujesz się, aby wystąpienie usługi API Management otrzymało nowy adres VIP, należy zaktualizować zależności sieciowe, aby używać nowego adresu VIP.

Wymagania wstępne

Migrowanie wystąpienia do platformy stv2

Opcje publicznego adresu IP

Możesz wybrać, czy wirtualny adres IP usługi API Management zmieni się, czy oryginalny adres VIP zostanie zachowany.

  • Nowy wirtualny adres IP — w przypadku wybrania tego trybu żądania interfejsu API pozostają dynamiczne podczas migracji. Konfiguracja infrastruktury (na przykład domeny niestandardowe, lokalizacje i certyfikaty urzędu certyfikacji) zostanie zablokowana przez 30 minut. Po migracji należy zaktualizować wszystkie zależności sieciowe, w tym dns, reguły zapory i sieci wirtualne, aby używać nowego adresu VIP.

  • Zachowaj adres IP — jeśli zachowasz adres VIP, żądania interfejsu API nie będą odpowiadać przez około 15 minut, gdy adres IP zostanie zmigrowany do nowej infrastruktury. Konfiguracja infrastruktury (na przykład domeny niestandardowe, lokalizacje i certyfikaty urzędu certyfikacji) zostanie zablokowana przez 45 minut. Po migracji nie jest wymagana żadna dalsza konfiguracja.

Wstępnie utworzony adres IP na potrzeby migracji

W przypadku wystąpień usługi API Management, które są osiągalne przez publiczny adres IP, usługa API Management wstępnie utworzy publiczny adres IP dla procesu migracji. Znajdź wstępnie utworzony adres IP w danych wyjściowych JSON właściwości wystąpienia usługi API Management. W obszarze customPropertieswstępnie utworzony adres IP jest wartością Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps właściwości . W przypadku wdrożenia w wielu regionach wartość jest rozdzieloną przecinkami listą wstępnie utworzonych adresów IP.

Użyj wstępnie utworzonego adresu IP (lub adresów), aby ułatwić zarządzanie procesem migracji:

  • Podczas migracji i zachowania adresu VIP wstępnie utworzony adres IP jest tymczasowo przypisywany do nowego stv2 wdrożenia, zanim oryginalny adres IP zostanie przypisany do stv2 wdrożenia. Jeśli masz reguły zapory ograniczające dostęp do wystąpienia usługi API Management, możesz na przykład dodać wstępnie utworzony adres IP do listy dozwolonych, aby zachować ciągłość dostępu klienta podczas migracji. Po zakończeniu migracji można usunąć wstępnie utworzony adres IP z listy dozwolonych.
  • Podczas migracji i generowania nowego adresu VIP wstępnie utworzony adres IP jest przypisywany do nowego stv2 wdrożenia podczas migracji i utrwala się po zakończeniu migracji. Użyj wstępnie utworzonego adresu IP, aby zaktualizować zależności sieciowe, takie jak reguły DNS i zapory, aby wskazać nowy adres IP.

Kroki migracji

  1. W witrynie Azure Portal przejdź do wystąpienia usługi API Management.

  2. W menu po lewej stronie w obszarze Ustawienia wybierz pozycję Migracja platformy.

  3. Na stronie Migracja platformy wybierz jedną z dwóch opcji migracji:

    • Nowy wirtualny adres IP. Adres VIP wystąpienia usługi API Management zmieni się automatycznie. Usługa nie będzie miała przestoju, ale po migracji należy zaktualizować wszystkie zależności sieciowe, w tym dns, reguły zapory i sieci wirtualne, aby używać nowego adresu VIP.

    • Zachowaj adres IP — adres VIP wystąpienia usługi API Management nie ulegnie zmianie. Wystąpienie będzie miało czas przestoju przez maksymalnie 15 minut.

      Zrzut ekranu przedstawiający migrację platformy usługi API Management w portalu.

  4. Przejrzyj wskazówki dotyczące procesu migracji i przygotuj środowisko.

  5. Po wykonaniu kroków przygotowywania wybierz pozycję Przeczytano i rozumiem wpływ procesu migracji. Wybierz pozycję Migruj.

Weryfikowanie migracji

Aby sprawdzić, czy migracja zakończyła się pomyślnie, gdy stan zmieni się na Online, sprawdź wersję platformy wystąpienia usługi API Management. Po pomyślnej migracji wartość to stv2 lub stv2.1.

Przywróć automatycznie, jeśli migracja nie powiedzie się

Jeśli podczas procesu migracji wystąpi błąd, wystąpienie zostanie automatycznie przywrócone do stv1 platformy. Jeśli migracja zakończy się pomyślnie (wersja platformy wystąpienia jest wyświetlana jako stv2 lub stv2.1 i stan w trybie Online), nie można wycofać się z stv1 platformy.

Aby uzyskać pomoc w przypadku niepowodzenia migracji, skontaktuj się z pomoc techniczna platformy Azure.

Jeśli potrzebujesz możliwości ręcznego wycofania, zaleca się wdrożenie nowego wystąpienia obok oryginalnego stv2 wystąpienia usługi API Management.

Aktualizowanie zależności sieci

Po pomyślnej migracji do nowego adresu VIP zaktualizuj wszystkie zależności sieciowe, w tym DNS, reguły zapory i sieci wirtualne, aby używać nowego adresu VIP.

Pomoc i obsługa techniczna

Jesteśmy tutaj, aby pomóc Ci przeprowadzić migrację na platformę stv2 z minimalnymi zakłóceniami w Twoich usługach.

Jeśli masz pytania, uzyskaj szybkie odpowiedzi od ekspertów społeczności w usłudze Microsoft Q&A. Jeśli masz plan pomocy technicznej i potrzebujesz takiej pomocy, utwórz wniosek o pomoc techniczną.

  1. W obszarze Podsumowanie wpisz opis problemu, na przykład "stv1 retirement".
  2. W obszarze Typ problemu wybierz pozycję Techniczne.
  3. W obszarze Subskrypcja wybierz swoją subskrypcję.
  4. W obszarze Usługa wybierz pozycję Moje usługi, a następnie wybierz pozycję Usługa API Management.
  5. W obszarze Zasób wybierz zasób platformy Azure, dla którego tworzysz wniosek o pomoc techniczną.
  6. W polu Typ problemu wybierz pozycję Administracja i zarządzanie.
  7. W obszarze Podtyp problemu wybierz pozycję Uaktualnij, Skaluj lub Zmiany jednostki SKU.

Często zadawane pytania

  • Jakie informacje musimy wybrać ścieżkę migracji?

    • Jaki jest tryb sieciowy wystąpienia usługi API Management?
    • Czy domeny niestandardowe są skonfigurowane?
    • Czy jest zaangażowana zapora?
    • Jakiekolwiek znane zależności podjęte przez nadrzędny/podrzędny dla zaangażowanych adresów IP?
    • Czy jest to wdrożenie w wielu regionach?
    • Czy można zmodyfikować istniejące wystąpienie lub czy wymagana jest konfiguracja równoległa?
    • Czy może wystąpić przestój?
    • Czy migracja może odbywać się w godzinach nonbusiness?

  • Jakie są wymagania wstępne dotyczące migracji?

    W przypadku wystąpień niewstrzykniętych przez sieć wirtualną nie są wymagane żadne wymagania wstępne. W przypadku migrowania zachowania publicznego adresu IP spowoduje to, że wystąpienie usługi API Management nie odpowiada przez około 15 minut. Jeśli wybierzesz opcję Nowy wirtualny adres IP, która udostępni usługę API Management na nowym adresie IP, może nie wystąpić przestój. Wystąpienia skonfigurowane z domeną niestandardową przy użyciu rekordu A i/lub zależności sieci na publicznym wirtualnym adresie IP będą miały przestój po żądaniu nowego wirtualnego adresu IP.

  • Czy migracja spowoduje przestój?

    W przypadku wystąpień niewstrzykniętych przez sieć wirtualną występuje przestój wynoszący około 15 minut tylko wtedy, gdy zdecydujesz się zachować oryginalny adres IP. Nie ma jednak przestoju w przypadku migracji z nowym adresem IP i braku zależności sieciowych od nowego adresu IP. Zależności sieciowe obejmują niestandardową nazwę domeny bez rekordu CNAME, listy dozwolonych adresów IP, reguł zapory i sieci wirtualnych.

  • Czy dane lub straty konfiguracji mogą wystąpić przez/podczas migracji?

    stv1 migracja stv2 obejmuje aktualizowanie samej platformy obliczeniowej, a wewnętrzna warstwa magazynu nie jest zmieniana. W związku z tym cała konfiguracja jest bezpieczna podczas procesu migracji. Obejmuje to tożsamość zarządzaną przypisaną przez system, która w przypadku włączenia jest zachowywana.

  • Jak potwierdzić, że migracja została ukończona i zakończona pomyślnie?

    Migracja jest uważana za ukończoną i pomyślną, gdy stan na stronie przeglądu odczytuje wartość Online wraz z wersją platformy lub stv2 stv2.1. Sprawdź również, czy stan sieci w bloku sieci jest wyświetlany na zielono dla wszystkich wymaganych połączeń.

  • Czy mogę przeprowadzić migrację przy użyciu portalu?

    Tak, blok Migracja platformy w witrynie Azure Portal przeprowadzi cię przez proces migracji dla wystąpień niewstrzymianych przez sieć wirtualną.

  • Czy mogę zachować adres IP wystąpienia?

    Tak, adres IP można zachować, ale nastąpi przestój około 15 minut.

  • Czy istnieje ścieżka migracji bez modyfikowania istniejącego wystąpienia?

    Tak, potrzebna jest migracja równoległa. Oznacza to, że utworzysz nowe wystąpienie usługi API Management równolegle z bieżącym wystąpieniem i skopiujesz konfigurację do nowego wystąpienia.

  • Co się stanie, jeśli migracja zakończy się niepowodzeniem?

    Jeśli wystąpienie usługi API Management nie wyświetla wersji platformy jako stv2 lub stv2.1 stanu online po zainicjowaniu migracji, prawdopodobnie nie powiodło się. Usługa jest automatycznie przywracana do starego wystąpienia i nie są wprowadzane żadne zmiany. Jeśli masz problemy (na przykład jeśli stan to Aktualizowanie przez więcej niż 2 godziny), skontaktuj się z pomoc techniczna platformy Azure.

  • Jakie funkcje nie są dostępne podczas migracji?

    W przypadku wystąpień niewstrzykniętych przez sieć wirtualną:

    • Jeśli zdecydujesz się zachować oryginalny adres IP: żądania interfejsu API nie odpowiadają przez około 15 minut, gdy adres IP jest migrowany do nowej infrastruktury. Konfiguracja infrastruktury (na przykład domeny niestandardowe, lokalizacje i certyfikaty urzędu certyfikacji) jest zablokowana przez 45 minut.
    • Jeśli zdecydujesz się przeprowadzić migrację do nowego adresu IP: żądania interfejsu API pozostają dynamiczne podczas migracji. Konfiguracja infrastruktury (na przykład domeny niestandardowe, lokalizacje i certyfikaty urzędu certyfikacji) jest zablokowana przez 30 minut. Po migracji należy zaktualizować wszystkie zależności sieciowe, w tym dns, reguły zapory i sieci wirtualne, aby używać nowego adresu VIP.

  • Jak długo potrwa migracja?

    Oczekiwany czas trwania całej migracji wynosi około 45 minut. Wskaźnikiem sprawdzania, czy migracja została już wykonana, jest sprawdzenie, czy stan wystąpienia jest z powrotem do trybu online , a nie do aktualizowania. Jeśli zostanie wyświetlony komunikat Aktualizowanie przez ponad 2 godziny, skontaktuj się z pomoc techniczna platformy Azure.

  • Czy mogę wycofać migrację, jeśli jest to wymagane?

    Jeśli wystąpi błąd podczas procesu migracji, wystąpienie zostanie automatycznie wycofane z platformy stv1 . Jednak po pomyślnym przeprowadzeniu migracji usługi nie można wycofać jej z platformy stv1 .

  • Czy w domenach niestandardowych/prywatnych strefach DNS jest wymagana jakakolwiek zmiana?

    W przypadku wystąpień niewstrzykniętych przez sieć wirtualną nie są wymagane żadne zmiany, jeśli adres IP zostanie zachowany. W przypadku wybrania nowego adresu IP należy zaktualizować domeny niestandardowe odwołujące się do adresu IP.

  • Moje wystąpienie stv1 jest wdrażane w wielu regionach platformy Azure (w wielu regionach). Jak mogę uaktualnić do wersji stv2?

    W przypadku usługi API Management, która nie jest wstrzykiwana w sieci wirtualnej, wykonaj kroki migracji przy użyciu portalu lub interfejsu wiersza polecenia platformy Azure. Wszystkie regiony zostaną zmigrowane do stv2programu .

  • Co należy wziąć pod uwagę w przypadku bram hostowanych samodzielnie?

    Nie musisz nic robić w własnych bramach. Wystarczy przeprowadzić migrację wystąpień usługi API Management działających na platformie Azure, które mają wpływ na stv1 wycofanie platformy. Należy pamiętać, że dla punktu końcowego konfiguracji wystąpienia usługi API Management może istnieć nowy adres IP, a wszelkie ograniczenia sieciowe przypięte do adresu IP powinny zostać zaktualizowane.

  • Jaki wpływ ma portal deweloperów na migrację?

    Nie ma to wpływu na portal deweloperów. Jeśli są używane domeny niestandardowe, rekord DNS powinien zostać zaktualizowany przy użyciu obowiązującego adresu IP, po migracji. Jeśli jednak domeny domyślne są używane, są one automatycznie aktualizowane po pomyślnej migracji. Podczas migracji nie ma przestoju w portalu dla deweloperów.

  • Czy po przeprowadzeniu migracji do wersji stv2 ma jakiś wpływ na koszt?

    Model rozliczeń pozostaje taki sam w przypadku stv2 i nie będzie już poniesionych kosztów podczas migracji i po niej.

  • Jakie uprawnienia RBAC są wymagane do migracji stv1 do stv2?

    Użytkownik/proces podejmujący migrację musi mieć dostęp do zapisu w wystąpieniu usługi API Management.

Powiązana zawartość