Dela via

Plattformsautomatisering och DevOps för API Management-acceleratorn för landningszoner

Den här artikeln innehåller designöverväganden och rekommendationer för plattformsautomatisering och DevOps när du använder API Management-acceleratorn för landningszoner. Plattformsautomatisering och DevOps ger möjligheter att modernisera din metod för miljödistribution med alternativ för infrastruktur som kod.

Läs mer om designområdet plattformsautomatisering och DevOps .

Designöverväganden

  • Varje API-team kan skicka uppdateringar från sitt eget utvecklar-repo till sin egen utvecklingsinstans av API Management.
    • Vad innebär detta ur ett nätverksplaneringsperspektiv?
    • Hur är det med andra icke-produktionsmiljöer (till exempel QA eller mellanlagring)?
  • Överväg hur produkter och andra entiteter ska hanteras eller versionshanteras, särskilt om flera team använder samma produkter.
  • Överväg teststrategin för API:er och principer.

Designrekommendationer

  • Ett centralt team (till exempel ett API Management-administratörsteam) hanterar produktions-API Management-miljön.
  • API Management-konfigurationer representeras som Resource Manager-mallar eller motsvarande Bicep- eller Terraform-mallar, och ett tänkesätt för infrastruktur som kod bör omfamnas.
  • API Management-administratörsteamet publicerar konfigurationsändringar i PRODUKTIONS-API Management-miljön från en Git-lagringsplats (utgivarens lagringsplats) som ägs av API Management-administratörsteamet.
  • Varje enskilt API-team kan forka utgivarens repo för att ha ett eget utvecklarrepo att arbeta i.
  • Varje team kan använda API Management APIOps eller API Management-tillägget för Visual Studio Code för att extrahera relevanta artefakter från deras API Management-instans för utveckling. Dessa artefakter baseras på Azure Resource Manager och bör föras in i API-teamets Git-lagringsplats.

    Anmärkning

    Använd inte API Management Git-integreringen.

  • Tjänstmallar och delade mallar ska finnas i separata lagringsplatser.
  • Ändringar av artefakter bör göras i de extraherade artefakterna och sedan kommas in till Git. Dessa bör distribueras till en utvecklingsmiljö.
  • Om du vill flytta upp till de centraliserade miljöerna (mellanlagring, produktion och så vidare) kan API-team skicka en pull-begäran (PR) för att sammanfoga sina ändringar till utgivarens lagringsplats.
  • API Management-administratörsteamet validerar PR.
    • Helst automatiseras de flesta valideringarna som en del av att skicka en PR.
  • Mallarna infrastruktur som kod ska finnas på en annan lagringsplats – och distribueras i en distributionspipeline.
    • Separera infrastrukturdistributionen från programdistributionen. Kärninfrastrukturen ändras mindre ofta än program. Behandla varje typ av distribution som ett separat flöde och en pipeline.
  • När ändringarna har godkänts och slagits samman kan API Management-administratörsteamet distribuera ändringarna till den centralt hanterade miljön (mellanlagring, produktion) i samordning med överenskomna API-teamscheman.

Antaganden i företagsskala

Följande är antaganden som gick in i utvecklingen av API Management-acceleratorn för landningszoner:

  • Använda Bicep-filer med infrastruktur som kod för att distribuera API Management-infrastruktur och serverdelar.
  • Distribution av infrastrukturmallar med hjälp av pipelines.

Nästa steg