İçeriğe geç
zefıly
← Tüm yazılar

Ubuntu 26.04'te Redis'ten Valkey'e geçiş: döküm dosyası yüklenmiyor

5 dk okuma

Ubuntu 26.04, Redis 8.0 ve Valkey 9.0 ile gelir. Veriyi birinden diğerine taşımanın üç yolunu denedik; üçü de açık hatalarla başarısız oldu. Bunun yerine ne işe yarar, geçiş ne zaman önemsizdir ve PHP uygulamanızda neye bakılır.

Valkey, Redis'in açık kaynaklı devamıdır: Redis lisansını değiştirdiğinde Redis 7.2'den çatallandı ve aynı protokolü konuşur. Rehberlerin çoğu geçişin kolay olduğunu söyler: Redis'i durdur, Valkey'i aynı veri dosyasıyla başlat.

Bu, Redis 7.2 için doğruydu. Ubuntu 26.04'ün getirdiği Redis için doğru değil. 12 Kasım 2026'da yeni kurulmuş bir Ubuntu 26.04.1 sisteminde denedik.

Kısaca

  • Ubuntu 26.04'ün arşivinde Redis 8.0.5 ve Valkey 9.0.4 vardır.
  • Valkey 9, Redis 8 döküm dosyasını okuyamaz: Can't handle RDB format version 12.
  • Redis 8'den Valkey 9'a çoğaltma ve MIGRATE komutu da başarısız olur.
  • Redis yalnızca önbellekse bunların hiçbiri önemli değildir: geçin ve önbellek yeniden dolsun.
  • Redis ihtiyaç duyduğunuz veriyi tutuyorsa uygulama düzeyinde anahtar anahtar kopyalayın ya da Redis 8'e yükseltmeden önce 7.2'den geçin.
  • PHP kodunuz değişmez. redis eklentisi Valkey ile olduğu gibi konuşur.

Ubuntu 26.04'te ne var

apt-cache policy redis-server valkey-server
redis-server:   5:8.0.5-1ubuntu0.1
valkey-server:  9.0.4-0ubuntu0.2

İkisi de arşivdedir ve aynı makineye kurulabilir. Valkey, uyumluluk için istemcilere kendini Redis 7.2 sunucusu olarak bildirir:

redis_version:7.2.4
valkey_version:9.0.4

İşe yaramayan üç yol

1. Valkey'i Redis döküm dosyasıyla başlatmak. Redis 8.0.5 ile bir anahtar yazdık, kaydettik ve Valkey 9.0.4'ü o dump.rdb dosyasının bulunduğu dizinde başlattık:

# Can't handle RDB format version 12
# Fatal error loading the DB, check server logs. Exiting.

Redis 8 anlık görüntüsünü 12. biçim sürümüyle yazar. Valkey bu biçim ortaya çıkmadan önce çatallandı ve onu reddeder. Sunucu hiç başlamaz; boş da başlamaz.

2. Çoğaltma. Kesintisiz taşımanın klasik yolu, yeni sunucuyu eskisinin kopyası yapmaktır:

valkey-cli replicaof 127.0.0.1 6390

Komut OK yanıtını verdi, ama bağlantı hiç kurulmadı:

role:slave
master_link_status:down

Çoğaltma aynı anlık görüntü biçimini göndererek başlar; aynı nedenle başarısız olur.

3. MIGRATE. Tek bir anahtarı Redis'ten Valkey'e taşımak:

ERR Target instance replied with error: ERR DUMP payload version or checksum are wrong

MIGRATE, anahtarın aynı sürümü taşıyan serileştirilmiş biçimini kullanır.

İşe yarayan

Önbellekse: doğrudan geçin. Sayfa önbellekleri, nesne önbellekleri, hız sınırı sayaçları ve çoğu oturum yeniden oluşturulabilir. Redis'i durdurun, Valkey'i aynı portta boş başlatın; uygulama onu yeniden doldurur. Oturumlar orada tutuluyorsa kullanıcılar bir kez yeniden giriş yapabilir. Çoğu PHP sitesi için geçişin tamamı budur:

sudo systemctl disable --now redis-server
sudo apt-get install valkey-server
sudo systemctl enable --now valkey-server
valkey-cli ping

Valkey paketi varsayılan olarak, Redis gibi 127.0.0.1 üzerinde ve 6379 portunda, protected-mode yes ile dinler. Yapılandırması /etc/valkey/valkey.conf, verisi /var/lib/valkey içindedir. Kendi ayarlarınızı (maxmemory, maxmemory-policy, parola) /etc/redis/redis.conf dosyasından kopyalayın; adları aynıdır.

Veri önemliyse: komut düzeyinde kopyalayın. Her anahtarı Redis'ten sıradan komutlarla okuyan (GET, HGETALL, LRANGE, SMEMBERS, ZRANGE … WITHSCORES ve TTL) ve Valkey'e yazan bir betik çalışır; çünkü sıradan komutlar iki tarafta da aynıdır. Kuyruklarda daha basit yol, yeni işler yeni sunucuya giderken işçilerin eski kuyruğu boşaltmasına izin vermektir.

Hâlâ Redis 7.2 ya da daha eskisindeyseniz: Redis 8'e yükseltmeden önce Valkey'e geçin. Valkey 7.2'den çatallandı ve belgelerine göre onun veri dosyalarını okur. Bu yolu kendimiz denemedik; bir kopyada deneyin.

PHP uygulamam değişir mi?

Hayır. Valkey, Redis protokolünü konuşur. PHP redis eklentisi (Ubuntu 26.04'te php8.5-redis 6.2.0) ve Predis, Valkey'e değişiklik yapmadan bağlanır. Sunucu adresi, port ve parola olduğu gibi kalır.

Bakılacak iki şey:

  • Modüller ve yeni komutlar. Redis 8'de Redis Stack'ten gelen yerleşik veri türleri vardır (JSON, arama, zaman serisi). Valkey'in çekirdeğinde bunlar yoktur; bir kısmı ayrı Valkey modülleri olarak bulunur. Uygulamanız JSON.SET ya da FT.SEARCH kullanıyorsa önce deneyin.
  • Sürüm denetimleri. redis_version okuyan yazılım Valkey'den 7.2.4 alır. "Redis 8 ya da daha yenisi" isteyen bir kütüphane reddeder.

Neden geçmeli?

  • Lisans. Valkey BSD lisanslıdır ve Linux Vakfı tarafından yürütülür. Redis lisansını 2024'te ve sonrasında yeniden değiştirdi; bunun önemi onu nasıl kullandığınıza bağlıdır.
  • Dağıtımların yönü. Birkaç dağıtım ve bulut sağlayıcı artık varsayılan olarak Valkey sunuyor. Varsayılanı izlemek çoğu zaman daha hızlı güvenlik güncellemesi demektir.

İkisi de sizi ilgilendirmiyorsa Ubuntu 26.04'teki Redis 8 çalışır ve Ubuntu tarafından desteklenir. Acele etmeye gerek yok.

Zefily ile

Zefily'nin nesne önbelleği Valkey'dir. Sunucunun Veritabanları bölümünden bir kez kurarsınız; sonra her PHP sitesinde WordPress ya da Laravel'e kendi önbelleğini veren bir Nesne önbelleği düğmesi olur. Yalnızca yerelde dinler. Erişim, önbellek ve koruma belgesine bakın.

Sık sorulan sorular

Valkey, Redis dump.rdb dosyasını okuyabilir mi?

Belgelerine göre Redis 7.2 ve öncesinden evet. Redis 8'den hayır: denememizde Valkey 9.0.4, "Can't handle RDB format version 12" hatasıyla durdu.

Ubuntu 26.04'te Redis mi var, Valkey mi?

İkisi de. Arşivde redis-server 8.0.5 ve valkey-server 9.0.4 vardır.

Valkey için PHP kodumu değiştirmem gerekir mi?

Hayır. Valkey, Redis protokolünü konuşur; PHP redis eklentisi ve Predis onunla değişmeden çalışır.

Redis 8'den Valkey'e nasıl geçerim?

Yalnızca önbellekse Valkey'i boş başlatın ve dolmasını bekleyin. Değilse anahtarları bir betikle sıradan komutlarla kopyalayın; döküm dosyaları, çoğaltma ve MIGRATE bu sürümler arasında çalışmaz.

Valkey neden redis_version 7.2.4 bildiriyor?

Sürümü denetleyen istemcilerle uyumluluk için. Kendi sürümü valkey_version alanındadır.

Zefily'nin kurduğu PHP eklentileri için Web yığını belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →