· kaynak dev.to (home feed)
GitHub Actions' GITHUB_TOKEN ile push edilen etiketler neden release workflow'larını hiç tetiklemiyor
Bir dev.to yazısı, GitHub Actions'ın yerleşik GITHUB_TOKEN'ının workflow tetikleyicilerini sessizce nasıl bastırdığını anlatıyor: bot tarafından push edilen on bir etiket sıfır release çalışması üretti — ve yazar, yeni secret gerektirmeyen çözümleri de ortaya koyuyor.

Ne oldu
dev.to'da yazan bir geliştirici, iki hafta boyunca işinin yalnızca yarısını sessizce yapan bir release pipeline'ını anlatıyor. Bir workflow, main dalına yapılan her birleştirmede çalışıyordu: sonraki sürümü hesaplıyor, v önekli bir etiket oluşturuyor, push ediyor ve yeşil olarak tamamlanıyordu. İkinci bir workflow olan release.yml ise bu etikete tepki verip artifact'lar derleyerek bir GitHub Release yayınlaması gerekiyordu.
On bir etiket çıktı. Sıfır release workflow'u çalıştı. Actions sekmesi ne hata ne de atlanan çalışma gösteriyordu — sanki etiketler hiç push edilmemiş gibi tamamen hiçbir şey yoktu.
Sessizce başarısız olan bir kural
Yazıya göre kök neden, GitHub'ın bilinçli bir tasarım kararı: yerleşik GITHUB_TOKEN tarafından oluşturulan olaylar asla yeni workflow çalışmaları başlatmıyor. Dal push'ları, etiket push'ları, açılan pull request'ler, yayınlanan release'ler, etiketler ve issue'lar diğer her workflow'un on: bloğuna görünmez hale geliyor. GitHub bunu sonsuz döngüyü önlemek için yapıyor — push üzerinde çalışan ve aynı zamanda commit push eden bir workflow aksi halde kendini sonsuza kadar yeniden tetiklerdi. Yalnızca iki olay muaftır: workflow_dispatch ve repository_dispatch, GITHUB_TOKEN ile gönderilseler bile hâlâ tetiklenir.
Sinir bozucu kısım hiçbir şeyin başarısız olmamasıdır. Push gerçekleşir, etiket var olur ve olay repository'de kaydedilir; sadece workflow zamanlayıcısına hiç iletilmez. Loglar yeni etiketi gösterir ve iş yeşil bir onayla biter.
actions/checkout içindeki gizli suçlu
Yazarın bump workflow'u GITHUB_TOKEN'ı hiç açıkça belirtmiyordu. Token, actions/checkout üzerinden sızdı; bu action varsayılan olarak onunla kimlik doğrulaması yapar ve bu kimlik bilgilerini yerel git yapılandırmasında kalıcı hale getirir. Aynı işteki sonraki herhangi bir git push bu nedenle o token'ı kullanarak github-actions[bot] olarak çalışır. Yazarın önerdiği en hızlı teşhis, aynı etiketi bir dizüstü bilgisayardan elle push etmektir: release workflow'u hemen tetikleniyorsa bu kural nedendir.
Yan hasar: pull request'ler
Yazıya göre aynı kural başka yerde daha sert ısırıyor. GITHUB_TOKEN kullanan bir workflow tarafından açılan pull request'ler gerekli durum kontrollerini asla tetiklemez; bu yüzden otomatik bağımlılık güncelleme PR'ları, CI çalıştırılmadığı için "Waiting for status to be reported" aşamasında sonsuza kadar takılı kalabilir. workflow_run tetikleyicisi yine de ateşlenir — insan push'unun başlattığı上游 tamamlanmış çalışmayı esas alır — ancak downstream iş etiketi değil upstream commit'ini görür, bu yüzden sürümün context'ten çıkarılması gerekir.
Yeni secret gerektirmeyen çözümler
İki çözüm kimlik bilgisi eklemeyi gerektirmez:
- Yeniden kullanılabilir workflow'lar: release.yml'i bir etiket girdisi kabul eden workflow_call ile dönüştürün, sonra bump işinden etiketi açıkça geçirerek çağırın. İki ayrıntı önemlidir: çağrılan workflow, çağıranın github context'i ile çalışır, dolayısıyla github.ref hâlâ etikete değil dala işaret eder; ayrıca çağrılan workflow, çağıranın verdiğinden daha fazla GITHUB_TOKEN izni taşıyamaz — release asset yüklüyorsa çağıranın contents: write iznine ihtiyacı vardır.
- Dispatch: release.yml'in tetikleyicilerine workflow_dispatch ekleyin, bump işine actions: write ve contents: write izinleri verin, ardından gh workflow run release.yml komutunu --ref yeni etiketi gösterecek şekilde ve GH_TOKEN olarak github.token ayarlanmış şekilde çalıştırın. Release çalışması böylece etiketi checkout eder ve tıpkı manuel bir push gibi refs/tags/'ı görür; ayrıca Actions sekmesinde kendi başına ayrı bir çalışma olarak görünür.
Yalnızca farklı bir token'ın işe yaradığı durumlar
Eğer olayın kendisi sizin kontrolünüz dışındaki şeyleri tetiklemesi gerekiyorsa — örneğin bir bot tarafından açılmış pull request üzerinde gerekli kontroller — workflow zincirleme ne kadar artarsa artsın yardımcı olmaz. Yazı, her çalışma için actions/create-github-app-token ile üretilen ve checkout'a verilerek işteki sonraki her push'un onu kullanmasını sağlayan bir GitHub App kurulum token'ı öneriyor. Bu tür token'lar bir saat sonra süresi dolar ve hiçbir kişinin hesabına bağlı değildir. Personal access token da işe yarar, ancak yazar onu seçeneklerin en kötüsü olarak sıralıyor.
Neden önemli
Bu başarısızlık modu ne hata, ne log satırı ne de kırmızı bir işaret üretir — bir şeylerin ters gittiğine dair en güçlü sinyal bir yokluktur. Otomasyonu varsayılan token ile etiket push eden, PR açan veya release yayınlayan her ekip, sessizce atlanan pipeline'lara ve kalıcı olarak duran kontrollere maruz kalır. Çözüm ucuz ve yapısaldır: platformun bilinçli olarak bastırdığı olaylara güvenmek yerine workflow'ları workflow_call veya dispatch üzerinden açıkça zincirleyin ve daha güçlü token'ları, bir olayın gerçekten yayılması gereken dar durumlar için saklayın.
- #github-actions
- #ci-cd
- #devops
- #release-automation
- #github
İlgili yazılar
- Yıldız satın alan ağlar, kötü amaçlı yazılım barındıran sahte GitHub repolarını trend listelerine taşıyor
- Kafka UI giriş sayfaları kişileri doğrular, arkalarındaki ayrıcalıklı cluster principal'ını değil
- OpenAI Agents SDK, yeni issue'ların yüzde 98'ini 30 günde kapattı; Anthropic'un Claude Agent SDK'sı 54'ün 1'ini