Woodpecker CI, bez żadnego SaaS po drodze

Jak zainstalować Woodpecker CI z Docker Compose

Serwer i agent na jednym hoście, w tym przykładzie podłączeni do GitHuba. Podmień blok kuźni na zmienne Gitea, Forgejo, GitLaba albo Bitbucketa, jeśli Twoja kuźnia jest jedną z nich.

1. 1

   Zainstaluj Dockera i Compose

   sudo apt install docker.io docker-compose-v2
   sudo systemctl enable --now docker

   Oba kontenery i każdy krok potoku działają na tym demonie, więc to jedyna zależność, jakiej host potrzebuje.

2. 2

   Zarejestruj aplikację OAuth w swojej kuźni

   # GitHub: Settings -> Developer settings -> OAuth Apps -> New OAuth App
   # Homepage URL:     https://ci.example.com
   # Authorization callback: https://ci.example.com/authorize

   Woodpecker loguje użytkowników przez kuźnię i z tym uprawnieniem czyta repozytoria, więc identyfikator klienta i sekret, które zwraca, są tym, czego potrzebuje serwer. Każda wspierana kuźnia ma odpowiedni formularz.

3. 3

   Wygeneruj wspólny sekret agenta

   openssl rand -hex 32

   Serwer i agenci uwierzytelniają się wzajemnie tym ciągiem, a dokumentacja Woodpeckera wskazuje dokładnie to polecenie do jego wytworzenia. Trzymaj go poza plikiem compose - umieść go w pliku .env obok.

4. 4

   Napisz plik compose

   services:
     woodpecker-server:
       image: woodpeckerci/woodpecker-server:v3
       ports:
         - 8000:8000
       volumes:
         - woodpecker-server-data:/var/lib/woodpecker/
       environment:
         - WOODPECKER_OPEN=true
         - WOODPECKER_HOST=${WOODPECKER_HOST}
         - WOODPECKER_GITHUB=true
         - WOODPECKER_GITHUB_CLIENT=${WOODPECKER_GITHUB_CLIENT}
         - WOODPECKER_GITHUB_SECRET=${WOODPECKER_GITHUB_SECRET}
         - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}
     woodpecker-agent:
       image: woodpeckerci/woodpecker-agent:v3
       command: agent
       restart: always
       depends_on:
         - woodpecker-server
       volumes:
         - woodpecker-agent-config:/etc/woodpecker
         - /var/run/docker.sock:/var/run/docker.sock
       environment:
         - WOODPECKER_SERVER=woodpecker-server:9000
         - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}
   volumes:
     woodpecker-server-data:
     woodpecker-agent-config:

   To przykład od twórców. WOODPECKER_HOST to publiczny adres, pod który trafiają użytkownicy i webhooki, port 8000 to interfejs webowy, a 9000 to port gRPC, na którym łączą się agenci. WOODPECKER_OPEN=true wpuszcza każdego, kto ma konto w kuźni - wyłącz to, gdy Twój zespół będzie już zarejestrowany.

5. 5

   Uruchom

   docker compose up -d
   docker compose logs -f woodpecker-agent

   Agent łączy się z serwerem wspólnym sekretem i sam się rejestruje przy pierwszym kontakcie. Jeśli zapętla się na błędzie uwierzytelniania, oba sekrety się nie zgadzają - najczęściej dlatego, że plik .env nie został wczytany.

6. 6

   Dodaj potok

   when:
     - event: push
   
   steps:
     - name: smoke
       image: alpine:latest
       commands:
         - cat /etc/os-release
         - echo "built on $CI_MACHINE"

   Zatwierdź to jako .woodpecker.yaml, włącz repozytorium w interfejsie webowym, żeby powstał webhook, i wypchnij zmiany. Każdy krok jest kontenerem, i właśnie dlatego agent potrzebuje gniazda Dockera.

Sprawdzone z oficjalną dokumentacją dnia 2026-08-15 — przeczytaj źródło