Codex'i NFS ana diziniyle çalıştırın
Linux makinelerinde etkileşimli çalışma için paylaşılan bir Codex ana dizini yapılandırın.
Linux makineleri, Network File System (NFS) üzerinden bir Codex ana dizinini (varsayılan olarak ~/.codex) paylaştığında, bir SQLite veritabanını aynı anda write-ahead log (WAL) modunda açarlarsa bozabilirler. CLI'da veya SSH üzerinden Codex uygulamasında etkileşimli çalışma için paylaşılan ana dizini geçirin. Bağımsız toplu işler için her makinenin Codex ana dizinini veya SQLite dizinini yerel diskte tutun.
NFS, SQLite'ı neden bozabilir?
Codex uygulaması ve terminal arayüzü, konuşmaları listelemek için bir SQLite dizini kullanır. Veritabanları ayrıca hedefleri ve bellek işleme durumunu saklar. Yerel diskte Codex normalde WAL modunu kullanır. Farklı makinelerdeki süreçler, WAL'ın ihtiyaç duyduğu belleği paylaşamaz.
Codex, Linux NFS'yi algıladığında veritabanlarını bunun yerine dosya kilitlerini kullanan rollback-journal modunda (DELETE) oluşturur. Mevcut WAL veritabanlarını başka bir makineden açmadan önce geçirin.
Codex ayrıca konuşma olaylarını rollout-*.jsonl dosyalarına kaydeder. Her yürütme kaydına aynı anda yalnızca bir süreç yazdığı için bunlar zaten NFS üzerinde bulunabilir. SQLite geçişi bu dosyaları yerinde bırakır.
Mevcut bir NFS ana dizinini geçirin
1. Paylaşılan ana dizini kontrol edin
SSH arka uçları dahil her makinede codex --version çalıştırın. Codex CLI 0.166.0 gibi codex migrate-nfs-db içeren bir derleme kullanın. Bu paylaşılan ana dizini kullanan tüm makinelerin aynı SQLite dizinini kullandığını doğrulayın. Depolama yöneticinizden, bir makinede tutulan dosya kilidinin diğer makinedeki çakışan bir kilidi engellediğini doğrulamasını isteyin. Bağlama noktası bunu yapamıyorsa SQLite'ı yerelde tutun.
2. Her makinede Codex'i durdurun
Arka plan hizmeti modunda CLI, oturumlar arasında çalışmaya devam eden bir arka plan sunucusuna bağlanır. Unix soketi yalnızca onu başlatan makinede çalışır. Makineler NFS üzerinden bir Codex ana dizinini paylaştığında CLI'ı arka plan hizmeti olmadan çalıştırmanızı öneririz. Hizmeti çalıştıran her makinede codex app-server daemon stop ile durdurun.
CLI'ın hizmeti yeniden başlatmasını önlemek için paylaşılan config.toml dosyanızdaki [features] altında daemon_auto_start değerini false olarak ayarlayın.
[features]
daemon_auto_start = falseTek bir CLI oturumu için --no-daemon geçirin. Bu bayrak, zaten çalışan bir arka plan hizmetini de atlar.
3. Geçişi çalıştırın
Her paylaşılan Codex ana dizini için geçişi yalnızca bir Linux makinesinde çalıştırın. Ana dizinin sahibinin hesabını ve normal yapılandırmasını kullanın. Geçiş bitene kadar diğer makinelerde Codex'i durdurulmuş durumda tutun.
codex migrate-nfs-db4. Bir konuşmayı sürdürün
Komut Skipped logs database bildirirse konumunu kontrol edin. Yerel diskteki bir günlük veritabanı için ek işlem gerekmez. NFS üzerindeyse başka bir makinede Codex'i yeniden açmadan önce DELETE günlük modunu kullandığını doğrulayın veya yerel diske taşıyın.
Geçiş başarıyla tamamlandıktan sonra aynı projeyi başka bir makinede aynı kullanıcı olarak açın. Uygulamada bildiğiniz bir konuşmayı sürdürün veya codex --no-daemon resume çalıştırın. Son turunuzun orada olduğunu ve konuşmaya devam edebildiğinizi kontrol edin.
Tanılama günlüklerini yerel diske taşıyın
İsteğe bağlıdır, geçişten sonra önerilir. Tanılama günlükleri, hataları ve yavaş açılışları araştırmanıza yardımcı olur. Bunları yerel olarak yazmak NFS trafiğini azaltır.
Her makinede özel, yazılabilir bir günlük dizini oluşturun. Kullanıcının config.toml dosyasındaki log_dir değerini o kullanıcıya ait mutlak yol olarak ayarlayın. Örneğin Alice şu ayarı kullanabilir.
log_dir = "/var/local/codex/alice/logs"Yeni günlükler bu dizine gider. Eski günlükler yerinde kalır.
Günlük modunu tüm makine filosunda zorunlu kılın
Önce etkilenen bir ana dizini kullanan her makinedeki tüm istemcileri durdurun. Ayar unsafe adını taşır; çünkü başka bir makine veritabanına yazarken onu dönüştürmek veritabanını bozabilir.
İstemciler durdurulmuşken bu ayarı makinelerin /etc/codex/requirements.toml içindeki yönetilen yapılandırmasına ekleyin.
unsafe_enforce_sqlite_journal_mode = trueAyar, yapılandırılmış makinelerdeki her kullanıcı için geçerlidir. Kullanıcı Codex'i bir sonraki açışında, NFS üzerindeki mevcut WAL veritabanları yazma amacıyla açılırken otomatik olarak geçirilir. Her paylaşılan ana dizin için diğer makineleri yeniden bağlamadan önce geçişin bir makinede tamamlanmasını bekleyin. Geçiş başarısız olursa diğer istemcileri durdurulmuş durumda bırakın ve kurtarma adımlarını izleyin.
Bağımsız toplu işler çalıştırın
Gözetimsiz bir iş etkileşimli oturum geçmişinize ihtiyaç duymuyorsa çalıştırıcının yerel diskindeki bir Codex ana diziniyle codex exec çalıştırın. Oturum dosyalarının NFS üzerinde kalması gerekiyorsa çalıştırıcıların aynı veritabanı için yarışmaması amacıyla CODEX_SQLITE_HOME değerini her iş için özel bir yerel dizine ayarlayın.
- Konuşma kaydı tutun. Her işe yürütme kaydı için özel, kalıcı bir
CODEX_HOMEve veritabanı için özel, makineye yerel birCODEX_SQLITE_HOMEverin. Çalıştırıcının dizini, etkileşimli dizininizden ayrıdır. Çalıştırıcı çıktıktan sonra işi incelemeniz gerekiyorsa yürütme kaydını$CODEX_HOME/sessions/altında tutun. - Yalnızca sonucu tutun. İşin ana dizinini yerel diske koyun ve
codex exec --ephemeralçalıştırın. Bu, kaldığı yerden sürdürülebilen bir oturumun kaydedilmesini atlar. Son yanıtı kalıcı bir dosyaya yazmak için-oveya olayları iş çalıştırıcınıza akış olarak göndermek için--jsonkullanın.
Yürütme kaydı gerektiren bir iş için zamanlayıcının her iki dizini de oluşturmasını ve işin ana dizini için kimlik doğrulama ile yapılandırmayı sağlamasını ayarlayın. Örnek yolları bu işin kalıcı Codex ana dizini ve çalıştırıcıya yerel SQLite diziniyle değiştirin. Yönetilen veya yapılandırılmış bir sqlite_home, CODEX_SQLITE_HOME değerinden önceliklidir.
CODEX_HOME="/mnt/nfs/codex/jobs/job-1234" \
CODEX_SQLITE_HOME="/var/local/codex/jobs/job-1234" \
codex exec "Summarize this repository's build steps."Sık sorulan sorular
Bir hatanın NFS ile ilgili olup olmadığını nasıl anlayabilirim?
cannot open source database exclusively gibi bir geçiş hatası, Codex'in veritabanını kilitleyemediği anlamına gelir. Başka bir istemci yerel diskte de buna neden olabilir. Linux'ta etkilenen veritabanının yoluyla findmnt -T "$DB_PATH" çalıştırın. nfs veya nfs4 bildirirse her makinede yazan süreçleri kontrol edin ve depolama yöneticisinden bu bağlama noktasında makineler arası kilitlemeyi doğrulamasını isteyin. Yeniden denemeden önce kalan istemcileri durdurun.
Geçiş çıktısında nelere bakmalıyım?
Codex her veritabanı için Migrated database: ve WAL backup: veya Already in DELETE mode: yazdırır. Grup izinlerine veya genişletilmiş erişim kurallarına güveniyorsanız geçişten sonra ve istemcileri yeniden açmadan önce bunları doğrulayın.
log_dir zaten ayarlanmışsa komut günlük veritabanını atlar. Bu veritabanını makineler arasında paylaşmadan önce DELETE kullandığından emin olun veya yerel diskte tutun.
No databases found. görürseniz ana dizinin sahibi olan kullanıcı için etkin SQLite dizinini kontrol edin. Yerel hazırlama alanı yetersizse yeterli alana sahip, makineye yerel bir dizin seçin ve mutlak yolunu --staging-dir ile geçirin.
Başarısız bir geçişten sonra nasıl kurtarma yaparım?
Diğer istemcileri durdurulmuş durumda tutun. Hatanın tam metnini, veritabanı yolunu ve yazdırılan yedek yolunu kaydedin. Bazı veritabanları zaten geçirilmiş olabilir. Özgün veritabanını ve yardımcı dosyalarını yedek dizinlerinde bir arada tutun. Kilit veya alan hatasını çözdükten sonra aynı makinede codex migrate-nfs-db komutunu yeniden çalıştırın. Bütünlük hatası veya eksik bir yeni veritabanı durumunda, herhangi bir şeyi geri yüklemeden önce kopyalar üzerinde çalışın. Oturum yürütme kayıtları konuşma geçmişini yeniden oluşturmaya yardımcı olabilir. Hedefler dahil yalnızca SQLite'ta tutulan durumun kurtarılması, sağlam bir veritabanı gerektirir.
Ayrı bir CLI oturumu başlatmadan önce yönetilen depolama ayarlarının yazma işlemlerini etkilenen ana dizine yönlendirmeyeceğini doğrulayın. Ardından Codex'i yerel diskte geçici bir dizin kullanarak başlatın. Yeni ana dizin oturum açmayı gerektirebilir.
recovery_home=$(mktemp -d /tmp/codex-nfs-recovery.XXXXXXXX) &&
CODEX_HOME="$recovery_home" CODEX_SQLITE_HOME="$recovery_home" \
codex --no-daemon --sandbox read-only \
"Help me recover a failed Codex NFS migration, run `$ codex doctor` to get the information about corrupted databases. Backup paths for databases should be in the original database with `_wal_migration_backup` in the end of the file. Ask user for the original error. Plan a recovery using copies and leave the originals untouched."