Wie man Woodpecker CI auf einem VPS selbst hostet (Komplette Anleitung)

Wie man Woodpecker CI auf einem VPS selbst hostet (Komplette Anleitung)

Woodpecker CI ist ein Open-Source Continuous Integration und Continuous Deployment (CI/CD) System. Das Selbst-Hosting kann Ihren Entwicklungsprozess optimieren und Ihnen die Kontrolle über Ihre Umgebung geben. In dieser Anleitung führen wir Sie durch die Schritte zur Installation und Konfiguration von Woodpecker CI auf einem VPS mithilfe von Docker.

Voraussetzungen

1. VPS: Wählen Sie einen VPS-Anbieter. Hier ist ein Vergleich der beliebten VPS-Optionen für das Hosting von Woodpecker CI:

Wählen Sie einen Anbieter, der Ihren Anforderungen entspricht, unter Berücksichtigung von Leistung und Budget. Für einen detaillierten VPS-Vergleich, sehen Sie sich den vollen VPS-Vergleich an.

2. Betriebssystem: Stellen Sie sicher, dass Sie ein geeignetes Betriebssystem verwenden, idealerweise Ubuntu 20.04 oder höher.

3. Docker: Installieren Sie Docker auf Ihrem VPS.

Schritt 1: Docker einrichten

Um Docker auf Ubuntu zu installieren, führen Sie die folgenden Befehle aus:

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

Nach der Installation überprüfen Sie, ob Docker läuft:

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

Schritt 2: Woodpecker CI installieren

1. Woodpecker CI Docker-Image herunterladen:

   Verwenden Sie den folgenden Befehl, um das Woodpecker CI-Image herunterzuladen:

docker pull woodpeckerci/woodpecker

2. Woodpecker CI-Container erstellen und ausführen:

Jetzt, da Sie das Image haben, erstellen Sie einen Container. Sie müssen verschiedene Umgebungsvariablen basierend auf Ihrer Konfiguration festlegen:

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

Passen Sie WOODPECKER_GITEA_SERVER und WOODPECKER_RPC_SECRET entsprechend Ihrer Gitea-Instanz oder einem anderen Git-Dienst an.

Schritt 3: Woodpecker CI konfigurieren

1. Zugriff auf die Web-Oberfläche: Öffnen Sie Ihren Webbrowser und navigieren Sie zu http://<your-vps-ip>:8000. Sie sollten die Woodpecker CI-Oberfläche sehen.

2. Webhooks registrieren: Wenn Sie Gitea verwenden, stellen Sie sicher, dass Sie Webhooks registrieren, um Ihre Repositories mit Woodpecker CI zu verbinden, um Builds auszulösen.

3. Integration mit anderen Diensten: Je nach den Anforderungen Ihres Projekts integrieren Sie Benachrichtigungen oder Bereitstellungsschritte, indem Sie .woodpecker.yml bearbeiten.

FAQs

1. Was sind die Vorteile des Selbst-Hostings von Woodpecker CI gegenüber der Verwendung einer SaaS-Option?

Das Selbst-Hosting von Woodpecker CI bietet vollständige Kontrolle über Ihre Build-Umgebung, sodass Sie Konfigurationen basierend auf den Anforderungen des Projekts anpassen können. Sie können Einschränkungen vermeiden, die durch Drittanbieterdienste auferlegt werden, wie Build-Zeitkontingente und fehlender Zugang zu Quellcode-Protokollen. Darüber hinaus verbessert das Selbst-Hosting die Privatsphäre, da Ihr Code und Ihre Daten innerhalb Ihrer Infrastruktur bleiben.

2. Kann ich meine Woodpecker CI-Instanz basierend auf dem Verkehrsbedarf skalieren?

Ja, einer der wichtigsten Vorteile der Verwendung von Docker ist die Skalierbarkeit. Wenn Sie Spitzen beim CI/CD-Verbrauch feststellen, können Sie die Anzahl der Woodpecker CI-Instanzen anpassen oder zusätzliche Ressourcen für Ihren VPS bereitstellen. Ziehen Sie in Betracht, Container-Orchestrierungstools wie Kubernetes oder Docker Compose zu verwenden, um mehrere Instanzen zu verwalten und effektiv zu skalieren.

3. Wie funktionieren Backup und Wiederherstellung beim Selbst-Hosting von Woodpecker CI?

Stellen Sie regelmäßige Sicherungen Ihres Woodpecker CI-Datenordners (/var/lib/woodpecker) sicher, um Datenverlust zu vermeiden. Verwenden Sie die Backup-Lösungen Ihres VPS-Anbieters oder skripten Sie eine regelmäßige tar-Archivierung des Woodpecker-Datenverzeichnisses. Im Falle von Datenkorruption oder -verlust stellen Sie einfach die gesicherten Daten im selben Verzeichnis wieder her und starten den Woodpecker CI-Container neu.

Indem Sie diese Schritte befolgen, sollten Sie eine voll funktionsfähige Woodpecker CI-Instanz auf Ihrem VPS haben. Dieses Setup ermöglicht effizientere Entwicklungsprozesse, die auf Ihre einzigartigen Anforderungen zugeschnitten sind.