Woodpecker CI, тізбекте бірде-бір SaaS жоқ

Woodpecker CI-ды Docker Compose арқылы қалай орнату керек

Бір хосттағы сервер мен агент, бұл мысалда GitHub-қа жалғанған. Ұстаханаңыз солардың бірі болса, ұстахана блогын Gitea, Forgejo, GitLab немесе Bitbucket айнымалыларына ауыстырыңыз.

1. 1

   Docker пен Compose орнатыңыз

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

   Екі контейнер де, конвейердің әр қадамы да осы демонда жүреді, сондықтан хостқа керек жалғыз тәуелділік осы.

2. 2

   Ұстаханаңызда OAuth қосымшасын тіркеңіз

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

   Woodpecker пайдаланушыларды ұстахана арқылы кіргізеді және сол рұқсатпен репозиторийлерді оқиды, сондықтан ол қайтаратын клиент идентификаторы мен құпиясы серверге керек нәрсе. Қолдау көрсетілетін әр ұстаханада соған сәйкес форма бар.

3. 3

   Ортақ агент құпиясын жасаңыз

   openssl rand -hex 32

   Сервер мен агенттер бір-бірін осы жолмен аутентификациялайды, ал Woodpecker құжаттамасы оны жасау үшін дәл осы команданы атайды. Оны compose файлынан тыс ұстаңыз - қасындағы .env файлына қойыңыз.

4. 4

   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:

   Бұл - әзірлеушілердің мысалы. WOODPECKER_HOST - пайдаланушылар мен вебхуктер жететін жалпыға ортақ URL, 8000 порты - веб-интерфейс, ал 9000 - агенттер жалғанатын gRPC порты. WOODPECKER_OPEN=true ұстаханада тіркелгісі бар кез келген адамды кіргізеді - командаңыз тіркелген бойда оны өшіріңіз.

5. 5

   Іске қосыңыз

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

   Агент серверге ортақ құпиямен жалғанады және бірінші байланыста өзін өзі тіркейді. Ол аутентификация қатесінде айналып қалса, екі құпия сәйкес келмейді - көбіне .env файлы оқылмағандықтан.

6. 6

   Конвейер қосыңыз

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

   Мұны .woodpecker.yaml ретінде коммит жасап, вебхук жасалуы үшін репозиторийді веб-интерфейсте қосыңыз да, push жасаңыз. Әр қадам - контейнер, сондықтан агентке Docker сокеті керек.

Ресми құжаттамамен салыстырылған күні 2026-08-15 — дереккөзді оқу