YAML
Kullanıcı yönetimi
Yapılandırma dosyaları
Lisans: MIT
GitHub Actions Sürekli Entegrasyon (CI/CD) İş Akışı
Orijinal Kod Adı:
YAML — publish-release.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: 80 satır (~2.1 KB). Kaynak depo: sedatyildiznet/sedophp.
💡 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/publish-release.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/publish-release.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: Publish Release
on:
workflow_dispatch:
push:
branches: [main]
paths:
- '.github/workflows/publish-release.yml'
permissions:
contents: write
concurrency:
group: publish-release
cancel-in-progress: false
jobs:
release:
name: Publish VERSION
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
- name: Validate release metadata
id: meta
shell: bash
run: |
set -euo pipefail
VERSION="$(tr -d '\r\n' < VERSION)"
if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
echo "VERSION must contain a stable semantic version, got: $VERSION" >&2
exit 1
fi
if ! grep -Fq "## $VERSION — " CHANGELOG.md; then
echo "CHANGELOG.md has no stable release section for $VERSION" >&2
exit 1
fi
echo "version=$VERSION" >> "$GITHUB_OUTPUT"
echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
- name: Build release notes
shell: bash
run: |
set -euo pipefail
VERSION="${{ steps.meta.outputs.version }}"
awk -v version="$VERSION" '
$0 ~ "^## " version " — " { capture = 1; next }
capture && /^## / { exit }
capture { print }
' CHANGELOG.md > /tmp/release-notes.md
if [[ ! -s /tmp/release-notes.md ]]; then
echo "Release notes are empty for $VERSION" >&2
exit 1
fi
- name: Publish GitHub Release
env:
GH_TOKEN: ${{ github.token }}
TAG: ${{ steps.meta.outputs.tag }}
VERSION: ${{ steps.meta.outputs.version }}
shell: bash
run: |
set -euo pipefail
if gh release view "$TAG" --repo "$GITHUB_REPOSITORY" >/dev/null 2>&1; then
echo "$TAG already exists; nothing to publish."
exit 0
fi
gh release create "$TAG" \
--repo "$GITHUB_REPOSITORY" \
--target "$GITHUB_SHA" \
--title "SedoPHP $VERSION" \
--notes-file /tmp/release-notes.md
# Release trigger marker: 0.2.1