YAML
MySQL
Veritabanı bağlantıları
API örnekleri
Yapılandırma dosyaları
Lisans: MIT
GitHub Actions Sürekli Entegrasyon (CI/CD) İş Akışı
Orijinal Kod Adı:
YAML — ci.yml
Kod gönderimi (push) veya Pull Request açıldığında otomatik testleri, sözdizimi kontrollerini ve derleme adımlarını çalıştırır. Dosya ölçeği: 135 satır (~3.4 KB). Kaynak depo: memran/marwa-db.
💡 Püf Noktaları:
• Bağımlılık kurulum sürelerini kısaltmak için workflow içinde `actions/cache` kullanarak paket önbelleklemesi yapın.
• Erişim anahtarlarını asla YAML dosyasına yazmayın; GitHub `secrets` mekanizması ve en az yetki (`permissions`) kuralını uygulayın.
• Üçüncü parti GitHub Actions adımlarını dal adı yerine tam commit SHA veya kararlı sürüm etiketiyle (`@v4`) sabitleyin.
🛠️ Uygulama Tarifi:
1. Dosyayı depo içinde `.github/workflows/ci.yml` yoluna yerleştirin.
2. İş akışında kullanılan API anahtarı veya dağıtım parolalarını GitHub Repo > Settings > Secrets altından tanımlayın.
3. Test dalına (`branch`) commit gönderip GitHub Actions sekmesinden adımların yeşil geçtiğini doğrulayın.
💡 Püf Noktaları:
• Bağımlılık kurulum sürelerini kısaltmak için workflow içinde `actions/cache` kullanarak paket önbelleklemesi yapın.
• Erişim anahtarlarını asla YAML dosyasına yazmayın; GitHub `secrets` mekanizması ve en az yetki (`permissions`) kuralını uygulayın.
• Üçüncü parti GitHub Actions adımlarını dal adı yerine tam commit SHA veya kararlı sürüm etiketiyle (`@v4`) sabitleyin.
🛠️ Uygulama Tarifi:
1. Dosyayı depo içinde `.github/workflows/ci.yml` yoluna yerleştirin.
2. İş akışında kullanılan API anahtarı veya dağıtım parolalarını GitHub Repo > Settings > Secrets altından tanımlayın.
3. Test dalına (`branch`) commit gönderip GitHub Actions sekmesinden adımların yeşil geçtiğini doğrulayın.
Dikkat Edilmesi Gerekenler:
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
name: CI
on:
push:
pull_request:
jobs:
test:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
php: ['8.2', '8.3', '8.4', '8.5']
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php }}
tools: composer
coverage: xdebug
- name: Cache Composer dependencies
uses: actions/cache@v4
with:
path: |
~/.composer/cache
~/.cache/composer
key: ${{ runner.os }}-composer-${{ matrix.php }}-${{ hashFiles('composer.json', 'composer.lock') }}
restore-keys: |
${{ runner.os }}-composer-${{ matrix.php }}-
- name: Install dependencies
run: composer install --no-interaction --no-progress --prefer-dist
- name: Lint
run: composer lint
- name: Static analysis
run: composer analyse
- name: Tests
run: composer test
coverage:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.4'
tools: composer
coverage: xdebug
- name: Cache Composer dependencies
uses: actions/cache@v4
with:
path: |
~/.composer/cache
~/.cache/composer
key: ${{ runner.os }}-composer-coverage-${{ hashFiles('composer.json', 'composer.lock') }}
restore-keys: |
${{ runner.os }}-composer-coverage-
- name: Install dependencies
run: composer install --no-interaction --no-progress --prefer-dist
- name: Coverage
run: composer test:coverage
integration:
runs-on: ubuntu-latest
services:
mysql:
image: mysql:8.4
env:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: marwa_test
ports:
- 3306:3306
options: >-
--health-cmd="mysqladmin ping -h 127.0.0.1 -proot"
--health-interval=10s
--health-timeout=5s
--health-retries=10
postgres:
image: postgres:16
env:
POSTGRES_DB: marwa_test
POSTGRES_PASSWORD: postgres
ports:
- 5432:5432
options: >-
--health-cmd=pg_isready
--health-interval=10s
--health-timeout=5s
--health-retries=10
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.5'
extensions: pdo_mysql, pdo_pgsql
tools: composer
coverage: none
- name: Install dependencies
run: composer install --no-interaction --no-progress --prefer-dist
- name: Database integration tests
run: composer test:integration
env:
MARWA_DB_INTEGRATION: '1'
MARWA_DB_HOST: 127.0.0.1
MARWA_DB_PORT: 3306
MARWA_DB_DATABASE: marwa_test
MARWA_DB_USERNAME: root
MARWA_DB_PASSWORD: root
MARWA_DB_PG_INTEGRATION: '1'
MARWA_DB_PG_HOST: 127.0.0.1
MARWA_DB_PG_PORT: 5432
MARWA_DB_PG_DATABASE: marwa_test
MARWA_DB_PG_USERNAME: postgres
MARWA_DB_PG_PASSWORD: postgres