Sdílet prostřednictvím

Migrace instance služby API Management, která není vložená do virtuální sítě, na výpočetní platformu stv2

  • Článek

PLATÍ PRO: Vývojář | Základní | Standardní | Prémie

Tento článek obsahuje postup migrace instance služby API Management hostované na stv1 výpočetní platformě na platformě, stv2 pokud se instance nevloží (nasadí) do externí nebo interní virtuální sítě. V tomto scénáři migrujte instanci pomocí webu Azure Portal nebo rozhraní REST API migrovat na stv2 . Zjistěte, jestli to potřebujete udělat.

Pokud potřebujete migrovat službu API Management vloženou do virtuální sítě hostované na platforměstv1, přečtěte si téma Migrace instance služby API Management vložené do virtuální sítě na platformu stv2.

Důležité

Podpora instancí služby API Management hostovaných na platformě stv1 se vyřadí z provozu. V globálním Azure je datum vyřazení 31. srpna 2024. Ve službě Azure Government a v Azure provozovaném společností 21Vianet (Azure v Číně) je datum vyřazení 24. února 2025. Pokud máte instance hostované na stv1 platformě, migrujte je na platformu stv2 před datem vyřazení, abyste se vyhnuli přerušení služeb.

Upozornění

  • Migrace instance služby API Management na novou infrastrukturu je dlouhotrvající operace.
  • V závislosti na procesu migrace může dojít k dočasnému výpadku během migrace a po migraci možná budete muset aktualizovat závislosti sítě, aby se dosáhlo instance služby API Management. Naplánujte migraci odpovídajícím způsobem.
  • Migrace na stv2 nevratnou migraci.

Co se stane během migrace?

Migrace platformy API Management z stv1 toho stv2 zahrnuje aktualizaci samotného základního výpočetního prostředí a nemá žádný vliv na konfiguraci služby nebo rozhraní API, která se zachová ve vrstvě úložiště. Pro instanci, která není nasazená ve virtuální síti:

  • Můžete zvolit, jestli se změní adresa VIRTUÁLNÍ IP adresy instance nebo jestli je původní adresa VIP zachována.
  • Proces upgradu zahrnuje paralelní vytvoření nového výpočetního prostředí se starým výpočetním prostředím.
  • Stav služby API Management na portálu bude aktualizován.
  • Pokud se rozhodnete zachovat virtuální IP adresu, zahrnuje migrace další krok přesunu virtuální IP adresy ze starého výpočetního prostředí na nový výpočetní objekt, během kterého rozhraní API nereagují.
  • Azure spravuje DNS koncového bodu správy a aktualizuje nové výpočetní prostředky okamžitě po úspěšné migraci.
  • Výchozí brána a portál DNS okamžitě odkazují na nové výpočetní prostředky.
  • Pokud se rozhodnete, že vaše instance služby API Management obdrží novou virtuální IP adresu, budete muset aktualizovat závislosti sítě tak, aby používaly novou IP adresu.

Požadavky

Migrace instance na platformu stv2

Možnosti veřejné IP adresy

Můžete zvolit, jestli se změní virtuální IP adresa služby API Management nebo jestli se původní VIRTUÁLNÍ IP adresa zachovají.

  • Nová virtuální IP adresa – Pokud zvolíte tento režim, požadavky rozhraní API zůstanou během migrace responzivní. Konfigurace infrastruktury (například vlastní domény, umístění a certifikáty certifikační autority) se uzamkne po dobu 30 minut. Po migraci budete muset aktualizovat všechny závislosti sítě, včetně DNS, pravidel brány firewall a virtuálních sítí, aby používaly novou VIRTUÁLNÍ ADRESU.

  • Zachovat IP adresu – Pokud zachováte virtuální IP adresu, požadavky rozhraní API nebudou reagovat přibližně na 15 minut, když se IP adresa migruje do nové infrastruktury. Konfigurace infrastruktury (například vlastní domény, umístění a certifikáty certifikační autority) se uzamkne po dobu 45 minut. Po migraci se nevyžaduje žádná další konfigurace.

Předem vytvořená IP adresa pro migraci

Pro instance služby API Management, které jsou dostupné veřejnou IP adresou, služba API Management předem vytvoří veřejnou IP adresu pro proces migrace. Najděte předem vytvořenou IP adresu ve výstupu JSON vlastností vaší instance služby API Management. V části customProperties, předem vytvořený IP adresa je hodnota Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps vlastnosti. Pro nasazení ve více oblastech je hodnota čárkami oddělený seznam předem vytvořených IP adres.

Pomocí předem vytvořených IP adres (nebo adres) můžete spravovat proces migrace:

  • Při migraci a zachování VIRTUÁLNÍ IP adresy se předem vytvořená IP adresa přiřadí dočasně k novému stv2 nasazení před přiřazením původní IP adresy k stv2 nasazení. Pokud máte pravidla brány firewall, která omezují přístup k instanci služby API Management, můžete například přidat předem vytvořenou IP adresu do seznamu povolených, aby se zachoval kontinuita přístupu klientů během migrace. Po dokončení migrace můžete z seznamu povolených odebrat předem vytvořenou IP adresu.
  • Když migrujete a vygenerujete novou VIRTUÁLNÍ IP adresu, předvytvořená IP adresa se přiřadí k novému stv2 nasazení během migrace a po dokončení migrace se zachovají. Předem vytvořenou IP adresu použijte k aktualizaci závislostí sítě, jako jsou pravidla DNS a brány firewall, aby odkazovaly na novou IP adresu.

Kroky migrace

  1. Na webu Azure Portal přejděte k vaší instanci služby API Management.

  2. V nabídce vlevo v části Nastavení vyberte Migraci platformy.

  3. Na stránce Migrace platformy vyberte jednu ze dvou možností migrace:

    • Nová virtuální IP adresa. Virtuální IP adresa vaší instance služby API Management se automaticky změní. Vaše služba nebude mít žádný výpadek, ale po migraci budete muset aktualizovat všechny závislosti sítě, včetně DNS, pravidel brány firewall a virtuálních sítí, aby používaly novou VIRTUÁLNÍ ADRESU.

    • Zachování IP adresy – VIRTUÁLNÍ IP adresa vaší instance služby API Management se nezmění. Vaše instance bude mít výpadek až 15 minut.

      Snímek obrazovky s migrací platformy API Management na portálu

  4. Projděte si pokyny pro proces migrace a připravte prostředí.

  5. Jakmile dokončíte přípravné kroky, vyberte I have read and understand the impact of the migration process. Vyberte Migrovat.

Ověření migrace

Pokud chcete ověřit, že migrace proběhla úspěšně, zkontrolujte, jestli se stav online změní na verzi platformy vaší instance služby API Management. Po úspěšné migraci je stv2 hodnota nebo stv2.1.

Pokud se migrace nezdaří, vrátí se automaticky.

Pokud během procesu migrace dojde k selhání, instance se automaticky vrátí na platformu stv1 . Pokud se migrace úspěšně dokončí (verze platformy instance se zobrazuje jako stv2 nebo stav online), nemůžete se vrátit zpět na platformu stv1 stv2.1.

Pokud migrace selže, obraťte se na podpora Azure.

Pokud potřebujete možnost vrátit se zpět ručně, doporučujeme nasadit novou stv2 instanci souběžně s původní instancí služby API Management.

Aktualizace závislostí sítě

Po úspěšné migraci na novou IP adresu aktualizujte všechny závislosti sítě, včetně DNS, pravidel brány firewall a virtuálních sítí, aby používaly novou IP adresu.

Nápověda a podpora

Jsme tady, abychom vám pomohli migrovat na platformu stv2 s minimálním přerušením služeb.

Pokud máte otázky, získejte rychlé odpovědi od odborníků z komunity v Microsoft Q&A. Pokud máte plán podpory a potřebujete technickou pomoc, vytvořte žádost o podporu.

  1. Jako souhrn zadejte popis vašeho problému, například "stv1 retirement".
  2. V části Typ problému vyberte Technická.
  3. V části Předplatné vyberte své předplatné.
  4. V části Služba vyberte My services (Moje služby) a pak vyberte API Management Service (Služba API Management).
  5. V části Prostředek vyberte prostředek Azure, pro který vytváříte žádost o podporu.
  6. V případě typu problém vyberte Správa a správa.
  7. V podtypu Problém vyberte Upgrade, Škálování nebo Změny skladové položky.

Nejčastější dotazy

  • Jaké informace potřebujeme k výběru cesty migrace?

    • Jaký je síťový režim instance služby API Management?
    • Jsou nakonfigurované vlastní domény?
    • Týká se brána firewall?
    • Existují nějaké známé závislosti, které zprovozní nadřazené nebo podřízené ip adresy?
    • Jedná se o nasazení ve více oblastech?
    • Můžeme upravit existující instanci nebo je vyžadováno paralelní nastavení?
    • Může dojít k výpadkům?
    • Je možné migraci provést v nepracovních hodinách?

  • Jaké jsou požadavky na migraci?

    Pro instance, které nejsou vložené do virtuální sítě, nejsou vyžadovány žádné požadavky. Pokud migrujete zachování veřejné IP adresy, vykreslí se instance služby API Management přibližně po dobu 15 minut. Pokud zvolíte možnost Nová virtuální IP adresa, která zpřístupňuje službu API Management na nové IP adrese , nemusí dojít k výpadku. Instance nakonfigurované s vlastní doménou pomocí záznamu A nebo síťové závislosti na veřejné virtuální IP adrese budou mít výpadek, když se vyžádá nová virtuální IP adresa.

  • Způsobí migrace výpadek?

    V případě nespravovaných instancí virtuálních sítí dochází k výpadkům přibližně 15 minut, pouze pokud se rozhodnete zachovat původní IP adresu. Pokud ale migrujete s novou IP adresou a nemáte žádné síťové závislosti na nové IP adrese, nedojde k žádnému výpadku. Mezi závislosti sítě patří vlastní název domény bez CNAME, seznamu povolených IP adres, pravidel brány firewall a virtuálních sítí.

  • Mohou během migrace dojít ke ztrátám dat nebo konfigurace?

    stv1 migrace stv2 zahrnuje aktualizaci samotné výpočetní platformy a vnitřní vrstva úložiště se nezmění. Proto je veškerá konfigurace během procesu migrace bezpečná. Patří sem spravovaná identita přiřazená systémem, která je v případě povolení zachována.

  • Jak ověřit, že je migrace dokončená a úspěšná?

    Migrace se považuje za dokončenou a úspěšnou, když se stav na stránce přehledu přečte online spolu s verzí platformy, která je buď stv2 nebo stv2.1. Ověřte také, že se stav sítě v okně sítě zobrazuje zeleně pro všechna požadovaná připojení.

  • Můžu migraci provést pomocí portálu?

    Ano, okno Migrace platformy na webu Azure Portal vás provede migrací pro instance, které nejsou vložené do virtuální sítě.

  • Můžu zachovat IP adresu instance?

    Ano, IP adresu je možné zachovat, ale dojde k výpadku přibližně 15 minut.

  • Existuje cesta migrace beze změny existující instance?

    Ano, potřebujete souběžnou migraci. To znamená, že vytvoříte novou instanci služby API Management paralelně s vaší aktuální instancí a zkopírujete konfiguraci do nové instance.

  • Co se stane, když se migrace nezdaří?

    Pokud vaše instance služby API Management po zahájení migrace nezobrazuje verzi platformy jako stv2 nebo stv2.1 stav online , pravděpodobně se nezdařila. Vaše služba se automaticky vrátí zpět do staré instance a neprovedou se žádné změny. Pokud máte problémy (například pokud je stav Aktualizace delší než 2 hodiny), kontaktujte podpora Azure.

  • Jaké funkce nejsou během migrace k dispozici?

    Pro instance, které nejsou vložené do virtuální sítě:

    • Pokud jste se rozhodli zachovat původní IP adresu: Požadavky rozhraní API nereagují přibližně 15 minut, zatímco SE IP adresa migruje do nové infrastruktury. Konfigurace infrastruktury (například vlastní domény, umístění a certifikáty certifikační autority) je uzamčená po dobu 45 minut.
    • Pokud jste se rozhodli migrovat na novou IP adresu: Požadavky rozhraní API zůstanou během migrace responzivní. Konfigurace infrastruktury (například vlastní domény, umístění a certifikáty certifikační autority) je uzamčená po dobu 30 minut. Po migraci budete muset aktualizovat všechny závislosti sítě, včetně DNS, pravidel brány firewall a virtuálních sítí, aby používaly novou VIRTUÁLNÍ ADRESU.

  • Jak dlouho bude migrace trvat?

    Očekávaná doba trvání celé migrace je přibližně 45 minut. Indikátorem, který zkontroluje, jestli se migrace už provedla, je zkontrolovat, jestli je stav vaší instance zpátky na online a neaktualizuje se. Pokud se zobrazí zpráva Aktualizace po dobu delší než 2 hodiny, kontaktujte podpora Azure.

  • Můžu v případě potřeby vrátit migraci zpět?

    Pokud během procesu migrace dojde k selhání, instance se automaticky vrátí na platformu stv1 . Po úspěšné migraci služby se ale nemůžete vrátit zpět na platformu stv1 .

  • Vyžaduje se nějaká změna ve vlastních doménách nebo privátních zónách DNS?

    V případě instancí, které nejsou vložené do virtuální sítě, se v případě zachování IP adresy nevyžadují žádné změny. Pokud se rozhodnete pro novou IP adresu, měly by se aktualizovat vlastní domény odkazující na IP adresu.

  • Moje instance stv1 se nasadí do několika oblastí Azure (více oblastí). Návody upgradovat na stv2?

    V případě služby API Management, která není vložena do virtuální sítě, postupujte podle kroků migrace pomocí portálu nebo Azure CLI. Všechny oblasti budou migrovány do stv2.

  • Co bychom měli zvážit pro brány v místním prostředí?

    V branách v místním prostředí nemusíte nic dělat. Stačí migrovat instance služby API Management spuštěné v Azure, které mají vliv na stv1 vyřazení platformy. Všimněte si, že pro koncový bod konfigurace instance služby API Management může existovat nová IP adresa a všechna omezení sítě připnutá k IP adrese by se měla aktualizovat.

  • Jaký vliv má migrace na portál pro vývojáře?

    Portál pro vývojáře nemá žádný vliv. Pokud se použijí vlastní domény, měl by se záznam DNS aktualizovat efektivní IP adresou po migraci. Pokud se ale používají výchozí domény, automaticky se aktualizují při úspěšné migraci. Během migrace nedojde k žádnému výpadku vývojářského portálu.

  • Má po migraci na stv2 nějaký dopad na náklady?

    Fakturační model zůstane stejný stv2 a během migrace ani po ní nebudou žádné další náklady.

  • Jaká oprávnění RBAC se vyžadují pro migraci stv1 na stv2?

    Uživatel/proces, který provádí migraci, potřebuje přístup k zápisu do instance služby API Management.

Související obsah