Workflow History, Enterprise planı olmadan yalnızca 24 saat gösterir. İşte n8n workflow'larını JSON export ve Git ile kendiniz kalıcı olarak nasıl yedekleyebileceğiniz.
n8n'de workflow oluşturan herkes bunları sürekli değiştirir: bir node eklenir, bir filtre ayarlanır, sonradan bir hata yönetimi eklenir. Versiyonlama olmadan bu değişikliklerin her biri sessiz bir üzerine yazma işlemidir ve "Dün hangi versiyon hala stabil çalışıyordu?" sorusu artık cevaplanamaz. n8n bunun için yerleşik bir Change History sunar, ancak tam geçmiş ve Source Control üzerinden native Git senkronizasyonu Business ve Enterprise planlarına ayrılmıştır, ücretsiz Community Edition'a değil.
Diğer herkes için manuel JSON export bir çözüm olarak kalır: workflow'lar istenildiği zaman JSON dosyası olarak indirilebilir ve kendi Git deponuza eklenebilir. Bu makale, yerleşik Change History'nin gerçekte ne sunduğunu, sınırlarının nerede olduğunu ve Enterprise lisansı olmadan bile mevcut araçlarla nasıl çalışan bir yedekleme ve versiyonlama sistemi kurabileceğinizi gösteriyor.
n8n'deki her workflow'un, tüm kaydedilmiş versiyonların listelendiği bir menüyü açan kendi geçmiş simgesi vardır, her biri seçilen versiyonun canvas önizlemesiyle birlikte.n8n'in Change History dokümantasyonuna göre n8n, workflow'u kaydettiğinde, eski bir versiyonu geri yüklediğinde (bu durumda önceden aktif olan versiyon önce kaydedilir) veya Source Control üzerinden bir Git deposundan pull yaptığında otomatik olarak yeni bir versiyon oluşturur.
Kaydedilen her versiyon için birkaç işlem kullanılabilir:
Bu geçmişin kapsamı pratikte önemlidir. Plana göre belirgin şekilde farklılık gösterir:
Bu somut olarak şu anlama gelir: Community Edition veya basit bir Cloud planı kullanan biri en geç bir gün sonra daha eski ara durumlara erişimini kaybeder. Gerçek, kalıcı bir versiyon geçmişi için yerleşik özellik bu durumlarda yeterli değildir.
n8n, Source Control ile workflow'ları bir depoyla otomatik olarak senkronize etmeyi sağlayan native bir Git entegrasyonu sunar, ayrı Git branch'leri üzerinden birden fazla ortam dahil.n8n'in Source Control ve Environments dokümantasyonuna göre bu özellik ise "Available on Business and Enterprise plans" durumundadır, yani ne ücretsiz Community Edition'ın ne de basit Cloud paketlerinin bir parçasıdır.
Source Control'ün kullanılabilir olduğu yerlerde kurulum Settings > Environments üzerinden yapılır. Orada Git deposu URL'sini, ya bir Deploy Key ile SSH üzerinden ya da bir Personal Access Token ile HTTPS üzerinden girersiniz ve n8n bunun için otomatik olarak bir SSH anahtarı oluşturur (varsayılan olarak ED25519). Instance sahipleri ve instance yöneticileri daha sonra hem push hem pull yapabilir, proje yöneticileri ise yalnızca push yapabilir. Birden fazla ortamla üretken şekilde çalışan ve Business veya Enterprise lisansına sahip olan herkes bu native yolu kullanmalıdır, bu da export'un manuel bakımını üzerinizden alır.
Business veya Enterprise lisansı olmadan, JSON export workflow'ları kalıcı ve versiyonlanmış şekilde güvence altına almanın en güvenilir yolu olmaya devam ediyor.n8n'in Export ve Import dokümantasyonuna göre n8n workflow'ları temelde JSON formatında saklar ve tam olarak bu format dışa aktarılabilir, bir Git deposuna eklenebilir ve orada diğer her kod değişikliği gibi commit edilebilir, etiketlenebilir ve geri alınabilir.
Tek tek workflow'lar için editör arayüzü tamamen yeterlidir:
Dokümantasyon, dışa aktarılan JSON dosyalarının credential adları ve credential ID'leri içerdiğini açıkça belirtir. Böyle bir dosyayı paylaşmadan veya ortak bir depoya koymadan önce, hassas erişim bilgilerinin yanlışlıkla versiyon geçmişine karışmaması için bu bilgileri kaldırmalı veya anonimleştirmelisiniz.
Kendi barındırdığınız bir n8n instance'ının tüm workflow'larının eksiksiz bir yedeğini almak için CLI, manuel tek tek indirmeden daha uygundur.n8n'in komut satırı dokümantasyonuna göre bunun için ayrı export ve import komutları mevcuttur:
n8n export:workflow --all --output=backups/latest/ tüm workflow'ları bir dizine dışa aktarır.n8n export:workflow --backup --output=backups/latest/ dahili olarak --all --pretty --separate ayarlayan özel backup modunu kullanır: tüm workflow'lar, okunabilir şekilde biçimlendirilmiş, her biri ayrı bir dosya olarak.n8n export:workflow --id=<ID> --output=file.json hedefli olarak tek bir workflow'u dışa aktarır.n8n import:workflow --separate --input=backups/latest/ tek tek JSON dosyaları içeren eksiksiz bir dizini geri içe aktarır.n8n import:workflow --separate --input=backups/latest/ --activeState=fromJson içe aktarma sırasında her workflow'un orijinal aktivasyon durumunu da devralır.CLI'nin backup modunu düzenli bir cron job ve bir Git deposuyla birleştirin, sonuçta kendi yaptığınız ama sağlam bir versiyonlama elde edersiniz:
1. Diğer uygulama kodunuzdan ayrı, özel bir Git deposu oluşturun.
2. n8n sunucusunda n8n export:workflow --backup --output=backups/latest/ komutunu çalıştıran günlük bir cron job kurun.
3. Dışa aktarılan dosyaları, otomatik veya manuel olarak, açıklayıcı bir commit mesajıyla depoya commit edin.
4. Her commit'ten önce, temizlenmemiş credential referanslarının bulunmadığını kontrol edin, ideal olarak credentialId gibi bilinen kalıpları filtreleyen veya işaretleyen basit bir script ile.
5. İstikrarlı production durumlarını açıkça işaretlemek için gerektiğinde git tag kullanın, böylece onları aylar sonra bile tekrar bulabilirsiniz.
Bununla özünde Source Control'ün native olarak sunduğu şeyi elde edersiniz, sadece otomatik bir push-pull mekanizması olmadan ve geri yüklerken biraz daha fazla manuel çalışmayla. Küçük ekipler ve bağımsız freelancer'lar için bu, bir Business lisansı ekonomik olarak karşılığını verene kadar genellikle kabul edilebilir bir uzlaşmadır.
Yerleşik workflow geçmişini kullanan ve saklama süresini kendisi kontrol etmek isteyen herkes, sunucu yapılandırmasında doğru ayarı bulacaktır.n8n'in workflow history ortam değişkenleri dokümantasyonuna göre N8N_WORKFLOW_HISTORY_PRUNE_TIME değişkeni, n8n eski versiyonları otomatik olarak silmeden önce kaç saat saklanacağını belirler. Varsayılan değer -1'dir, bu da teknik olarak tüm versiyonların sınırsız süreyle saklandığı anlamına gelir, ancak görünürlük için önceki bölümdeki plana bağlı sınırlar yine de geçerlidir.
Enterprise lisansı olmayan kendi barındırılan instance'larda yine de bu değişkeni bilinçli olarak ayarlamaya ve ek olarak JSON export çözümünü kurmaya değer. Böylece arayüzün o anda ne gösterdiğinden veya gizlediğinden bağımsız olarak versiyon geçmişiniz üzerinde kontrolü elinizde tutarsınız.
Hayır. Tam geçmişe sahip yerleşik Change History ve Source Control üzerinden native Git senkronizasyonu gerçekten Business ve Enterprise planlarına ayrılmıştır, ancak manuel JSON export ücretsiz Community Edition dahil her n8n versiyonunda çalışır. Kendi Git deponuz ve düzenli bir CLI export ile birleştirildiğinde, manuel de olsa tam teşekküllü bir versiyonlama elde edersiniz.
Community Edition'da ve basit planlarda, N8N_WORKFLOW_HISTORY_PRUNE_TIME ortam değişkeni sınırsız saklamaya ayarlanmış olsa bile arayüz üzerinden yalnızca son 24 saatin versiyonları görüntülenebilir. Daha geriye gitmesi gereken her şey için ya daha yüksek bir plana ya da JSON export üzerinden kendi yedekleme sisteminize ihtiyacınız vardır.
n8n dokümantasyonuna göre, dışa aktarılan workflow JSON dosyaları credential adları ve credential ID'leri içerir, ancak düz metin şifreler veya token'lar içermez. Yine de bu referansları, paylaşmadan veya ortak bir depoya eklemeden önce, kimsenin ID'lerden erişim bilgisi yapınız hakkında sonuç çıkaramaması için kaldırmalı veya anonimleştirmelisiniz.
Evet. Canvas üzerinde tek tek node'ları seçip Ctrl+C veya Cmd+C ile kopyalarsanız, bir metin editöründe kaydedilip daha sonra tekrar yapıştırılabilen geçerli workflow JSON'u elde edersiniz. Bu, bir hata yönetimi veya standart bir HTTP yapılandırması gibi yeniden kullanılabilir yapı taşlarını ayrı ayrı versiyonlamak için iyi uygundur.
n8n export:workflow --backup komutu otomatik olarak --all --pretty --separate bayraklarını ayarlar, böylece instance'ın tüm workflow'larını dışa aktarır, JSON'u okunabilir şekilde biçimlendirir ve her workflow için ayrı bir dosya oluşturur. Bu bayraklar olmadan --all ile yapılan basit bir export ise tüm workflow'ları tek bir dosyaya veya biçimlendirilmemiş şekilde yazabilir, bu da Git'te sonraki diff karşılaştırmalarını önemli ölçüde daha karmaşık hale getirir. Bu nedenle temiz bir Git yedeklemesi için backup modu daha iyi seçimdir.
NordFlux'un kurucusu. Webden ve SEO'dan grup ölçeğindeki otomasyona kadar yedi yıllık deneyim, bugün KOBİ'ler için pragmatik biçimde ve Alman veri egemenliğiyle.
Sertifikalar
n8n Community Edition: gerçekten eksik olan özellikler ve ücretsiz lisans anahtarının açtığı üç özellik.
n8n workflow'larını CLI ile nasıl dışa ve içe aktaracağınızı ve kilitlenme durumunda bir kullanıcının parolasını komut satırından nasıl sıfırlayacağınızı öğrenin.
Community sürümü ücretsiz ve sınırsızdır, Business ayda 667 EUR'ya mal olur. Planları gerçekten neyin ayırdığı ve bir KOBİ'nin ne zaman Enterprise'a ihtiyaç duyduğu.
Enterprise plan olmadan n8n'in Change History'si yalnızca bir gün geriye gider, bu yüzden silinen veya bozulan bir workflow bu sürenin ardından geri getirilemez. NordFlux, kurulumunuz için JSON export ile güvenilir bir Git yedekleme sistemi kurar ve sürekli bakımını üstlenir. İlk görüşmede workflow'larınızın bugün nasıl yedeklendiğini kontrol ederiz.