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 acceleratorn API Management landningszon. Plattformsautomatisering och DevOps ger möjlighet att modernisera din metod för miljödistribution med alternativ för infrastruktur som kod.
Läs mer om plattformsautomatisering och DevOps-designområdet .
Designöverväganden
- Varje API-team kan skicka uppdateringar från sin egen utvecklarrepo till sin egen API Management instans.
- 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 produktionsmiljön API Management.
- API Management konfigurationer representeras som Resource Manager mallar eller motsvarande Bicep- eller Terraform-mallar, och ett infrastruktur-som-kod-tänkesätt bör omfamnas.
- API Management-administratörsteamet publicerar konfigurationsändringar i produktionsmiljön API Management från en Git-lagringsplats (utgivarens lagringsplats) som ägs av API Management administratörsteamet.
- Varje enskilt API-team kan förgrena utgivarens lagringsplats så att den har en egen utvecklarrepo att arbeta från.
- 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 utveckling API Management instans. Dessa artefakter baseras på Azure Resource Manager och bör checkas in på API-teamets Git-lagringsplats.
Anteckning
Använd inte API Management Git-integrering.
- Tjänstmallar och delade mallar ska finnas i separata lagringsplatser.
- Ändringar av artefakter bör göras i de extraherade artefakterna och sedan checkas in på Git. Dessa bör distribueras till en utvecklingsmiljö.
- Om du vill höja 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 verifierar PR.
- Helst automatiseras de flesta valideringar som en del av att skicka en PR.
- Mallarna för infrastruktur som kod ska finnas på en annan lagringsplats – och distribueras i en distributionspipeline.
- Separera infrastrukturdistribution från programdistribution. 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 sammanfogats 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 landningszonaccelerator:
- Använda Bicep-filer med infrastruktur som kod för att distribuera API Management infrastruktur och serverdelar.
- Distribution av infrastrukturmallar med pipelines.