Distributionsportar

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Grindar tillåter automatisk insamling av hälsosignaler från externa tjänster och höjer sedan upp lanseringen när alla signaler lyckas eller stoppar distributionen vid timeout. Portar används vanligtvis i anslutning till incidenthantering, problemhantering, ändringshantering, övervakning och externa godkännandesystem.

Användningsfall

Några vanliga användningsfall för distributionsportar är:

• Incidenthantering: Se till att vissa kriterier uppfylls innan du fortsätter med distributionen. Se till exempel till att distributionen endast sker om det inte finns några buggar med noll prioritet.
• Sök godkännanden: Meddela externa användare, till exempel juridiska avdelningar, granskare eller IT-chefer om en distribution genom att integrera med andra tjänster som Microsoft Teams eller Slack och vänta på deras godkännanden.
• Kvalitetsvalidering: Frågepipelinemått, till exempel passfrekvens eller kodtäckning, och distribueras endast om de ligger inom ett fördefinierat tröskelvärde.
• Säkerhetsgenomsökning: Utför säkerhetskontroller, till exempel genomsökning av artefakter, kodsignering och principkontroll. En distributionsport kan initiera genomsökningen och vänta tills den har slutförts, eller bara söka efter slutförande.
• Användarupplevelse i förhållande till baslinje: Kontrollera att användarupplevelsen inte har regresserats från baslinjetillståndet med hjälp av produkttelemetri. Användarupplevelsemåtten innan distributionen kunde användas som baslinje.
• Ändringshantering: Vänta tills procedurerna för ändringshantering i ett system som ServiceNow har slutförts innan du fortsätter med distributionen.
• Infrastrukturhälsa: Kör övervakning och verifiera infrastrukturen mot efterlevnadsregler efter distributionen, eller vänta på felfri resursanvändning och en positiv säkerhetsrapport.

De flesta hälsoparametrar varierar över tid och ändrar regelbundet sin status från felfri till inte felfri och tillbaka till felfri. För att ta hänsyn till sådana variationer omvärderas alla portar regelbundet tills alla har lyckats samtidigt. Versionskörningen och distributionen fortsätter inte om alla portar inte lyckas i samma intervall och före den konfigurerade tidsgränsen.

Definiera en grind för en fas

Du kan aktivera grindar i början av en fas (förhandsdistributionsvillkor) eller i slutet av en fas (villkor efter distributionen) eller för båda. Mer information finns i Konfigurera grindar .

Fördröjningen före utvärderingen är en tidsfördröjning i början av grindutvärderingsprocessen som gör att portarna kan initiera, stabilisera och börja ge korrekta resultat för den aktuella distributionen. Se Gate-utvärderingsflöden för mer information.

• För portar före distributionen skulle fördröjningen vara den tid som krävs för att alla buggar ska loggas mot artefakterna som distribueras.
• För portar efter distributionen är fördröjningen den maximala tid det tar för den distribuerade appen att nå ett stabilt drifttillstånd, den tid det tar för körning av alla nödvändiga tester på den distribuerade fasen och den tid det tar för incidenter att loggas efter distributionen.

Följande portar är tillgängliga som standard:

• Anropa Azure-funktionen: Utlös körningen av en Azure-funktion och se till att den slutförs. Mer information finns i avsnittet om Azure-funktionuppgifter.
• Fråga Azure Monitor-aviseringar: Observera de konfigurerade Aviseringsreglerna för Azure Monitor för aktiva aviseringar. Mer information finns i avsntitet om Azure Monitor-uppgifter.
• Anropa REST API: Gör ett anrop till ett REST-API och fortsätt om det returnerar ett lyckat svar. Mer information finns i avsnittet om att anropa REST API-uppgift.
• Frågearbetsobjekt: Kontrollera att antalet matchande arbetsobjekt som returneras från en fråga ligger inom ett tröskelvärde. Mer information finns i avsnittet om att fråga arbetsuppgiftsåtgärder.
• Säkerhets- och efterlevnadsbedömning: Utvärdera Azure Policy-efterlevnad för resurser inom omfånget för en viss prenumeration och resursgrupp, och eventuellt på en specifik resursnivå. Mer information finns i avsnittet om att kontrollera Azure Policy-efterlevnad.

Du kan också skapa egna portar med Marketplace-tillägg.

De utvärderingsalternativ som gäller för alla portar är:

• Tid mellan omvärdering av grindar. Tidsintervallet mellan efterföljande utvärderingar av portarna. Vid varje samplingsintervall skickas nya begäranden samtidigt till varje grind och de nya resultaten utvärderas. Vi rekommenderar att samplingsintervallet är större än den längsta typiska svarstiden för de konfigurerade portarna så att alla svar kan tas emot för utvärdering.
• Timeout varefter portarna misslyckas. Den maximala utvärderingsperioden för alla portar. Distributionen avvisas om tidsgränsen nås innan alla portar lyckas under samma samplingsintervall.
• Grindar och godkännanden. Välj den körningsordning som krävs för grindar och godkännanden om du har konfigurerat båda. För förhandsdistributionsvillkor är standardinställningen att först fråga efter manuella godkännanden (användare) och sedan utvärdera grindar efteråt. Detta sparar systemet från att utvärdera portfunktionerna om versionen avvisas av användaren. För villkor efter distributionen är standardvärdet att utvärdera grindar och fråga efter manuella godkännanden endast när alla portar lyckas. Detta säkerställer att godkännarna har all information som krävs för att godkänna.

Mer information om gates-analys finns i Visa godkännandeloggar och Övervaka och spåra distributioner .

Exempel på gateutvärderingsflöde

Följande diagram illustrerar flödet av gateutvärdering där distributionen godkänns efter den inledande stabiliseringsfördröjningsperioden och tre samplingsintervall.

Följande diagram illustrerar flödet av gateutvärdering där inte alla portar har lyckats vid varje samplingsintervall efter den inledande stabiliseringsfördröjningsperioden. I det här fallet avvisas distributionen när tidsgränsen har löpt ut.

Resurser

• Skapa anpassade portar
• Twitter sentiment som en release gate
• GitHub-problem som en versionsgrind

Relaterade artiklar

• Översikt över versionsgrindar och godkännanden
• Använda portar och godkännanden för att styra distributionen
• Lägga till faser, beroenden och villkor
• Versionsutlösare