Comment auto-héberger Woodpecker CI sur un VPS (Guide complet)

Comment auto-héberger Woodpecker CI sur un VPS (Guide complet)

Woodpecker CI est un système d’intégration continue et de déploiement continu (CI/CD) open-source. L’auto-hébergement peut rationaliser votre pipeline de développement tout en vous permettant de contrôler votre environnement. Dans ce guide, nous vous expliquerons les étapes pour installer et configurer Woodpecker CI sur un VPS en utilisant Docker.

Prérequis

1. VPS : Sélectionnez un fournisseur de VPS. Voici une comparaison des options de VPS populaires pour héberger votre Woodpecker CI :

Choisissez un fournisseur qui correspond à vos besoins, en tenant compte des performances et de votre budget. Pour une comparaison de VPS détaillée, consultez la comparaison complète des VPS.

2. Système d’exploitation : Assurez-vous d’utiliser un système d’exploitation approprié, idéalement Ubuntu 20.04 ou ultérieur.

3. Docker : Installez Docker sur votre VPS.

Étape 1 : Configuration de Docker

Pour installer Docker sur Ubuntu, exécutez les commandes suivantes :

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

Après l’installation, vérifiez que Docker fonctionne :

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

Étape 2 : Installer Woodpecker CI

1. Téléchargez l’image Docker de Woodpecker CI :

   Utilisez la commande suivante pour tirer l’image de Woodpecker CI :

docker pull woodpeckerci/woodpecker

2. Créer et exécuter le conteneur Woodpecker CI :

Maintenant que vous avez l’image, créez un conteneur. Vous devrez définir diverses variables d’environnement en fonction de votre configuration :

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

Ajustez WOODPECKER_GITEA_SERVER et WOODPECKER_RPC_SECRET en fonction de votre instance Gitea ou tout autre service Git que vous utilisez.

Étape 3 : Configurer Woodpecker CI

1. Accéder à l’interface Web : Ouvrez votre navigateur et allez à http://<your-vps-ip>:8000. Vous devriez voir l’interface de Woodpecker CI.

2. Enregistrer les Webhooks : Si vous utilisez Gitea, assurez-vous d’enregistrer des webhooks pour connecter vos dépôts à Woodpecker CI afin de déclencher des builds.

3. Intégrer avec d’autres services : En fonction des besoins de votre projet, intégrez des notifications ou des étapes de déploiement en modifiant .woodpecker.yml.

FAQ

1. Quels sont les avantages de l’auto-hébergement de Woodpecker CI par rapport à une option SaaS ?

L’auto-hébergement de Woodpecker CI offre un contrôle complet sur votre environnement de build, vous permettant de personnaliser les configurations en fonction des exigences du projet. Vous pouvez éviter les limitations imposées par des services tiers, telles que les quotas de temps de build et l’absence d’accès aux journaux de code source. De plus, l’auto-hébergement améliore la confidentialité, car votre code et vos données restent au sein de votre infrastructure.

2. Puis-je faire évoluer mon instance Woodpecker CI en fonction des demandes de trafic ?

Oui, l’un des principaux avantages de l’utilisation de Docker est la scalabilité. Si vous constatez des pics d’utilisation de CI/CD, vous pouvez ajuster le nombre d’instances Woodpecker CI ou allouer des ressources supplémentaires à votre VPS. Envisagez d’utiliser des outils d’orchestration de conteneurs comme Kubernetes ou Docker Compose pour gérer plusieurs instances et évoluer efficacement.

3. Comment fonctionne la sauvegarde et la restauration lors de l’auto-hébergement de Woodpecker CI ?

Assurez-vous de sauvegarder régulièrement votre dossier de données Woodpecker CI (/var/lib/woodpecker) pour éviter toute perte de données. Utilisez les solutions de sauvegarde de votre fournisseur VPS ou script un archivage régulier avec tar du répertoire de données de Woodpecker. En cas de corruption ou de perte de données, restaurez simplement les données sauvegardées dans le même répertoire et redémarrez le conteneur Woodpecker CI.

En suivant ces étapes, vous devriez avoir une instance Woodpecker CI entièrement fonctionnelle exécutée sur votre VPS. Cette configuration permet des processus de développement plus efficaces, adaptés à vos besoins spécifiques.