Självstudie: Distribuera till en virtuell Linux-dator med Jenkins och Azure DevOps Services

  • Artikel

Kontinuerlig integration (CI) och kontinuerlig distribution (CD) utgör en pipeline som du kan använda för att bygga, släppa och distribuera din kod. Azure DevOps Services innehåller en fullständig, komplett uppsättning CI/CD-automatiseringsverktyg för distribution till Azure. Jenkins är ett populärt CI/CD-serverbaserat verktyg från tredje part som också har funktioner för CI/CD-automatisering. Du kan använda Azure DevOps Services och Jenkins tillsammans för att anpassa hur du levererar din app eller tjänst i molnet.

I dessa självstudier använder du Jenkins för att skapa en Node.js-webbapp. Du sedan använda Azure DevOps för att distribuera den

till en distributionsgrupp som innehåller virtuella Linux-datorer (VM). Du lär dig att:

  • Hämta exempelappen.
  • Konfigurera plugin-programmet för Jenkins.
  • Konfigurera ett Jenkins Freestyle-projekt för Node.js.
  • Konfigurera Jenkins för integrering med Azure DevOps Services.
  • Skapa en tjänstslutpunkt för Jenkins.
  • Skapa en distributionsgrupp för de virtuella Azure-datorerna.
  • Skapa en Azure Pipelines-versionspipeline.
  • Kör manuella och CI-utlösta distributioner.

Förutsättningar

Hämta exempelappen

Du behöver en app som ska distribueras och lagras på en Git-lagringsplats. Vi rekommenderar att du för dessa självstudier använder denna exempelapp, som finns tillgänglig från GitHub. Dessa självstudier innehåller ett exempelskript som används för att installera Node.js och ett program. Om du vill arbeta med en egen lagringsplats bör du konfigurera ett liknande exempel.

Skapa en förgrening av den här appen och anteckna platsen (URL) för användning i senare steg i den här kursen. Läs mer i informationen om hur du skapar en förgrening av en lagringsplats.

Kommentar

Appen har skapats med Yeoman. Den använder Express, Bower och Grunt. Den har även vissa npm-paket som beroenden. Exempelappen innehåller också ett skript som konfigurerar Nginx och distribuerar appen. Det körs på de virtuella datorerna. Vad skriptet gör:

  1. Installerar Node, Nginx och PM2.
  2. Konfigurerar Nginx och PM2.
  3. Startar Node-appen.

Konfigurera plugin-programmet för Jenkins

Först måste du konfigurera två Jenkins plugin-program: NodeJS och VS Team Services Continuous Deployment.

  1. Öppna ditt Jenkins-konto och välj Hantera Jenkins.
  2. På sidan Hantera Jenkins väljer du Hantera plugin-program.
  3. Filtrera listan för att hitta NodeJS- plugin-programmet och välj Installera utan att starta om. Adding the NodeJS plug-in to Jenkins
  4. Filtrera listan för att hitta plugin-programmet VS Team Services Continuous Deployment och välj Installera utan att starta om.
  5. Gå tillbaka till instrumentpanelen i Jenkins och välj Hantera Jenkins.
  6. Välj Global Tool Configuration (Global verktygskonfiguration). Hitta NodeJS och välj NodeJS-installationer.
  7. Välj Installera automatiskt och ange ett värde för Namn.
  8. Välj Spara.

Konfigurera ett Jenkins Freestyle-projekt för Node.js

  1. Välj Nytt objekt. Ange ett objektnamn.
  2. Välj Freestyle-projekt. Välj OK.
  3. På fliken Source Code Management (Källkodshantering) väljer du Git och anger information om lagringsplatsen och grenen som innehåller din appkod.
    Add a repo to your build
  4. På fliken för att skapa utlösare väljer du Poll SCM (Avsök SCM) och anger schemat H/03 * * * * för att avsöka Git-lagringsplatsen för ändringar var tredje minut.
  5. På fliken Skapa miljö väljer du Ange nod och npm-bin/mappSÖKVÄG och väljer värdet NodeJS-installation . Låt npmrc-filen vara inställd för att använda systemstandarden.
  6. På fliken Build (Version) väljer du Execute shell (Kör gränssnitt) och anger kommandot npm install så att alla beroenden är uppdaterade.

Konfigurera Jenkins för integrering med Azure DevOps Services

Kommentar

Kontrollera att den personliga åtkomsttoken (PAT) som du använder för följande steg har behörigheten Release (läsa, skriva, köra och hantera) i Azure DevOps Services.

  1. Skapa en PAT i din Azure DevOps Services-organisation om du inte redan har en. Jenkins behöver den här informationen för att få åtkomst till din Azure DevOps Services-organisation. Se till att spara tokeninformation för kommande steg i det här avsnittet.

    Om du vill lära dig mer om att generera en token läser du avsnittet om hur du skapar en personlig åtkomsttoken för Azure DevOps Services.

  2. På fliken Post-build Actions (Åtgärder efter skapandet) väljer du Add post-build action (Lägg till åtgärd efter skapandet). Välj Archive the artifacts (Arkivera artefakter).

  3. För Files to archive (Filer att arkivera) anger du **/* för att inkludera alla filer.

  4. Om du vill skapa en åtgärd till väljer du Add post-build action (Lägg till åtgärd efter skapandet).

  5. Välj Trigger release in TFS/Team Services (Utlös version i TFS/Team Services). Ange URI för din Azure DevOps Services-organisation, till exempel https://{your-organization-name}.visualstudio.com.

  6. Ange produktnamnet.

  7. Ge versionspipelinen ett namn. (Du skapar den här versionspipelinen senare i Azure DevOps Services.)

  8. Välj autentiseringsuppgifter för att ansluta till din Azure DevOps Services- eller Azure DevOps Server-miljö:

    • Låt Username (Användarnamn) vara tomt om du använder Azure DevOps Services.
    • Ange ett användarnamn och lösenord om du använder en lokal version av Azure DevOps Server.
      Configuring Jenkins post-build actions

  9. Spara Jenkins-projektet.

Skapa en tjänstslutpunkt för Jenkins

En tjänstslutpunkt gör att Azure DevOps Services kan ansluta till Jenkins.

  1. Öppna sidan Services (Tjänster) i Azure DevOps Services, öppna sedan listan New Service Endpoint (Ny tjänstslutpunkt) och välj Jenkins. Add a Jenkins endpoint
  2. Ange ett namn på anslutningen.
  3. Ange URL-adressen till din Jenkins-server och välj alternativet Accept untrusted SSL certificates (Acceptera ej betrodda SSL-certifikat). Ett exempel på en URL är http://{dinjenkinsURL}.westcentralus.cloudapp.azure.com.
  4. Ange användarnamnet och lösenordet för ditt Jenkins-konto.
  5. Välj Verify connection (Verifiera anslutning) för att kontrollera att informationen är korrekt.
  6. Välj OK för att skapa tjänstslutpunkten.

Skapa en distributionsgrupp för virtuella Azure-datorer

Du behöver en distributionsgrupp för att registrera Azure DevOps Services-agenten så versionspipelinen kan distribueras till den virtuella datorn. Distributionsgrupper gör det lättare att definiera logiska grupper med måldatorer för distribution och installera den nödvändiga agenten på varje dator.

Kommentar

I följande procedur måste du installera nödvändiga komponenter. Kör inte skriptet med sudo-privilegier.

  1. Öppna fliken Versioner i skapa och versionshubben , öppna Distributionsgrupper och välj + Ny.
  2. Ange ett namn för distributionsgruppen och valfri beskrivning. Välj sedan Skapa.
  3. Välj operativsystem för din virtuella måldator för distribution. Välj t.ex. Ubuntu 16.04+.
  4. Välj Use a personal access token in the script for authentication (Använd en personlig åtkomsttoken i skriptet för autentisering).
  5. Välj länken för systemkrav. Installera förutsättningarna för ditt operativsystem.
  6. Välj Kopiera skriptet till Urklipp för att kopiera skriptet.
  7. Logga in på din virtuella måldator för distribution och kör skriptet. Kör inte skriptet med sudo-privilegier.
  8. Efter installationen kan du uppmanas att distribuera grupptaggar. Acceptera alla standardinställningar.
  9. Sök efter den nya virtuella datorn i Azure DevOps Services, i Targets (Mål) under Deployment Groups (Distributionsgrupper).

Skapa en Azure Pipelines-versionspipeline

En versionspipeline anger hur Azure Pipelines ska distribuera appen. I det här exemplet kör du ett kommandoskript.

Så här skapar du en versionspipeline i Azure Pipelines:

  1. Öppna fliken Versioner i build & release-hubben och välj Skapa versionspipeline.
  2. Välj den tomma mallen genom att välja att börja med en tom process.
  3. I avsnittet Artefakter väljer du + Lägg till artefakt och Jenkins som källtyp. Välj din tjänstslutpunkt i Jenkins-anslutningen. Sedan väljer du Jenkins-källjobbet och Lägg till.
  4. Välj ellipsen bredvid Environment 1 (Miljö 1). Välj Add deployment group phase (Lägg till distributionsgruppsfas).
  5. Välj distributionsgrupp.
  6. Välj + för att lägga till en uppgift till Add deployment group phase (Lägg till distributionsgruppsfas).
  7. Välj uppgiften för kommandoskriptet och välj sedan Lägg till. Uppgiften för kommandoskriptet ger konfigurationen för ett skript som ska köras på varje server för att kunna installera Node.js och starta appen.
  8. För skriptsökvägen anger du $(System.StandardArbetsKatalog)/Fabrikam-Node/deployscript.sh.
  9. Välj Avancerat och aktivera Ange arbetskatalog.
  10. För arbetskatalog anger du $(System.StandardArbetsKatalog)/Fabrikam-Node.
  11. Redigera namnet på versionspipelinen till det namn du angav på fliken Post-build Actions (Åtgärder efter skapandet) för versionen i Jenkins. Jenkins behöver det här namnet för att kunna utlösa en ny version när artefakter för källor uppdateras.
  12. Välj Spara och OK för att spara versionspipelinen.

Köra manuella och CI-utlösta distributioner

  1. Välj + Release (+ Version) och sedan Create Release (Skapa version).
  2. Välj den version du slutförde i den markerade listrutan och välj Queue (Kö).
  3. Välj versionslänken i popup-meddelandet. Till exempel: "Release Release-1 has been created." (Version Version-1 har skapats).
  4. Öppna fliken med loggar för att se på utmatningen av versionen.
  5. Öppna URL-adressen till en av de servrar som du lagt till i din distributionsgrupp i en webbläsare. Ange till exempel http://{din-server-ip-adress}.
  6. Gå till källagringsplatsen i Git och ändra innehållet i rubriken h1 för filen app/views/index.jade.
  7. Checka in ändringarna.
  8. Efter några minuter ser du att en ny version har skapats på sidan med versioner i Azure DevOps. Öppna versionen om du vill se distributionen. Klar!

Felsökning av Jenkins-plugin-programmet

Om du stöter på buggar med Jenkins-plugin-programmet kan du rapportera problemet i Jenkins JIRA för en viss komponent.

Nästa steg

I dessa självstudier har du automatiserat distributionen av en app till Azure med hjälp av Jenkins för att bygga och Azure DevOps Services för att publicera. Du har lärt dig att:

  • Skapa en app i Jenkins.
  • Konfigurera Jenkins för integrering med Azure DevOps Services.
  • Skapa en distributionsgrupp för de virtuella Azure-datorerna.
  • Skapa en Azure Pipeline som konfigurerar de virtuella datorerna och distribuerar appen.

Mer information om hur du använder Azure Pipelines för både bygg- och versionssteg finns i detta.

Om du vill veta mer om hur du skapar en YAML-baserad CI/CD-pipeline för distribution till virtuella datorer går du vidare till nästa självstudie.

Jenkins på Azure