Dela via

Supportprinciper för lokalt installerad gateway

  • Artikel

GÄLLER FÖR: Utvecklare | Premium

Azure API Management-tjänsten i nivåerna Utvecklare och Premium tillåter distribution av API Management gateway som en container som körs i lokal infrastruktur, andra moln och Azure-infrastrukturalternativ som stöder containrar. Den här artikeln innehåller information om principer för teknisk support och begränsningar för den lokala API Management-gatewayen.

Viktigt!

Stöd för azure API Management med egen värdbaserad gateway version 0 och version 1-containeravbildningar upphör den 1 oktober 2023, tillsammans med motsvarande Konfigurations-API v1. Använd vår migreringsguide för att använda lokalt installerad gateway v2.0.0 eller senare med Configuration API v2. Läs mer i vår utfasningsdokumentation

Skillnader mellan hanterad gateway och lokalt installerad gateway

När du distribuerar en instans av API Management-tjänsten får du alltid en hanterad API-gateway som en del av tjänsten. Den här gatewayen körs i infrastruktur som hanteras av Azure och programvaran hanteras, uppdateras och hanteras av Azure.

På tjänstnivåer som stöds är den lokalt installerade gatewayen ett valfritt distributionsalternativ.

Även om de hanterade och lokalt installerade gatewayerna delar många vanliga funktioner finns det också flera skillnader.

Ansvar

I följande tabell visas Microsofts ansvarsområden, delade ansvarsområden och kundernas ansvar för att hantera och stödja den lokala gatewayen.

Microsoft Azure Delat ansvar Kunder
▪️ Konfigurationsslutpunkt (hanteringsplan) – Den lokalt installerade gatewayen beror på en konfigurationsslutpunkt som tillhandahåller konfiguration, API:er, värdnamn och principinformation. Den här konfigurationsslutpunkten är en del av hanteringsplanet för varje API Management-tjänst.

▪️ Underhåll och uppdateringar av gatewaycontainerns avbildning – Felkorrigeringar, korrigeringar, prestandaförbättringar och nya funktioner i den lokala gatewaycontainern.		 ▪ Skydda lokal gatewaykommunikation med konfigurationsslutpunkten – Kommunikationen mellan den lokalt installerade gatewayen och konfigurationsslutpunkten kan skyddas med två mekanismer: antingen en åtkomsttoken som upphör att gälla automatiskt var 30:e dag och som måste uppdateras för containrar som körs eller autentisering med Microsoft Entra-ID, vilket inte kräver tokenuppdatering.

▪ Hålla gatewayen uppdaterad – Kunden övervakar regelbundet uppdatering av gatewayen till den senaste versionen och de senaste funktionerna. Och Microsoft tillhandahåller uppdaterade bilder med nya funktioner, buggkorrigeringar och korrigeringar.		 ▪ Gateway-värd – Distribuera och använda gatewayinfrastrukturen: virtuella datorer med containerkörning och/eller Kubernetes-kluster.

▪ Nätverkskonfiguration – Krävs för att upprätthålla hanteringsplanets anslutning och API-åtkomst.

▪ Gateway SLA – Kapacitetshantering, skalning och drifttid.

▪ Tillhandahålla diagnostikdata som stöd – Samla in och dela diagnostikdata med supporttekniker.

▪ Programvarukomponenter från tredje part OSS (programvara med öppen källkod) – Det är kundens ansvar att kombinera den lokalt installerade gatewayen med annan programvara som Prometheus, Grafana, servicenät, containerkörningar, Kubernetes-distributioner och proxyservrar.

Stöd för avbildningstäckning för lokalt installerad gatewaycontainer

Vi har följande taggningsstrategi för den lokalt installerade gatewaycontaineravbildningen, enligt den större, mindre, korrigeringskonventionen: {major}.{minor}.{patch}. Du hittar en fullständig lista över tillgängliga taggar. Som bästa praxis rekommenderar vi att kunderna kör den senaste stabila versionen av vår containeravbildning. Med tanke på de kontinuerliga versionerna av containeravbildningen ger vi officiellt stöd för följande versioner:

Versioner som stöds

  • Senaste huvudversionen och de tre senaste delversionerna

    Om den senaste versionen till exempel är 2.2.0 stöder vi alla 2.2.x-, 2.1.x- och 2.0.x-delversioner. För alla tidigare versioner ber vi dig att uppdatera till en version som stöds.

  • Fixar

    Om vi upptäcker ett problem med bugg, CVE eller prestanda i en version som stöds, till exempel om det finns en bugg i containeravbildningen 2.0.0, hamnar korrigeringen som en korrigering i den senaste delversionen, till exempel 2.2.x.

Versioner som inte stöds

  • Containeravbildningar med taggen beta .

  • Alla versioner med suffixet preview .

Supportscenarier för lokalt installerad gateway

Microsoft tillhandahåller teknisk support för följande exempel

  • Drifttid och konfiguration av konfigurationsslutpunkt och hanteringsplan för de nivåer som stöds.

  • Buggar, prestandaproblem och förbättringar för en gatewaycontaineravbildning med egen värd.

  • Säkerhetskorrigeringar för lokalt installerad gatewaycontaineravbildning (CVE) kommer att åtgärdas så snart som möjligt.

  • Projekt med öppen källkod från tredje part som stöds, till exempel: Öppna telemetri och DAPR (Distributed Application Runtime).

Microsoft tillhandahåller inte teknisk support för följande exempel

  • Frågor om hur du använder den lokala gatewayen i Kubernetes. Microsoft Support ger till exempel inte råd om hur du skapar anpassade ingresskontrollanter, tjänstnät, använder programarbetsbelastningar eller tillämpar programvarupaket eller verktyg från tredje part eller öppen källkod.

  • Projekt med öppen källkod från tredje part i kombination med vår lokala gateway, förutom specifika projekt som stöds, till exempel: Open Telemetry och DAPR (Distributed Application Runtime).

  • Programvara från tredje part med sluten källkod, inklusive säkerhetsgenomsökningsverktyg och nätverksenheter eller programvara.

  • Felsöka nätverksanpassningar, CNIs, tjänstnät, nätverksprinciper, brandväggar och komplexa nätverkskretsar. Microsoft kontrollerar endast att kommunikationen mellan en lokalt installerad gateway och konfigurationsslutpunkten fungerar.

Buggar och problem

Om du har frågor kan du få svar från communityexperter i Vanliga frågor och svar om Microsoft.

Om du har ett supportavtal och behöver teknisk hjälp skapar du en supportbegäran:

  1. Som Typ av problem väljer du Teknisk.

  2. I fältet Prenumeration väljer du din prenumeration.

  3. För Tjänst väljer du Mina tjänster och sedan API Management Service.

  4. För Resurs väljer du den Azure-resurs som du skapar en supportbegäran för.

  5. Som Problemtyp väljer du Lokalt installerad gateway.

Du kan också få hjälp från våra communities. Du kan skapa ett problem på GitHub eller ställa frågor om Stack Overflow och tagga dem med "azure-api-management".

Nästa steg