Självstudie: Använda Azure Container Instances som jenkins-byggaragent

Azure Container Instances (ACI) tillhandahåller en miljö på begäran, burstable och isolerad för att köra arbetsbelastningar i containrar. På grund av dessa attribut är ACI en bra plattform för att köra Jenkins-byggjobb i stor skala. Den här artikeln visar hur du distribuerar en ACI och lägger till den som en permanent byggaragent för en Jenkins-kontrollant.

Mer information om Azure Container Instances finns i Om Azure Container Instances.

Förutsättningar

• Azure-prenumeration:Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.
• Jenkins-server:Om du inte har en Jenkins-server installerad skapar du en Jenkins-server på Azure.

Förbereda Jenkins-kontrollanten

1. Bläddra till Jenkins-portalen.

2. I menyn väljer du Hantera Jenkins.

3. Under Systemkonfigurationväljer du Konfigurera system.

4. Kontrollera att Jenkins-URL:en är inställd på HTTP-adressen för Jenkins-installationen – .

5. I menyn väljer du Hantera Jenkins.

6. Under Säkerhetväljer du Konfigurera global säkerhet.

7. Under Agenteranger du Fast port och anger lämpligt portnummer för din miljö.

   Konfigurationsexempel:

8. Välj Spara.

Skapa Jenkins-arbetsagent

1. Bläddra till Jenkins-portalen.

2. I menyn väljer du Hantera Jenkins.

3. Under Systemkonfigurationväljer du Hantera noder och moln.

4. Välj Ny nod på menyn.

5. Ange ett värde för Nodnamn.

6. Välj Permanent agent.

7. Välj OK.

8. Ange ett värde för Fjärrrotkatalog. Till exempel /home/jenkins/work

9. Lägg till en Etikett med värdet .

10. Ange Launch method (Starta metod) till Launch agent by connecting to the master (Starta agenten genom att ansluta till huvudagenten).

11. Kontrollera att alla obligatoriska fält har angetts eller angetts:

    

12. Välj Spara.

13. På agentstatussidan bör du se JENKINS_SECRET och AGENT_NAME . Följande skärmbild visar hur du identifierar värdena. Båda värdena behövs när du skapar Azure Container Instance.

    

Skapa Azure Container Instance med CLI

1. Använd az group create för att skapa en Azure-resursgrupp.

   az group create --name my-resourcegroup --location westus
   

2. Använd az container create för att skapa och Azure Container Instance. Ersätt platshållarna med de värden som erhölls när du skapade arbetsagenten.

   az container create \
     --name my-dock \
     --resource-group my-resourcegroup \
     --ip-address Public --image jenkins/inbound-agent:latest \
     --os-type linux \
     --ports 80 \
     --command-line "jenkins-agent -url http://jenkinsserver:port <JENKINS_SECRET> <AGENT_NAME>"
   

   Ersätt http://jenkinsserver:port , och med <JENKINS_SECRET><AGENT_NAME> jenkins-kontrollanten och agentinformationen. När containern startar ansluts den till Jenkins-styrenhetsservern automatiskt.

3. Gå tillbaka till Jenkins-instrumentpanelen och kontrollera agentstatusen.

   

   Anteckning

   Jenkins-agenter ansluter till kontrollanten via port 5000 och ser till att porten tillåts inkommande till Jenkins-styrenheten.

Skapa ett byggjobb

Nu skapas ett Jenkins-byggjobb för att demonstrera Jenkins-byggen på en Azure-containerinstans.

1. Välj Nytt objekt,ge byggprojektet ett namn, till exempel aci-demo,välj Freestyle-projektoch välj OK.

   

2. Under Allmäntser du till att Begränsa var det här projektet kan köras har valts. Ange linux som etikettuttryck. Den här konfigurationen säkerställer att det här byggjobbet körs i ACI-molnet.

   

3. Under Build(Bygg) väljer du Add build step (Lägg till byggsteg) och väljer Execute Shell ( Kör gränssnitt). Ange echo "aci-demo" som kommando.

   

4. Välj Spara.

Köra byggjobbet

Om du vill testa byggjobbet och observera Azure Container Instances starta ett bygge manuellt.

1. Välj Skapa nu för att starta ett byggjobb. När jobbet startar visas en status som liknar följande bild:

   

2. Klicka på version nr 1 i Build History (Bygghistorik).

   

3. Välj Konsolutdata för att visa build-utdata.

   

Nästa steg