Postup při nasazení instance služby Azure API Management do několika oblastí Azure

Azure API Management podporuje nasazení ve více oblastech, což umožňuje vydavatelům rozhraní API distribuovat jednu službu Azure API Management napříč libovolným počtem podporovaných oblastí Azure. Funkce více oblastí pomáhá snižovat latenci požadavku vnímanou uživateli geograficky distribuovaného rozhraní API a vylepšuje dostupnost služby v případě, že jedna oblast přejde do režimu offline.

Nová služba Azure API Management zpočátku obsahuje jenom jednu jednotku v jedné oblasti Azure, primární oblasti. Další jednotky lze přidat do primární nebo sekundární oblasti. Komponenta API Management Gateway je nasazená do všech vybraných primárních a sekundárních oblastí. Příchozí požadavky rozhraní API se automaticky přesměrují do nejbližší oblasti. Pokud se oblast přepne do režimu offline, požadavky rozhraní API se automaticky přesměrují kolem neúspěšné oblasti do nejbližší nejbližší brány.

Poznámka

Do všech oblastí je nasazená jenom součást brány API Management. Komponenta správy služby a portál pro vývojáře se hostují jenom v primární oblasti. Proto se v případě výpadku primární oblasti přístup k portálu pro vývojáře a možnosti změny konfigurace (např. Přidání rozhraní API, použití zásad) ztratí, dokud se primární oblast znovu nevrátí do režimu online. I když je primární oblast offline, dostupné sekundární oblasti budou dál obsluhovat přenosy rozhraní API, a to pomocí nejnovější konfigurace, která je k dispozici. Volitelně povolte redundanci zóny , aby se zlepšila dostupnost a odolnost primárních nebo sekundárních oblastí.

Důležité

Funkce pro ukládání zákaznických dat v jedné oblasti je v tuto chvíli dostupná jenom v oblasti jihovýchodní Asie (Singapur) Asie a Tichomoří geografické oblasti. Pro všechny ostatní oblasti jsou zákaznická data uložená v geograficky.

Dostupnost

Důležité

tato funkce je k dispozici pouze v Premium vrstvě API Management.

Požadavky

  • Pokud jste ještě nevytvořili instanci služby API Management, přečtěte si téma vytvoření instance služby API Management. vyberte úroveň služby Premium.
  • Pokud je vaše instance API Management nasazená ve virtuální síti, ujistěte se, že jste nastavili virtuální síť, podsíť a veřejnou IP adresu v umístění, které hodláte přidat.

Nasazení služby API Management do dalšího umístění

  1. V Azure Portal přejděte do služby API Management a v nabídce vyberte umístění .
  2. V horním panelu vyberte + Přidat .
  3. V rozevíracím seznamu vyberte umístění.
  4. Vyberte počet jednotek škálování v umístění.
  5. Volitelně můžete povolit zóny dostupnosti.
  6. Pokud je instance API Management nasazena ve virtuální síti, nakonfigurujte nastavení virtuální sítě v umístění. Vyberte existující virtuální síť, podsíť a veřejnou IP adresu, která je k dispozici v umístění.
  7. Kliknutím na tlačítko Přidat potvrďte.
  8. Tento postup opakujte, dokud nebudete konfigurovat všechna umístění.
  9. Vyberte Uložit na horním panelu a spusťte proces nasazení.

Odstranění umístění služby API Management

  1. V Azure Portal přejděte do služby API Management a v nabídce klikněte na položku umístění .
  2. Pro umístění, které chcete odebrat, otevřete místní nabídku pomocí tlačítka ... na pravé straně tabulky. Vyberte možnost Odstranit .
  3. Potvrďte odstranění a klikněte na Uložit , aby se změny projevily.

Směrování volání rozhraní API do regionálních back-end služeb

Azure API Management nabízí jenom jednu adresu URL back-end služby. I když v různých oblastech existují instance Azure API Management, brána API dál předává požadavky do stejné back-endové služby, která je nasazená jenom v jedné oblasti. V takovém případě se zisk výkonu dostane jenom z odpovědí uložených v mezipaměti v rámci Azure API Management v oblasti specifické pro požadavek, ale při kontaktování back-endu na celém světě může stále dojít k vysoké latenci.

Aby bylo možné plně využít geografickou distribuci vašeho systému, měli byste mít nasazené back-end služby ve stejných oblastech jako instance Azure API Management. Potom můžete pomocí zásad a @(context.Deployment.Region) vlastností směrovat provoz do místních instancí vašeho back-endu.

  1. Přejděte do instance Azure API Management a v nabídce vlevo klikněte na rozhraní API .

  2. Vyberte požadované rozhraní API.

  3. V rozevíracím seznamu šipky v příchozím zpracováníklikněte na Editor kódu .

    API code editor

  4. Použijte set-backend kombinaci s podmíněnými choose zásadami k vytvoření správné zásady směrování v <inbound> </inbound> části souboru.

    Například následující soubor XML by fungoval pro Západní USA a Východní Asie oblasti:

    <policies>
        <inbound>
            <base />
            <choose>
                <when condition="@("West US".Equals(context.Deployment.Region, StringComparison.OrdinalIgnoreCase))">
                    <set-backend-service base-url="http://contoso-us.com/" />
                </when>
                <when condition="@("East Asia".Equals(context.Deployment.Region, StringComparison.OrdinalIgnoreCase))">
                    <set-backend-service base-url="http://contoso-asia.com/" />
                </when>
                <otherwise>
                    <set-backend-service base-url="http://contoso-other.com/" />
                </otherwise>
            </choose>
        </inbound>
        <backend>
            <base />
        </backend>
        <outbound>
            <base />
        </outbound>
        <on-error>
            <base />
        </on-error>
    </policies>
    

Tip

back-endové služby můžete také napředt pomocí Azure Traffic Manager, nasměrovat volání rozhraní API do Traffic Manager a nechat ho automaticky vyřešit.

Použití vlastního směrování k API Management regionálních bran

API Management směruje požadavky na místní bránu na základě nejnižší latence. i když není možné toto nastavení v API Management přepsat, můžete použít vlastní Traffic Manager s vlastními pravidly směrování.

  1. vytvořte vlastní Azure Traffic Manager.
  2. pokud používáte vlastní doménu, použijte ji s Traffic Manager namísto služby API Management.
  3. Nakonfigurujte API Management místní koncové body v Traffic Manager. Regionální koncové body následují jako vzor adresy URL https://<service-name>-<region>-01.regional.azure-api.net , například https://contoso-westus2-01.regional.azure-api.net .
  4. Konfigurace API Managementch koncových bodů regionálního stavu v Traffic Manager. Místní koncové body stavu se řídí vzorem adresy URL https://<service-name>-<region>-01.regional.azure-api.net/status-0123456789abcdef , například https://contoso-westus2-01.regional.azure-api.net/status-0123456789abcdef .
  5. Zadejte metodu směrování Traffic Manager.