Aan de slag: Jenkins installeren op een Azure Linux-VM

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

In dit artikel leert u het volgende:

  • Een installatiebestand maken dat Jenkins downloadt en installeert
  • Een resourcegroep maken
  • Een virtuele machine maken met het installatiebestand
  • Open poort 8080 om toegang te krijgen tot Jenkins op de virtuele machine
  • Verbinding maken via SSH naar de virtuele machine
  • Een Jenkins-voorbeeld job configureren op basis van een Java-voorbeeld-app in GitHub
  • De Jenkins-voorbeeld job bouwen

1. Uw omgeving configureren

  • Azure-abonnement: Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.

2. Open Cloud Shell

  1. Als u al een Cloud Shell geopend, kunt u naar de volgende sectie gaan.

  2. Browse 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 in het bovenste menu in het Azure Portal.

  5. Als u deze nog niet eerder hebt Cloud Shell, 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. Schakel over naar de testmap.

  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-8-jdk -y
      - wget -qO - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
      - sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
      - 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 virtuele voorbeeldmachine 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 u in de vorige stap hebt opgehaald, SSH in de virtuele machine. U moet de verbindingsaanvraag bevestigen.

    ssh azureuser@<ip_address>
    

    Belangrijkste punten:

    • Als de verbinding tot stand is Cloud Shell 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 geven.

    service jenkins status
    

    Belangrijkste punten:

    • Als er een foutbericht wordt weergegeven dat de service niet bestaande is, moet u mogelijk een paar minuten wachten totdat alles is geïnstalleerd en initialiseren.
  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 In plug-in selecteren om te installeren.

    Selecteer de optie voor het installeren van geselecteerde in plug-ins

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

    De GitHub installeren

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

    Gegevens invoeren voor de eerste gebruiker met beheerdersrechten

  10. Selecteer op de pagina Exemplaarconfiguratie de optie Opslaan en voltooien.

    Bevestigingspagina voor exemplaarconfiguratie

  11. Selecteer Beginnen met Jenkins.

    Jenkins is klaar.

5. Uw eerste taak maken

  1. Selecteer op de startpagina van Jenkins de optie Een taak maken.

    Startpagina jenkins-console

  2. Voer de taaknaam mySampleApp in, selecteer mySampleAppen selecteer OK.

    Nieuwe taak maken

  3. Selecteer het tabblad Broncodebeheer. Schakel Git in en voer de volgende URL in voor de waarde opslagplaats-URL: . Wijzig vervolgens de Vertakkings specificer in .

    De Git-opslagplaats definiëren

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

    Een nieuwe build-stap toevoegen

  5. Selecteer Gradle-scriptaanroepen in de vervolgkeuzelijst.

    Selecteer de optie Gradle-script

  6. Selecteer Use Gradle Wrapper en voer vervolgens in bij Wrapper location en bij Tasks.

    Gradle-scriptopties

  7. Selecteer Geavanceerd en voer in het veld Script voor root-build in.

    Geavanceerde Gradle-scriptopties

  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 compileren om de code te compileren en de voorbeeld-app te verpakken.

    Project startpagina

  2. Een afbeelding onder de kop Build History geeft aan dat de taak wordt gemaakt.

    Job-build wordt uitgevoerd

  3. Wanneer de build is voltooid, selecteert u de koppeling Werkruimte.

    Selecteer de koppeling naar de werkruimte.

  4. complete/build/libsNavigeer naar om te zien of het bestand is .jar gemaakt.

    De doelbibliotheek controleert of de build is geslaagd.

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

Problemen oplossen

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

Volgende stappen