Delen via


Aan de slag: Jenkins installeren op een Virtuele Linux-machine in Azure

In dit artikel wordt beschreven hoe u Jenkins installeert op een Ubuntu Linux-VM met de hulpprogramma's en invoegtoepassingen die zijn geconfigureerd voor gebruik met Azure.

In dit artikel leert u het volgende:

  • Een installatiebestand maken waarmee Jenkins wordt gedownload en geïnstalleerd
  • Een brongroep maken
  • Een virtuele machine maken met het installatiebestand
  • Open poort 8080 om toegang te krijgen tot Jenkins op de virtuele machine
  • Verbinding maken met de virtuele machine via SSH
  • Een Jenkins-voorbeeldtaak configureren op basis van een Java-voorbeeld-app in GitHub
  • De Jenkins-voorbeeldtaak bouwen

1. Uw omgeving configureren

  • Azure-abonnement: als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

2. Open Cloud Shell

  1. Als u al een Cloud Shell-sessie hebt geopend, kunt u doorgaan naar de volgende sectie.

  2. Bladeren naar De Azure-portal

  3. Meld u indien nodig aan bij uw Azure-abonnement en wijzig de Azure-directory.

  4. Open Cloud Shell.

    Open Cloud Shell vanuit het bovenste menu in Azure Portal.

  5. Als u Cloud Shell nog niet eerder hebt gebruikt, configureert u de omgevings- en opslaginstellingen.

  6. Selecteer de opdrachtregelomgeving.

    Selecteer de CLI die u wilt gebruiken in Cloud Shell.

3. Een virtuele machine maken

  1. Maak een testmap met de naam jenkins-get-started.

  2. Navigeer naar de testdirectory.

  3. Maak een bestand met de naam cloud-init-jenkins.txt.

  4. Plak de volgende code in het nieuwe bestand:

    #cloud-config
    package_upgrade: true
    runcmd:
      - sudo apt install openjdk-17-jre -y
      - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
      -  echo 'deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/' | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
      - sudo apt-get update && sudo apt-get install jenkins -y
      - sudo service jenkins restart
    
    
    
  5. Voer az group create uit om een resourcegroep te maken.

    az group create --name jenkins-get-started-rg --location eastus
    
  6. Voer az vm create uit om een virtuele machine te maken.

    az vm create \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm \
    --image UbuntuLTS \
    --admin-username "azureuser" \
    --generate-ssh-keys \
    --public-ip-sku Standard \
    --custom-data cloud-init-jenkins.txt
    
  7. Voer az vm list uit om het maken (en de status) van de nieuwe virtuele machine te controleren.

    az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
    
  8. Terwijl Jenkins wordt uitgevoerd op poort 8080, voert u az vm open uit om poort 8080 te openen op de nieuwe virtuele machine.

    az vm open-port \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm  \
    --port 8080 --priority 1010
    

4. Jenkins configureren

  1. Voer az vm show uit om het openbare IP-adres voor de voorbeeld-VM-machine op te halen.

    az vm show \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm -d \
    --query [publicIps] \
    --output tsv
    

    Belangrijkste punten:

    • De --query parameter beperkt de uitvoer tot de openbare IP-adressen voor de virtuele machine.
  2. Gebruik het IP-adres dat in de vorige stap is opgehaald om via SSH in te loggen op de virtuele machine. U moet de verbindingsaanvraag bevestigen.

    ssh azureuser@<ip_address>
    

    Belangrijkste punten:

    • Na een geslaagde verbinding bevat de Cloud Shell-prompt de gebruikersnaam en de naam van de virtuele machine: azureuser@jenkins-get-started-vm.
  3. Controleer of Jenkins wordt uitgevoerd door de status van de Jenkins-service op te halen.

    service jenkins status
    

    Belangrijkste punten:

    • Als u een foutbericht ontvangt met betrekking tot de service die niet bestaat, moet u mogelijk een paar minuten wachten totdat alles is geïnstalleerd en geïnitialiseerd.
  4. Haal het automatisch gegenereerde Jenkins-wachtwoord op.

    sudo cat /var/lib/jenkins/secrets/initialAdminPassword
    
  5. Open met behulp van het IP-adres de volgende URL in een browser: http://<ip_address>:8080

  6. Voer het wachtwoord in dat u eerder hebt opgehaald en selecteer Doorgaan.

    Eerste pagina voor het ontgrendelen van Jenkins

  7. Selecteer Invoegtoepassing selecteren om te installeren.

    Selecteer de optie om geselecteerde invoegtoepassingen te installeren

  8. Voer in het filtervak boven aan de pagina de tekst in github. Selecteer de GitHub-invoegtoepassing en selecteer Installeren.

    De GitHub-invoegtoepassingen installeren

  9. Voer de gegevens in voor de eerste gebruiker met beheerdersrechten en selecteer Opslaan en Doorgaan.

    Voer informatie in voor de eerste gebruiker met beheerdersrechten

  10. Selecteer Opslaan en voltooien op de pagina Exemplaarconfiguratie.

    Bevestigingspagina voor exemplaarconfiguratie

  11. Selecteer Aan de slag met Jenkins.

    Jenkins is klaar!

5. Uw eerste taak maken

  1. Selecteer een taak maken op de startpagina van Jenkins.

    Startpagina van Jenkins-console

  2. Voer een taaknaam in, mySampleAppselecteer Freestyle-project en selecteer OK.

    Nieuwe taak maken

  3. Selecteer het tabblad Broncodebeheer . Schakel Git in en voer de volgende URL in voor de url-waarde van de opslagplaats: https://github.com/spring-guides/gs-spring-boot.git. Wijzig vervolgens de vertakkingsaanduiding in */main.

    De Git-opslagplaats definiëren

  4. Selecteer het tabblad Build en selecteer vervolgens Build-stap toevoegen

    Een nieuwe buildstap toevoegen

  5. Selecteer Gradle-script aanroepen in de vervolgkeuzelijst.

    Selecteer de optie Gradle-script

  6. Selecteer Gebruik Gradle Wrapper. Voer vervolgens complete in bij Wrapper-locatie en build bij Taken.

    Opties voor Gradle-scripts

  7. Selecteer Geavanceerd en voer complete in het veld Hoofdbuildscript in.

    Geavanceerde opties voor Gradle-scripts

  8. Schuif naar de onderkant van de pagina en selecteer Opslaan.

6. De Java-voorbeeld-app bouwen

  1. Wanneer de startpagina voor uw project wordt weergegeven, selecteert u Nu bouwen om de code te compileren en de voorbeeld-app te verpakken.

    Startpagina van Project

  2. Een afbeelding onder de titel Buildgeschiedenis geeft aan dat de job in uitvoering is.

    Job-build wordt uitgevoerd

  3. Wanneer de build is voltooid, selecteert u de Workspace-link.

    Selecteer de werkruimte-link.

  4. Navigeer naar complete/build/libs om te zien dat het .jar bestand succesvol is gebouwd.

    De doelbibliotheek controleert of de build is voltooid.

  5. Uw Jenkins-server is nu klaar om uw eigen projecten te bouwen in Azure.

Probleemoplossingsproces

Als u problemen ondervindt met het configureren van Jenkins, raadpleegt u de jenkins-installatiepagina voor de meest recente instructies en bekende problemen.

Volgende stappen