Použití externí mezipaměti kompatibilní s Redis ve službě Azure API Management

PLATÍ PRO: Všechny úrovně služby API Management

Kromě využití integrované mezipaměti umožňuje Azure API Management ukládání odpovědí do mezipaměti v externí mezipaměti kompatibilní s Redis, jako je Azure Managed Redis.

Použití externí mezipaměti umožňuje překonat několik omezení integrované mezipaměti:

  • Vyhněte se pravidelnému vymazání mezipaměti během aktualizací služby API Management.
  • Mít větší kontrolu nad konfigurací mezipaměti
  • Ukládání více dat do mezipaměti, než umožňuje úroveň API Management
  • Použití ukládání do mezipaměti s úrovní Consumption ve službě API Management
  • Povolení ukládání do mezipaměti v bráně v místním prostředí služby API Management

Základní informace a scénáře pro ukládání do mezipaměti najdete v tématu Přehled ukládání do mezipaměti.

Podrobnější informace o ukládání do mezipaměti najdete v částech věnovaných zásadám ukládání do mezipaměti služby API Management a vlastnímu ukládání do mezipaměti ve službě Azure API Management.

Poznámka:

V současné době tato funkce není dostupná v pracovních prostorech.

Naučíte se:

  • Přidání externí mezipaměti ve službě API Management

Požadavky

Pro absolvování tohoto kurzu je potřeba provést následující:

  • Vytvoření instance Azure API Managementu

  • Principy ukládání do mezipaměti ve službě Azure API Management

  • Máte k dispozici Azure Managed Redis nebo jinou mezipaměť kompatibilní s Redis.

    Důležité

    Azure API Management používá k připojení k mezipaměti připojovací řetězec Redis. Pokud používáte Azure Managed Redis, povolte ověřování pomocí přístupového klíče ve své mezipaměti, aby bylo možné použít připojovací řetězec. V současné době nemůžete použít ověřování Microsoft Entra k připojení služby Azure API Management ke službě Azure Managed Redis.

Mezipaměť Redis pro Kubernetes

Pro samo-hostovanou bránu služby API Management vyžaduje ukládání do mezipaměti externí mezipaměť. Aby ukládání do mezipaměti bylo efektivní, musí být samohostovaná brána a mezipaměť, na kterou se spoléhá, umístěny blízko sebe, aby se minimalizovala latence při vyhledávání a ukládání. Nejlepšími možnostmi jsou nasazení mezipaměti Redis do stejného clusteru Kubernetes nebo v samostatném clusteru poblíž. Zjistěte, jak nasadit mezipaměť Redis do clusteru Kubernetes.

Přidání externí mezipaměti

Pokud chcete přidat externí mezipaměť kompatibilní s Redis ve službě Azure API Management, postupujte podle následujících kroků. Mezipaměť můžete omezit na konkrétní bránu v instanci služby API Management.

Snímek obrazovky, který ukazuje, jak přidat externí mezipaměť Azure Managed Redis ve službě Azure API Management

Použití z nastavení

Nastavení Použít z v konfiguraci určuje umístění vaší instance služby API Management, která bude používat mezipaměť. Vyberte jednu z následujících možností:

  • Oblast Azure, kde je instance služby API Management hostována (nebo jedno z nakonfigurovaných umístění, pokud máte nasazení ve více regionech)

  • Umístění brány hostované lokálně

  • Ve výchozím nastavení nakonfigurujte mezipaměť jako výchozí pro všechna umístění brány v instanci služby API Management.

    Mezipaměť použitá pro výchozí je přepsána mezipamětí používanou pro konkrétní odpovídající oblast nebo umístění.

    Představte si například instanci služby API Management hostované v oblastech USA – východ, Jihovýchodní Asie a Západní Evropa. Jsou nakonfigurované dvě mezipaměti, jedna pro výchozí a jedna pro jihovýchodní Asii. V tomto příkladu používá služba API Management v jihovýchodní Asii vlastní mezipaměť, zatímco ostatní dvě oblasti používají položku Výchozí mezipaměť.

Poznámka:

Stejnou externí mezipaměť můžete nakonfigurovat pro více než jednu instanci služby API Management. Instance služby API Management můžou být ve stejných nebo různých oblastech. Při sdílení mezipaměti pro více než jednu instanci musíte v Use from vybrat Default.

Přidání instance Azure Managed Redis ze stejného předplatného

  1. Na webu Azure Portal přejděte k vaší instanci služby API Management.
  2. V nabídce vlevo v části Nasazení a infrastruktura vyberte Externí mezipaměť.
  3. Vyberte + Přidat.
  4. V rozevíracím seznamu instance mezipaměti vyberte mezipaměť.
  5. V rozevíracím seznamu Použít z vyberte Výchozí nebo zadejte požadovanou oblast. Připojovací řetězec se vyplní automaticky.
  6. Zvolte Uložit.

Poznámka:

Výchozí připojovací řetězec je ve formuláři <cache-name>:10000,password=<cache-access-key>,ssl=True,abortConnect=False. Api Management ukládá řetězec jako tajnou pojmenovanou hodnotu. Pokud potřebujete zobrazit nebo upravit řetězec a otočit přístupový klíč nebo vyřešit potíže s připojením, přejděte do okna Pojmenované hodnoty .

Přidejte cache kompatibilní s Redis hostovanou mimo aktuální předplatné Azure nebo mimo Azure obecně.

  1. Na webu Azure Portal přejděte k vaší instanci služby API Management.
  2. V nabídce vlevo v části Nasazení a infrastruktura vyberte Externí mezipaměť.
  3. Vyberte + Přidat.
  4. V rozbalovacím seznamu Cache vyberte Custom.
  5. V rozevíracím seznamu Použít z vyberte Výchozí nebo zadejte požadovanou oblast.
  6. Do pole Připojovací řetězec zadejte připojovací řetězec mezipaměti kompatibilní s Azure Managed Redis nebo Redis.
  7. Zvolte Uložit.

Přidání mezipaměti Redis do samostatně hostované brány

  1. V nabídce vlevo v části Nasazení a infrastruktura vyberte Externí mezipaměť.
  2. Vyberte + Přidat.
  3. V rozbalovacím seznamu Cache vyberte Custom.
  4. V rozevíracím seznamu Použít z vyberte Výchozí nebo zadejte požadovanou oblast.
  5. Zadejte připojovací řetězec mezipaměti Redis do pole Připojovací řetězec.
  6. Zvolte Uložit.

Použití externí mezipaměti

Po přidání mezipaměti kompatibilní s Redis nakonfigurujte zásady ukládání do mezipaměti, které povolí ukládání odpovědí do mezipaměti nebo ukládání hodnot do mezipaměti podle klíče v externí mezipaměti.

Podrobný příklad najdete v tématu Přidání ukládání do mezipaměti za účelem zvýšení výkonu ve službě Azure API Management.