Självstudie: Skala Jenkins-distributioner med en virtuell dator som körs i Azure
Viktigt
Många Azure-tjänster har Jenkins-plugin-program. Vissa av dessa plugin-program kommer att ha slut på support från och med 29 februari 2024. Azure CLI är det rekommenderade sättet att integrera Jenkins med Azure-tjänster. Mer information finns i artikeln Jenkins-plugin-program för Azure.
Den här självstudien visar hur du skapar en virtuell Linux-dator i Azure och lägger till den virtuella datorn som en arbetsnod i Jenkins.
I de här självstudierna får du:
- Skapa agentdator
- Lägga till agent i Jenkins
- Skapa ett nytt Jenkins-freestylejobb
- Kör jobbet på en Azure VM-agent
Förutsättningar
- Jenkins-installation:Om du inte har åtkomst till en Jenkins-installation konfigurerar du Jenkins med Hjälp av Azure CLI
Konfigurera en virtuell agentdator
Använd az group create för att skapa en Azure-resursgrupp.
az group create --name <resource_group> --location <location>Använd az vm create för att skapa en virtuell dator.
az vm create --resource-group <resource-group> --name <vm_name> --image UbuntuLTS --admin-username azureuser --admin-password "<password>"Viktiga punkter:
- Du kan också ladda upp din ssh-nyckel med följande kommando
--ssh-key-value <ssh_path>.
- Du kan också ladda upp din ssh-nyckel med följande kommando
Installera JDK.
Logga in på den virtuella datorn med ett SSH-verktyg.
ssh username@123.123.123.123Installera JDK med apt. Du kan också installera med andra pakethanteringsverktyg, till exempel yum eller pacman.
sudo apt-get install -y default-jdkNär installationen är klar kör du
java -versionför att verifiera Java-miljön. Utdata innehåller versionsnumren som är associerade med olika delar av JDK.
Konfigurera Jenkins-URL
Om du använder JNLP måste du konfigurera Jenkins-URL:en.
Välj Hantera Jenkins på menyn.
Under Systemkonfigurationväljer du Konfigurera system.
Kontrollera att Jenkins-URL:en är inställd på HTTP-adressen för Jenkins-installationen – .
Välj Spara.
Lägga till agent i Jenkins
Välj Hantera Jenkins på menyn.
Under Systemkonfigurationväljer du Hantera noder och moln.
Välj Ny nod på menyn.
Ange ett värde för Node Name.
Välj Permanent agent.
Välj OK.
Ange värden för följande fält:
Namn:Ange ett unikt namn som identifierar en agent i den nya Jenkins-installationen. Det här värdet kan vara ett annat än agentens värdnamn. Det är dock praktiskt att göra dem till samma två värden. Namnvärdet tillåts alla specialtecken från följande lista:
?*/\%!@#$^&|<>[]:;.Fjärrrotkatalog:En agent måste ha en katalog som är dedikerad till Jenkins. Ange sökvägen till den här katalogen på agenten. Det är bäst att använda en absolut sökväg, till exempel
/home/azureuser/workellerc:\jenkins. Detta bör vara en lokal sökväg till agentdatorn. Den här sökvägen behöver inte vara synlig från huvudsidan. Om du använder en relativ sökväg, till exempel ./jenkins-agent, är sökvägen relativ till arbetskatalogen som tillhandahålls av startmetoden.Etiketter:Etiketter används för att gruppera semantiskt relaterade agenter i en logisk grupp. Du kan till exempel definiera en etikett för
UBUNTUför alla agenter som kör Ubuntu-distributionen av Linux.Startmetod:Det finns två alternativ för att starta jenkins-fjärrnoden: starta agenter via SSH och starta agenten via körning av kommandot på huvudnoden:
Starta agenter via SSH:Ange värdena för följande fält:
Värd:Offentlig IP-adress eller domännamn för virtuell dator. Det kan till exempel vara
123.123.123.123ellerexample.comAutentiseringsuppgifter:Välj en autentiseringsbehörighet som ska användas för att logga in på fjärrvärden. Du kan också välja knappen Lägg till för att definiera en ny autentiseringsidentifiering och sedan välja den nya autentiseringsknappen när den har skapas.
Verifieringsstrategi för värdnyckel:Styr hur Jenkins verifierar den SSH-nyckel som visas av fjärrvärden vid anslutning.

Starta agenten via körning av kommandot på huvudagenten:
Ladda ned
agent.jarfrånhttps://<your_jenkins_host_name>/jnlpJars/agent.jar. Till exempelhttps://localhost:8443/jnlpJars/agent.jar.Upload
agent.jartill den virtuella datornStarta Jenkins med kommandot
ssh <node_host> java -jar <remote_agentjar_path>. Till exempelssh azureuser@99.99.999.9 java -jar /home/azureuser/agent.jar.

Välj Spara.
När du har definierat konfigurationerna lägger Jenkins till den virtuella datorn som en ny arbetsnod.

Skapa ett jobb i Jenkins
Välj Nytt objekt på menyn.
Ange
demoproject1som namn.Välj Freestyle-projekt.
Välj OK.
På fliken Allmänt väljer du Begränsa var projekt kan köras och typen i etikettuttrycket. Du ser ett meddelande som bekräftar att etiketten hanteras av den molnkonfiguration som skapades i föregående steg.

På fliken Source Code Management (Källkodshantering) väljer du Git och lägger till följande URL i fältet Repository URL (URL för lagringsplats):
På fliken Build (Bygg) väljer du Add build step (Lägg till byggsteg) och sedan Invoke top-level Maven targets (Anropa Maven-mål på toppnivå). Ange
packagei fältetpackage.Välj Spara.
Bygg det nya jobbet på en Azure VM-agent
Välj det jobb som du skapade i föregående steg.
Välj Skapa nu. En ny version köas, men startar inte förrän en virtuell agent-dator har skapats i din Azure-prenumeration.
När versionen har slutförts, går du till Konsolutdata. Du ser att versionen skapades via en fjärranslutning på en Azure-agent.
