GitHub Actions, Node.js 20'yi Kaldırdı: Çalışma Akışlarınızı Nasıl Denetlersiniz ve Düzeltirsiniz
GitHub Actions artık JavaScript eylemleri için Node.js 20 çalışma zamanını sağlamıyor. Uygulamanız Node.js kullanmasa bile, eski bir checkout, kurulum veya üçüncü taraf eylemi artık CI sorunu olabilir. İşte çalışma akışlarınızı nasıl denetleyeceğiniz, özel eylemleri güncelleyeceğiniz ve kendi barındırdığınız çalıştırıcıları güvenli bir şekilde kontrol edeceğiniz.
GitHub Actions'tan Node.js 20 Kaldırıldı: İş Akışlarınızı Nasıl Denetleyeceksiniz ve Düzelticeksiniz
Bir GitHub Actions iş akışı, derlediği projede hiç JavaScript olmasa bile Node.js'ye bağımlı olabilir.
Bu ayrıntı önemli hale geldi.
23 Eylül 2026'da, GitHub, GitHub Actions çalıştırcılarından Node.js 20'ın kaldırılmasını tamamladı. JavaScript eylemleri artık Node.js 24'te çalışıyor ve kullanıcıların Node 20'da kalmalarına izin veren geçici uyumluluk anahtarı artık mevcut değil.
Birçok depoda hiçbir şey değişmesi gerekmez. GitHub'ın birinci taraf eylemlerinin geçerli sürümleri zaten Node 24'e geçti.
Ancak eski iş akışları, özel JavaScript eylemleri ve bazı kendi kendine barındırılan çalıştırcılar denetime değer.
Önemli ayrım, GitHub'ın hangi Node.js çalışma zamanından söz ettiğini anlamaktır.
Uygulama çalışma zamanınız ve Eylem çalışma zamanı farklı şeylerdir
Aşağıdaki iş akışına sahip bir PHP projesini düşünün:
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: composer install
- name: Run tests
run: vendor/bin/phpunit
Uygulama PHP'dir. Ancak actions/checkout kendi bir JavaScript eylemidir. GitHub, Actions çalıştırcısıyla paketlenen bir Node.js çalışma zamanı kullanarak JavaScript'ini çalıştırır.
Bu çalışma zamanı, iş akışınız tarafından yüklenen Node.js'den bağımsızdır. Aynı şekilde, actions/setup-node sonraki iş akışı komutları için Node 22 yükleyebilirken, eylem kendisi meta verisinde bildirilen çalışma zamanı ile çalışır.
Bu ayrım, Node 20 kaldırılmasının olası olarak PHP, Python, Go, Java ve diğer non-Node projelerini etkilemesini açıklar.
Tam olarak ne değişti?
GitHub, Node.js 20'nın Nisan 2026'da yaşam sonuna geldiği için Node 20 kullanımdan kaldırılmasını çok önce duyurdu. GitHub Haziran 2026'da Actions'ı varsayılan olarak Node 24'e geçmeye başladı. Geçiş süresi sırasında kullanıcılar ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION ile geçici olarak eski çalışma zamanına geri dönüş yapabiliyordu. Bu sadece bir geçiş kaçış yolu idi.
23 Eylül 2026'da, GitHub, GitHub Actions çalıştırcılarından Node 20'ı kaldırdı ve o çıkış seçeneğini de kaldırdı. Sürdürdüğünüz bir eylem hala Node 20 beyan ediyorsa, GitHub'ın önerisi bunu Node 24'e güncellemek ve yeni bir sürüm yayımlamaktır.
İlk denetim: Her uses: satırını inceleyin
En basit iş akışı denetimi .github/workflows'de başlar. uses: için arama yapın ve birinci taraf ile üçüncü taraf eylemlerinin envanterini oluşturun. Bir iş akışı hala çalışıyor olduğu sadece nedeniyle güncel olduğu varsayımıyla maydon etmeyin.
Her eylem için, iş akışınız tarafından referans gösterilen sürümün Node 24'ü destekleyen geçerli bir sürüm olup olmadığını belirleyin. Üçüncü taraf eylemlerine özel dikkat edin: Ana sürümleri körü körüne değiştirmeden önce sürüm geçmişlerini kontrol edin. Girdiler, varsayılanlar, kimlik doğrulama mekanizmaları ve önbellek davranışı, Node geçişinden bağımsız olarak değişebilir.
Özel JavaScript eylemleri farklı bir düzeltme gerektirir
Kendi JavaScript eymenizi sürdürüyorsanız, action.yml veya action.yaml dosyasını inceleyin. Bir JavaScript eylemi hala şunları içerebilir:
runs:
using: node20
main: dist/index.js
Çalışma zamanı bildirimi Node 24'ü hedeflemelidir:
runs:
using: node24
main: dist/index.js
Bu satırı değiştirmek sadece başlangıçtır. Eylemi Node 24 altında test edin, gerektiğinde bağımlılıkları güncelleyin ve işleme konmuş her dist/ paketini yeniden oluşturun. Aksi takdirde tüketiciler, kaynak değişse bile eski oluşturulmuş JavaScript'i çalıştırmaya devam edebilir.
Güvenli bir geçiş, geliştirme ortamını güncellemek, bağımlılıkları güncellemek, runs.using'ı değiştirmek, dağıtılmış JavaScript'i yeniden oluşturmak, testleri çalıştırmak, eylemi gerçek bir iş akışında denemek ve ardından yeni bir sürüm yayımlamaktır.
Kendi kendine barındırılan çalıştırcılara özel dikkat gereklidir
GitHub-barındırılan çalıştırcılar GitHub tarafından sürdürülür. Kendi kendine barındırılan çalıştırcılar farklıdır. Çalıştırcı uygulaması, JavaScript eylemleri tarafından kullanılan Node.js yürütülebilir dosyalarını içerir, bu nedenle çalıştırcı sürümü önemlidir. Yeni Node-24-tabanlı eylem sürümleri yeterince yeni bir Actions Runner gerektirir.
Kuruluşunuz kendi kendine barındırılan çalıştırcılar işletiyorsa, sadece iş akışı YAML'ına bakmak yerine geçiş denetimine sürümlerini, işletim sistemlerini ve mimarilerini dahil edin. Eski işletim sistemleri gizli bir engel haline gelebilir çünkü Node 24 desteklenen platform tabanını değiştirir.
CodeQL'ın kendi geçiş yolu vardır
GitHub kod taraması kullanan depolar, CodeQL iş akışlarını da incelemelidir. CodeQL Action v4, Node.js 24 çalışma zamanını kullanır. Bu nedenle gelişmiş CodeQL kurulumları daha eski github/codeql-action referansları için kontrol edilmeli ve GitHub'ın mevcut uyumluluk kılavuzuna göre geçiş yapılmalıdır.
Faydalı bir denetim komutu
Unix benzeri bir geliştirme makinesinde, hızlı bir ilk geçiş şudur:
grep -R "uses:" .github/workflows
Depo içindeki özel eylemler için:
grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"
Bu aramalar uyumluluğu ispatlamaz, ancak verimli bir envanter sağlar. Amaç üç soruya yanıt vermektir: hangi eylemler kullanılıyor, hangi sürümler sabitlenmiş ve hangi özel eylemler hala eski bir çalışma zamanı beyan ediyor?
Eylemler etiketlere mi yoksa işlem SHA'larına mı sabitlenmelidir?
Bir çalışma zamanı geçişi aynı zamanda tedarik zinciri temizliğini gözden geçirmek için iyi bir fırsattır. vendor/action@v4 gibi bir referans, geliştiricisi tarafından taşınabilirken, tam bir işlem SHA'sı değiştirilemez bir revizyonu tanımlar.
Güvenlik açısından hassas iş akışları için, üçüncü taraf eylemleri tam işlem SHA'larına sabitlemek beklenmedik kod değişikliği riskini azaltabilir. Bunun karşılığı bakımdır: güncellemeler ardından bilinçli bir süreç veya bağımlılık-güncelleme araçları gerektirir.
Ayrıcalıklı çekme isteği iş akışlarıyla özellikle dikkatli olun
Eski eylemleri güncellemek önemli, ancak iş akışı güvenlik modeli daha da önemlidir. pull_request_target, ana depoya ait token, gizli diziler ve önbelleğe erişimle çalışabilir. Bu tür ayrıcalıklı bir iş akışı içinde saldırgan tarafından kontrol edilen çekme isteği kodunun check-out edilmesi ciddi bir tedarik zinciri güvenlik açığı oluşturabilir.
Node 24 için iş akışı dosyalarını denetlerken, tetikleyicilerini ve izinlerini aynı anda inceleyin. Modern bir çalışma zamanı, güvenli olmayan bir iş akışını güvenli hale getirmez.
Pratik bir geçiş kontrol listesi
İlk olarak .github/workflows'deki tüm uses: referanslarını listeleyin. Sürüm notlarını inceledikten sonra eski birinci taraf eylemlerini yükseltin. Her üçüncü taraf eylemi için sürdürülen bir Node-24-uyumlu sürüm olup olmadığını kontrol edin. Özel eylem meta verilerinde node20 için arama yapın, bunu node24'e geçirin, paketleri yeniden oluşturun ve test edin.
Kendi kendine barındırılan çalıştırcılar için çalıştırcı sürümünü, işletim sistemini ve mimariyi doğrulayın. CodeQL gelişmiş iş akışlarını gözden geçirin. Son olarak, önemli sürüm, zamanlanmış ve dağıtım iş akışlarını ve varsayılan CI yolunu deneyin, çünkü nadir kullanılan işler eski eylem sürümlerinin genellikle hayatta kaldığı yerlerdir.
Neden bu geçişin doğru yapılması değerlidir
GitHub Actions içindeki Node.js çalışma zamanı geçişleri, başka birinin altyapı sorunu gibi görünbilir. Değildirler. Eylemler, CI/CD sisteminizdeki yürütülebilir bağımlılıklardır. Sürümleri derleyebilir, kimlik bilgilerini yönetebilir, artefaktları yükleyebilir ve üretim uygulamalarını dağıtabilirler.
GitHub'ın Node 20'dan Node 24'e geçişi, bu nedenle CI bağımlılıklarının da uygulama bağımlılıkları gibi yaşam döngülerine sahip olduğu için faydalı bir hatırlatmadır.
Hemen yapılacak görev basittir: kalan eski JavaScript eylemi bağımlılıklarını kaldırın ve gerekli yerlerde kendi kendine barındırılan altyapıyı güncelleyin. Uzun vadeli ders daha değerlidir: .github/workflows'ı, yazılıp unutulabilen bir yapılandırma olarak değil, sürdürülen uygulama altyapısı olarak değerlendirin.
Eylemlerini, çalıştırcı sürümlerini, izinlerini ve üçüncü taraf bağımlılıklarını düzenli denetleyen bir depo, bir sonraki çalışma zamanı geçişi için çok daha iyi hazırlanmış olacak ve geçişler arasında oldukça daha güvenli olacaktır.