Tovább a tartalomhoz

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.

  • Workflow: egy YAML-fájl a .github/workflows/ mappában.
  • Esemény (on): ami elindítja, például push, pull_request, schedule (időzítés), workflow_dispatch (kézi indítás) vagy release.
  • 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:

.github/workflows/proba.yml
name: Próba
on: [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.

A WordPress-kódolási szabványok ellenőrzése minden pushnál és pull requestnél:

.github/workflows/phpcs.yml
name: PHPCS
on: [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/phpcs

A 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.

A WordPress-tesztkörnyezethez adatbázis kell. A munkafolyamat egy MySQL-szolgáltatást indít, a PHPUnit pedig ahhoz csatlakozik:

.github/workflows/phpunit.yml
name: PHPUnit
on: [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/phpunit

A 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.

.github/workflows/build.yml
name: Build
on:
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.

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:

.github/workflows/deploy.yml
name: Deploy
on:
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-dev

FTP-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:

.github/workflows/wporg.yml
name: Deploy to WordPress.org
on:
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-bovitmenyed

A SLUG elhagyható, ha a repó neve megegyezik a WordPress.org-os névvel.

on:
push:
branches: [main]
paths:
- 'src/**'
- 'package.json'

Egy job csak feltétellel fusson, például if: github.ref == 'refs/heads/main'.

  • 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.

Készült: Frissítve:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások