Cronjobs vervangen door Jenkins voor Nextcloud-backups 🚀

Illustratie: een butler in smoking die thee serveert voor servermonitoren

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

Vandaag heb ik wat tijd besteed aan het verkennen van Jenkins in mijn homelab.

Voor wie het op de een of andere manier gelukt is Jenkins het afgelopen decennium te ontlopen: Jenkins is een van de meest gebruikte open-source automatiseringsservers van dit moment. Oorspronkelijk in 2011 uitgebracht als fork van het Hudson-project, is Jenkins een van de hoekstenen van moderne DevOps-workflows geworden. Het wordt vooral gebruikt voor Continuous Integration (CI) en Continuous Delivery (CD): het automatiseren van softwarebuilds, tests, deployments en allerlei terugkerende beheertaken. Als een proces geautomatiseerd kan worden, kan Jenkins het waarschijnlijk aan. 😎

Tot nu toe gebruikte ik twee klassieke cronjobs in mijn homelab. Hun doel is vrij simpel: elke nacht maken ze met rsync backups van twee Nextcloud-instanties die aan het internet hangen.

De opzet werkt al geruime tijd prima. Maar als het om monitoring en logging gaat, is cron nog steeds bij uitstek het gereedschap van commandoregelliefhebbers en Unix-veteranen. Meestal ben je logbestanden aan het doorspitten, controleer je met de hand of jobs succesvol zijn uitgevoerd en vraag je je af en toe af of een mislukte backup drie dagen of drie weken geleden gebeurde.

Natuurlijk is cron ongelooflijk betrouwbaar en lichtgewicht. Maar laten we eerlijk zijn: het biedt niet bepaald de modernste gebruikerservaring.

Omdat Jenkins in mijn professionele omgeving in de toekomst waarschijnlijk een grotere rol gaat spelen, besloot ik het eindelijk ook in mijn homelab uit te rollen en er praktijkervaring mee op te doen.

Een vermeldenswaardig detail is dat Jenkins draait op dezelfde machine waarop GitLab al staat. Omdat GitLab al op TCP-poort 8080 luistert, moest Jenkins worden ingesteld op TCP-poort 8090.

Huidige Jenkins-configuratie

Op dit moment is de Jenkins-configuratie bewust eenvoudig.

Ik heb twee jobs van het type Freestyle Project aangemaakt. Net als in mijn vorige cron-opzet heeft elke job een eigen schema dat bepaalt wanneer hij draait. De backup zelf is niets meer dan het uitvoeren van een lokaal shellscript.

Tot nu toe werkt alles vlekkeloos. Jenkins biedt een handige webinterface waarin ik meteen zie of jobs succesvol zijn gedraaid, wanneer ze zijn uitgevoerd, hoe lang ze duurden en welke output ze opleverden.

Vergeleken met het handmatig doorlezen van cron-logs voelt dit al als een flinke verbetering van de kwaliteit van leven. 😊

Er was nog één aanpassing nodig. Jenkins draait onder zijn eigen serviceaccount jenkins, terwijl mijn backupscripts verwachten als gebruiker user3 te worden uitgevoerd. In plaats van rechten en eigenaarschap opnieuw te ontwerpen, heb ik de build-stap simpelweg zo ingesteld dat hij de scripts start via sudo -u user3. Zo blijft Jenkins verantwoordelijk voor het inplannen en bewaken van de jobs, terwijl de eigenlijke backuplogica draait onder het account dat al toegang heeft tot de benodigde bestanden en mappen. 😎

Jobconfiguraties exporteren als XML

Een bijzonder handige functie die ik ontdekte, is dat Jenkins elke jobconfiguratie als XML kan exporteren.

Om een jobconfiguratie op te halen, plak je simpelweg /config.xml achter de job-URL en authenticeer je met een geldig Jenkins-gebruikersaccount:

curl -u <user>:<password> \
http://192.168.10.x:8090/job/Backup-InstanceB/config.xml

Opvallend genoeg werkte het direct openen van de XML-configuratie in een browser bij mij niet. Met curl op de commandoregel werkte het daarentegen perfect.

De resulterende XML bevat de volledige jobdefinitie, wat hem niet alleen nuttig maakt voor documentatie, maar ook als lichtgewicht backup van de Jenkins-configuratie.

Configuratie van Backup-InstanceA

user3@hp1:~$ curl -u <user>:<password> http://192.168.10.x:8090/job/Backup-InstanceA/config.xml
<?xml version='1.1' encoding='UTF-8'?>
<project>
  <actions/>
  <description>rsync</description>
  <keepDependencies>false</keepDependencies>
  <properties/>
  <scm class="hudson.scm.NullSCM"/>
  <canRoam>true</canRoam>
  <disabled>false</disabled>
  <blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
  <blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
  <triggers>
    <hudson.triggers.TimerTrigger>
      <spec>H 1 * * *</spec>
    </hudson.triggers.TimerTrigger>
  </triggers>
  <concurrentBuild>false</concurrentBuild>
  <builders>
    <hudson.tasks.Shell>
      <command>sudo -u user3 /raid5/shared/shared/ablage/nextcloud_backup_and_restore/instance-a_backup_nextcloud_remote.sh</command>
      <configuredLocalRules/>
    </hudson.tasks.Shell>
  </builders>
  <publishers/>
  <buildWrappers/>
</project>

Configuratie van Backup-InstanceB

user3@hp1:~$ curl -u <user>:<password> http://192.168.10.x:8090/job/Backup-InstanceB/config.xml
<?xml version='1.1' encoding='UTF-8'?>
<project>
  <description>rsync</description>
  <keepDependencies>false</keepDependencies>
  <properties/>
  <scm class="hudson.scm.NullSCM"/>
  <canRoam>true</canRoam>
  <disabled>false</disabled>
  <blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
  <blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
  <triggers>
    <hudson.triggers.TimerTrigger>
      <spec>H 2 * * *</spec>
    </hudson.triggers.TimerTrigger>
  </triggers>
  <concurrentBuild>false</concurrentBuild>
  <builders>
    <hudson.tasks.Shell>
      <command>sudo -u user3 /raid5/shared/shared/ablage/nextcloud_backup_and_restore/sofie_backup_nextcloud_remote.sh</command>
      <configuredLocalRules/>
    </hudson.tasks.Shell>
  </builders>
  <publishers/>
  <buildWrappers/>
</project>

Conclusie

Puur technisch bekeken is het vervangen van twee perfect werkende cronjobs door Jenkins waarschijnlijk een schoolvoorbeeld van overengineering. 😄

Aan de andere kant biedt Jenkins gecentraliseerde logging, een uitvoeringsgeschiedenis, statusinformatie en een gebruiksvriendelijke webinterface die het bewaken van geplande taken een stuk comfortabeler maakt.

Voorlopig is Jenkins alleen verantwoordelijk voor het starten van twee backupscripts. Maar elk homelab-experiment begint klein, en de ervaring leert dat Jenkins, als het er eenmaal is, zelden beperkt blijft tot twee jobs.

Eens kijken waar deze reis naartoe gaat. 🚀

Jenkins-dashboard met de Nextcloud-backupjobs

Jenkins-jobconfiguratie voor een Nextcloud-backup

Jenkins-console-output van een geslaagde Nextcloud-backuprun

Jenkins-buildgeschiedenis van de geplande backupjobs

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details