Integrera Azure Pipelines med ServiceNow-ändringshantering

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

För att förbättra samarbetet mellan utvecklings- och IT-team har Azure Pipelines stöd för integrering med ServiceNow. Teams kan minska riskerna med ändringar och följa tjänsthanteringsmetoder som ITIL (Information Technology Infrastructure Library) genom att inkludera portar för ändringshantering i versionspipelines.

I den här självstudien lär du dig att:

• Konfigurera ServiceNow-instanser.
• Inkludera ServiceNow-ändringshanteringsprocessen som en versionsgrind.
• Övervaka ändringshanteringsprocessen från versionspipelines.
• Håll ServiceNow-ändringsbegäranden uppdaterade med distributionsresultat.

Förutsättningar

• Ha ett HI-konto i en nondeveloper-instans av ServiceNow.
• Ha en Azure DevOps-organisation och ett projekt med behörigheter på organisationsnivå för att installera tillägg.
• Ha antingen en klassisk versionspipeline eller en YAML-pipeline som distribueras till en miljö i ditt Azure DevOps-projekt.
• Se till att du förstår och kan följa procedurerna i Använda grindar och godkännanden för att styra distributionen och Definiera godkännanden och kontroller.

Konfigurera ServiceNow-instansen

1. Installera Azure Pipelines-tillägget på din ServiceNow-instans. Mer information om hur du installerar appar från ServiceNow Store finns i Köpa översikt . Du behöver HI-autentiseringsuppgifter för att slutföra installationen.

2. I ServiceNow skapar du en ny användare för Azure Pipelines-tjänstkontot och ger den rollen x_mioms_azpipeline.pipelinesExecution .

   

Konfigurera Azure DevOps-organisationen och projektet

1. Installera Tillägget ServiceNow Change Management i din Azure DevOps-organisation.

   

2. I ditt Azure DevOps-projekt skapar du en ny ServiceNow-tjänstanslutning med hjälp av antingen Grundläggande autentisering eller OAuth2-autentisering. Mer information finns i Skapa en tjänstanslutning.

   

Konfigurera pipelinen

Du kan lägga till ServiceNow-integrering i en klassisk versionspipeline eller till en YAML-pipeline som distribueras till en miljö.

Klassisk

Lägg till fördistributionsporten för ServiceNow Change Management

1. I din Azure Pipelines-versionspipeline väljer du ikonen Fördistributionsvillkor .

2. På skärmen Villkor före distribution expanderar och aktiverar du Gates, väljer Lägg till bredvid Distributionsgrindar och väljer fördistributionsporten ServiceNow Change Management.

   

YAML

Lägg till kontrollen ServiceNow-ändringshantering

1. I ditt Azure DevOps-projekt väljer du Pipelines-miljöer> på den vänstra menyn och väljer den miljö som YAML-pipelinen distribuerar till.

2. På fliken Godkännanden och kontroller väljer du + för att lägga till en ny kontroll och väljer sedan och lägger till kontrollen ServiceNow Ändringshantering i din miljö.

   

Konfigurera Inställningar för ServiceNow-ändringshantering

1. På skärmen Inställningar för ServiceNow-ändringshantering går du till ServiceNow-anslutningen och väljer den ServiceNow-tjänstanslutning som du skapade tidigare.

   

2. Fyll i resten av formuläret på följande sätt:

   Inställning	beskrivning
   Åtgärd	Välj Skapa ny ändringsbegäran eller Använd befintlig ändringsbegäran.
   Ändra typ	Välj Normal, Standard eller Nödsituation.
   Kort beskrivning	Ange en sammanfattning av ändringen.
   Schema för ändringsbegäran	Du kan också ange schemat för ändringen enligt ServiceNow-arbetsflödet. Under Planerat startdatum och Planerat slutdatum anger du UTC-datum och tid i formatet yyyy-MM-ddTHH:mm:ssZ.
   Beskrivning	Du kan också ange en detaljerad beskrivning av ändringen.
   Kategori	Du kan också välja kategorin för ändringen, till exempel Maskinvara, Nätverk eller Programvara.
   Prioritet	Du kan också välja ändringens prioritet.
   Risk	Du kan också välja risknivå för ändringen.
   Påverkan	Du kan också välja vilken effekt ändringen har på verksamheten.
   Konfigurationsobjekt	Du kan också välja det konfigurationsobjekt som ändringen gäller för.
   Tilldelningsgrupp	Du kan också välja den grupp som ändringen tilldelas till.
   Avancerade>ytterligare parametrar för ändringsbegäran	Välj ellipsen bredvid fältet och välj sedan Lägg till för att lägga till fler parametrar. Namn måste vara fältnamn, inte etiketter, prefix med u_, till exempel u_backout_plan. Värden måste vara giltiga i ServiceNow. Ogiltiga poster ignoreras.
   Framgångsvillkor	Välj antingen Önskat tillstånd för ändringsbegäran eller Avancerade framgångsvillkor.
   Önskat tillstånd för ändringsbegäran	Välj det statusvärde för ändringsbegäran som krävs för att grinden ska lyckas och pipelinen ska fortsätta.
   Avancerade framgångsvillkor	Ange ett uttryck som styr när grinden ska lyckas. Ändringsbegäran definieras som root['result'] i svaret från ServiceNow. Exempel: and(eq(root['result'].state, 'New'),eq(root['result'].risk, 'Low')) Mer information finns i Uttryck.
   Referensnamn för utdatavariabler>	Ange ett referensnamn för att kunna använda utdatavariabler i distributionsarbetsflödet. Du kan komma åt gatevariabler genom att använda PREDEPLOYGATE som prefix i ett agentlöst jobb. När referensnamnet till exempel är inställt på gate1 kan du hämta numret för ändringsbegäran med hjälp av variabeln $(PREDEPLOYGATE.gate1.CHANGE_REQUEST_NUMBER).
   Lista över variabler	CHANGE_REQUEST_NUMBER är numret på ändringsbegäran. CHANGE_SYSTEM_ID är system-ID för ändringsbegäran.

Klassisk

Uppdatera pipelinen

1. I slutet av versionspipelinen lägger du till ett agentlöst jobb med uppgiften Update ServiceNow Change Request.

2. I formuläret aktivitetsinställningar går du till ServiceNow-anslutning och väljer din ServiceNow-tjänstanslutning.

3. Under Ändra begärandenummer anger du numret för ServiceNow-ändringsbegäran som ska uppdateras.

4. Välj Uppdatera status och under Uppdaterad status för ändringsbegäran väljer eller anger du statusen som ska anges för ändringsbegäran.

5. I Arbetsanteckningar under Avancerat kan du ange eventuella arbetsanteckningar som ska läggas till för uppdateringen av ändringsbegäran.

   

Kommentar

Aktiviteten Uppdatera ServiceNow-ändringsbegäran misslyckas om inget av fälten för ändringsbegäran uppdateras under körningen. ServiceNow ignorerar ogiltiga fält och värden som skickas till aktiviteten.

Skapa en version

Välj Skapa version för att starta en ny version.

Din pipeline bör skapa en ny ändringsbegäran i ServiceNow som en del av fördistributionsvillkoren som du skapade tidigare.

Pipelinen väntar på att alla portar ska lyckas inom samma exempelintervall. Om du vill kontrollera ändringsnumret väljer du statusikonen för att visa pipelineloggarna.

Ändringsbegäran placeras i kö i ServiceNow och ändringsägaren kan visa den.

Du hittar versionspipelinen som utlöste den nya ändringsbegäran under avsnittet Azure DevOps Pipeline-metadata .

När ändringen är klar för implementering och har flyttats till Implementera tillstånd återupptas körningen av pipelinen och gatestatusen ska returneras.

Ändringsbegäran stängs automatiskt efter distributionen.

YAML

Lägg till YAML-aktiviteten

Om du vill uppdatera ändringsbegäran lägger du till följande serverjobb och UpdateServiceNowChangeRequest@2 -uppgift i YAML-pipelinen.

stages:
- stage: Stage1
  jobs:
  - deployment: DeployLatest
    environment: <environment-name>
  ...
  - job: UpdateChangeRequest
    steps:
    - task: UpdateServiceNowChangeRequest@2
      displayName: 'Update ServiceNow Change Request'
      inputs:
        ServiceNowConnection: '<service-connection-name>'
        NewStatus: '<status-to-set>'
        WorkNotes: '<work-notes-for-change-request>'
        otherParameters: '{"u_<field-name>": "<valid-value>"}'
pool: server

Till exempel:

Köra pipelinen

Spara och kör din pipeline. En ny ändringsbegäran skapas automatiskt och pipelinen pausar och väntar tills kontrollerna har slutförts. När kontrollerna är klara återupptar pipelinen körningen.

Ändringsbegäran stängs automatiskt efter distributionen.

Vanliga frågor och svar

Vilka versioner av ServiceNow stöds?

Azure Pipelines ServiceNow-tillägget stöder versionerna Kingston, London, New York, Paris, Quebec, Rom, San Diego, Tokyo och Utah.

Vilka typer av ändringsbegäran stöds?

Azure Pipelines ServiceNow-integrering stöder normala begäranden, standardbegäranden och begäranden om nödändringar.

Hur gör jag för att ange andra ändringsegenskaper?

Du kan ange fler ändringsegenskaper från fältet Ytterligare parametrar för ändringsbegäran eller i otherParameters. Använd ett JSON-format för nyckel/värde-par, där namnet är fältnamnet, inte etiketten, prefixet med u_.

Kan jag uppdatera anpassade fält i ändringsbegäran med fler parametrar för ändringsbegäran?

Om du definierar anpassade fält i ändringsbegäran måste du lägga till mappning för anpassade fält i importuppsättningens transformeringskarta.

Hur kan jag se listrutevärden ifyllda för kategori, status och andra fält?

Change Management Core och Change Management – Plugin-program för tillståndsmodeller måste vara aktiva på din ServiceNow-instans för att listrutorna ska fungera. Mer information finns i Uppgradera ändringshantering och Uppdatera tillstånd för ändringsbegäran.

Resurser

• Konfigurera versionspipelines för säkra distributioner
• X-attityd som en versionsgrind
• GitHub-problem som en versionsgrind
• Skapa anpassade portar.
• Exempel på ServerTaskHelper-bibliotek

Relaterat innehåll

• Versionsgrindar och godkännanden
• Definiera godkännanden och kontroller
• Konfigurera manuell åtgärd
• Använda portar och godkännanden för att styra distributionen
• Lägga till steg, beroenden och villkor
• Versionsutlösare