Hoe Woodpecker CI Zelf-hosten op een VPS (Complete Gids)

Hoe Woodpecker CI Zelf-hosten op een VPS (Complete Gids)

Woodpecker CI is een open-source Continuous Integration en Continuous Deployment (CI/CD) systeem. Het zelf hosten kan je ontwikkelproces stroomlijnen terwijl je controle houdt over je omgeving. In deze gids loodsen we je door de stappen om Woodpecker CI te installeren en te configureren op een VPS met Docker.

Vereisten

1. VPS: Kies een VPS-aanbieder. Hier is een vergelijking van populaire VPS-opties voor het hosten van je Woodpecker CI:

Kies een provider die past bij jouw vereisten, rekening houdend met prestaties en budget. Voor een uitgebreide VPS-vergelijking, bekijk de volle VPS vergelijking.

2. Besturingssysteem: Zorg dat je een geschikt besturingssysteem gebruikt, bij voorkeur Ubuntu 20.04 of later.

3. Docker: Installeer Docker op je VPS.

Stap 1: Docker Instellen

Om Docker te installeren op Ubuntu, voer je de volgende commando’s uit:

sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install docker-ce

Na de installatie controleer je of Docker draait:

sudo systemctl start docker
sudo systemctl enable docker
sudo systemctl status docker

Stap 2: Woodpecker CI Installeren

1. Pulled het Woodpecker CI Docker-image:

Gebruik het volgende commando om het Woodpecker CI-image te downloaden:

docker pull woodpeckerci/woodpecker

2. Maak en Start de Woodpecker CI Container:

Nu je het image hebt, creëer je een container. Je moet verschillende omgevingsvariabelen instellen op basis van je configuratie:

docker run -d \
  --name woodpecker \
  --volume /var/lib/woodpecker:/data \
  -e WOODPECKER_GITEA_SERVER=https://your-gitea-instance.com \
  -e WOODPECKER_RPC_SECRET=your-rpc-secret \
  -e WOODPECKER_SERVER=true \
  -p 8000:8000 \
  woodpeckerci/woodpecker

Pas WOODPECKER_GITEA_SERVER en WOODPECKER_RPC_SECRET aan op basis van jouw Gitea-instantie of een andere Git-service die je gebruikt.

Stap 3: Woodpecker CI Configureren

1. Toegang tot de Web UI: Open je webbrowser en navigeer naar http://<jouw-vps-ip>:8000. Je zou de Woodpecker CI-interface moeten zien.

2. Webhooks Registreren: Als je Gitea gebruikt, zorg dan dat je webhooks registreert om je repositories te koppelen aan Woodpecker CI voor het triggeren van builds.

3. Integratie met Andere Diensten: Afhankelijk van je projectbehoeften, integreer notificaties of deploystappen door .woodpecker.yml aan te passen.

Veelgestelde Vragen (FAQ)

1. Wat zijn de voordelen van zelf-hosting van Woodpecker CI ten opzichte van een SaaS-optie?

Zelf-hosting biedt volledige controle over je build-omgeving, waardoor je configuraties kunt aanpassen op basis van projectvereisten. Je kunt beperkingen vermijden die door derde partijen worden opgelegd, zoals quota voor build-tijden en gebrek aan toegang tot broncode-logs. Daarnaast verbetert zelf-hosting de privacy, omdat je code en data binnen je eigen infrastructuur blijven.

2. Kan ik mijn Woodpecker CI-instantie schalen op basis van verkeersvraag?

Ja, een van de grote voordelen van Docker is schaalbaarheid. Als je pieken ziet in CI/CD-gebruik, kun je het aantal Woodpecker CI-instanties aanpassen of extra resources toewijzen aan je VPS. Overweeg het gebruik van container-orchestratietools zoals Kubernetes of Docker Compose om meerdere instanties te beheren en effectief te schalen.

3. Hoe werken back-ups en herstel bij zelf-hosting van Woodpecker CI?

Zorg voor regelmatige back-ups van je Woodpecker CI-gegevensmap (/var/lib/woodpecker) om gegevensverlies te voorkomen. Gebruik de back-up-oplossingen van je VPS-aanbieder of script regelmatige tar-archivering van de Woodpecker-gegevensmap. Bij datacorruptie of verlies, herstel je eenvoudigweg de back-upgegevens naar dezelfde map en herstart je de Woodpecker CI-container.

Door deze stappen te volgen, heb je een volledig functionerende Woodpecker CI-instantie draaien op je VPS. Deze setup stelt je in staat om efficiënter te ontwikkelen, afgestemd op jouw unieke behoeften. --- Eind ---