GitHub Actions: CI/CD WordPress-projektekhez
A GitHub Actions workflow-jaival automatizálhatod a WordPress-projekt kódellenőrzését, tesztelését, buildelését és kitelepítését.
A GitHub Actions a GitHub beépített automatizálási szolgáltatása. A repóba tett YAML-fájlok (workflow-k) megmondják, mi fusson le egy eseményre, például egy pushra: kódellenőrzés, teszt, build vagy kitelepítés. A szolgáltatás a GitHub saját gépein fut, külön rendszert nem kell üzemeltetned. A GitHub által üzemeltetett futtatók használata nyilvános repókban ingyenes, privát repókban a GitHub-csomagod keretéből fogy; a részleteket a GitHub számlázási oldala írja le.
Alapfogalmak
Szekció neve “Alapfogalmak”- Workflow: egy YAML-fájl a
.github/workflows/mappában. - Esemény (
on): ami elindítja, példáulpush,pull_request,schedule(időzítés),workflow_dispatch(kézi indítás) vagyrelease. - Job: lépések egy csoportja, amely egy gépen fut. A jobok alapból párhuzamosak.
- Step: egy parancs (
run) vagy egy kész action (uses). - Runner: a gép, amelyen a job fut, például
ubuntu-latest.
Egy minimális workflow:
name: Próbaon: [push]jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - run: echo "Hello"Az action-ök verziója idővel változik: a példákban a kiadáskor érvényes főverzió áll, a legfrissebbet mindig az action GitHub-oldalán nézd meg.
Kódellenőrzés: PHPCS
Szekció neve “Kódellenőrzés: PHPCS”A WordPress-kódolási szabványok ellenőrzése minden pushnál és pull requestnél:
name: PHPCSon: [push, pull_request]jobs: phpcs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - uses: shivammathur/setup-php@v2 with: php-version: '8.3' tools: composer - run: composer install --prefer-dist --no-progress - run: vendor/bin/phpcsA shivammathur/setup-php a PHP-t, a kiterjesztéseket, a Composert és más eszközöket állít be. A phpcs a projekt phpcs.xml fájlját használja.
Tesztek: PHPUnit
Szekció neve “Tesztek: PHPUnit”A WordPress-tesztkörnyezethez adatbázis kell. A munkafolyamat egy MySQL-szolgáltatást indít, a PHPUnit pedig ahhoz csatlakozik:
name: PHPUniton: [push, pull_request]jobs: test: runs-on: ubuntu-latest services: mysql: image: mysql:8.0 env: MYSQL_ROOT_PASSWORD: root MYSQL_DATABASE: wordpress_test ports: - 3306:3306 options: >- --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3 steps: - uses: actions/checkout@v7 - uses: shivammathur/setup-php@v2 with: php-version: '8.3' extensions: mysqli - run: composer install --prefer-dist --no-progress - run: bash bin/install-wp-tests.sh wordpress_test root root 127.0.0.1 latest - run: vendor/bin/phpunitA bin/install-wp-tests.sh a WP-CLI wp scaffold plugin-tests parancsával készül. Több PHP-verziót egy strategy.matrix kulccsal futtathatsz egymás mellett, és a ${{ matrix.php }} értéket adod a php-version mezőnek.
Frontend build
Szekció neve “Frontend build”name: Buildon: push: branches: [main]jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - uses: actions/setup-node@v7 with: node-version: '24' cache: npm - run: npm ci - run: npm run build - uses: actions/upload-artifact@v7 with: name: build path: dist/A cache: npm a függőségeket gyorsítótárazza. A Composerhez az actions/cache action való, a composer.lock hash-ével mint kulccsal.
Kitelepítés
Szekció neve “Kitelepítés”A kitelepítéshez a szerver elérési adatait secretként add meg: a repó Settings → Secrets and variables → Actions oldalán a New repository secret gombbal. A workflow-ban ${{ secrets.NEV }} néven éred el. A secretet soha ne írd a YAML-be.
SSH-n át kitelepítés:
name: Deployon: push: branches: [main]jobs: deploy: runs-on: ubuntu-latest steps: - uses: appleboy/ssh-action@v1 with: host: ${{ secrets.SSH_HOST }} username: ${{ secrets.SSH_USERNAME }} key: ${{ secrets.SSH_PRIVATE_KEY }} script: | cd /var/www/oldal git pull origin main composer install --no-devFTP-s tárhelyre a SamKirkland/FTP-Deploy-Action való, a server, username és password secretekkel. A kapcsolat alapból titkosított FTPS (protocol mező).
Bővítmény kiadása a WordPress.org-ra
Szekció neve “Bővítmény kiadása a WordPress.org-ra”A 10up action egy új tag vagy release alapján feltölti a bővítményt a WordPress.org SVN-tárába:
name: Deploy to WordPress.orgon: push: tags: - "*"jobs: tag: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - run: | npm ci npm run build - uses: 10up/action-wordpress-plugin-deploy@stable env: SVN_USERNAME: ${{ secrets.SVN_USERNAME }} SVN_PASSWORD: ${{ secrets.SVN_PASSWORD }} SLUG: a-te-bovitmenyedA SLUG elhagyható, ha a repó neve megegyezik a WordPress.org-os névvel.
Futás szűkítése
Szekció neve “Futás szűkítése”on: push: branches: [main] paths: - 'src/**' - 'package.json'Egy job csak feltétellel fusson, például if: github.ref == 'refs/heads/main'.
Biztonság
Szekció neve “Biztonság”- Harmadik féltől származó action-t csak ellenőrzött forrásból használj. A GitHub ajánlása szerint rögzítsd egy teljes hosszúságú commit SHA-hoz, mert a címke később átállítható.
- A secretek értékét ne írd ki a naplóba.
- A kitelepítő kulcs csak azt a szervert érje el, amelyiknek kell.
Hasznos linkek
Szekció neve “Hasznos linkek”Készült: Frissítve: