Woodpecker CI, रास्ते में कहीं भी कोई SaaS नहीं

Docker Compose के साथ Woodpecker CI कैसे इंस्टॉल करें

इस उदाहरण में एक होस्ट पर सर्वर और एजेंट, 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 के रूप में कमिट करें, वेबहुक बनाने के लिए वेब इंटरफ़ेस में रिपॉज़िटरी सक्षम करें, और पुश करें। हर चरण एक कंटेनर है, इसीलिए एजेंट को Docker सॉकेट चाहिए।

आधिकारिक दस्तावेज़ीकरण के विरुद्ध जाँचा गया 2026-08-15 — स्रोत पढ़ें