Chạy Codex với thư mục chính trên NFS
Cấu hình thư mục chính Codex dùng chung để làm việc tương tác trên nhiều máy chủ Linux.
Khi các máy chủ Linux dùng chung một thư mục chính Codex (mặc định là ~/.codex) qua Network File System (NFS), chúng có thể làm hỏng cơ sở dữ liệu SQLite nếu cùng lúc mở cơ sở dữ liệu đó ở chế độ nhật ký ghi trước (WAL). Để làm việc tương tác trong CLI hoặc ứng dụng Codex qua SSH, hãy di chuyển thư mục chính dùng chung. Với các tác vụ hàng loạt độc lập, hãy giữ thư mục chính Codex hoặc thư mục SQLite của mỗi máy chủ trên ổ đĩa cục bộ.
Vì sao NFS có thể làm hỏng SQLite
Ứng dụng Codex và giao diện người dùng trong terminal sử dụng một chỉ mục SQLite để liệt kê các cuộc hội thoại. Các cơ sở dữ liệu cũng lưu mục tiêu và trạng thái xử lý bộ nhớ. Trên ổ đĩa cục bộ, Codex thường sử dụng chế độ WAL. Các tiến trình trên những máy chủ khác nhau không thể chia sẻ vùng nhớ mà WAL cần.
Khi phát hiện NFS trên Linux, Codex tạo cơ sở dữ liệu ở chế độ nhật ký hoàn tác (DELETE), sử dụng khóa tệp thay thế. Hãy di chuyển các cơ sở dữ liệu WAL hiện có trước khi mở chúng từ máy chủ khác.
Codex cũng lưu các sự kiện hội thoại trong các tệp rollout-*.jsonl. Những tệp này vốn có thể nằm trên NFS vì tại mỗi thời điểm chỉ có một tiến trình ghi vào mỗi bản ghi phiên. Việc di chuyển SQLite giữ nguyên các tệp đó tại chỗ.
Di chuyển thư mục chính NFS hiện có
1. Kiểm tra thư mục chính dùng chung
Chạy codex --version trên mỗi máy chủ, bao gồm mọi máy chủ phụ trợ SSH. Sử dụng bản dựng có chứa codex migrate-nfs-db, chẳng hạn như Codex CLI 0.166.0. Xác nhận rằng tất cả máy chủ sử dụng thư mục chính dùng chung này đều dùng cùng một thư mục SQLite. Nhờ quản trị viên lưu trữ xác minh rằng khóa tệp được giữ trên một máy chủ sẽ chặn khóa xung đột trên máy chủ kia. Giữ SQLite trên ổ đĩa cục bộ nếu điểm gắn kết không làm được điều này.
2. Dừng Codex trên mọi máy chủ
Trong chế độ daemon, CLI kết nối với một máy chủ nền tiếp tục chạy giữa các phiên. Socket Unix của máy chủ này chỉ hoạt động trên máy chủ đã khởi động nó. Chúng tôi khuyên bạn chạy CLI mà không dùng daemon khi các máy chủ chia sẻ thư mục chính Codex qua NFS. Dừng daemon trên từng máy chủ đang chạy nó bằng codex app-server daemon stop.
Để CLI không khởi động lại daemon, đặt daemon_auto_start thành false trong mục [features] của config.toml dùng chung.
[features]
daemon_auto_start = falseVới một phiên CLI đơn lẻ, hãy truyền --no-daemon. Cờ này cũng bỏ qua daemon đang chạy.
3. Chạy quá trình di chuyển
Chỉ chạy quá trình di chuyển trên một máy chủ Linux cho mỗi thư mục chính Codex dùng chung. Sử dụng tài khoản của chủ sở hữu thư mục chính và cấu hình thông thường. Giữ Codex ở trạng thái dừng trên các máy chủ khác cho đến khi quá trình di chuyển hoàn tất.
codex migrate-nfs-db4. Tiếp tục một cuộc hội thoại
Nếu lệnh báo Skipped logs database, hãy kiểm tra vị trí của cơ sở dữ liệu đó. Cơ sở dữ liệu nhật ký trên ổ đĩa cục bộ không cần xử lý thêm. Nếu nằm trên NFS, hãy xác nhận rằng nó sử dụng chế độ nhật ký DELETE hoặc chuyển nó sang ổ đĩa cục bộ trước khi mở lại Codex trên máy chủ khác.
Sau khi di chuyển thành công, mở cùng dự án trên máy chủ khác bằng cùng tài khoản người dùng. Tiếp tục một cuộc hội thoại quen thuộc trong ứng dụng hoặc chạy codex --no-daemon resume. Kiểm tra xem lượt trao đổi cuối cùng của bạn còn đó và bạn có thể tiếp tục cuộc hội thoại hay không.
Chuyển nhật ký chẩn đoán sang ổ đĩa cục bộ
Không bắt buộc, khuyến nghị thực hiện sau khi di chuyển. Nhật ký chẩn đoán giúp bạn điều tra lỗi và tình trạng khởi động chậm. Ghi nhật ký cục bộ giúp giảm lưu lượng trên NFS.
Tạo một thư mục nhật ký riêng tư, có quyền ghi trên mỗi máy chủ. Đặt log_dir trong config.toml của người dùng thành đường dẫn tuyệt đối dành cho người dùng đó. Ví dụ, Alice có thể dùng cài đặt này.
log_dir = "/var/local/codex/alice/logs"Nhật ký mới được ghi vào thư mục đó. Nhật ký cũ vẫn ở vị trí ban đầu.
Áp dụng bắt buộc chế độ nhật ký trên toàn bộ hệ thống máy chủ
Trước tiên, dừng tất cả ứng dụng khách trên mọi máy chủ sử dụng thư mục chính bị ảnh hưởng. Cài đặt có tên unsafe vì việc chuyển đổi cơ sở dữ liệu trong khi máy chủ khác ghi vào đó có thể làm hỏng cơ sở dữ liệu.
Khi các ứng dụng khách đã dừng, thêm cài đặt này vào cấu hình được quản lý của các máy chủ trong /etc/codex/requirements.toml.
unsafe_enforce_sqlite_journal_mode = trueCài đặt áp dụng cho mọi người dùng trên các máy chủ được cấu hình. Lần tiếp theo người dùng mở Codex, Codex tự động di chuyển các cơ sở dữ liệu WAL hiện có khi mở chúng để ghi trên NFS. Với mỗi thư mục chính dùng chung, hãy để quá trình di chuyển hoàn tất trên một máy chủ trước khi kết nối lại các máy chủ khác. Nếu di chuyển thất bại, giữ các ứng dụng khách khác ở trạng thái dừng và làm theo các bước khôi phục.
Chạy các tác vụ hàng loạt độc lập
Nếu một tác vụ không có người giám sát không cần lịch sử phiên tương tác của bạn, hãy chạy codex exec với thư mục chính Codex trên ổ đĩa cục bộ của máy thực thi. Nếu các tệp phiên cần nằm trên NFS, hãy đặt CODEX_SQLITE_HOME thành một thư mục cục bộ riêng cho từng tác vụ để các máy thực thi không tranh chấp cùng một cơ sở dữ liệu.
- Giữ bản ghi hội thoại. Cấp cho mỗi tác vụ một
CODEX_HOMEriêng tư, được lưu bền vững cho bản ghi phiên và mộtCODEX_SQLITE_HOMEriêng tư, cục bộ trên máy chủ cho cơ sở dữ liệu. Chỉ mục của máy thực thi tách biệt với chỉ mục tương tác của bạn. Giữ bản ghi phiên trong$CODEX_HOME/sessions/nếu bạn cần kiểm tra tác vụ sau khi máy thực thi thoát. - Chỉ giữ kết quả. Đặt thư mục chính của tác vụ trên ổ đĩa cục bộ và chạy
codex exec --ephemeral. Thao tác này bỏ qua việc lưu phiên có thể tiếp tục. Dùng-ođể ghi phản hồi cuối cùng vào một tệp được lưu bền vững hoặc--jsonđể truyền các sự kiện đến trình chạy tác vụ.
Với tác vụ cần bản ghi phiên, hãy để bộ lập lịch tạo cả hai thư mục, đồng thời cấp thông tin xác thực và cấu hình cho thư mục chính của tác vụ. Thay các đường dẫn ví dụ bằng thư mục chính Codex được lưu bền vững của tác vụ này và thư mục SQLite cục bộ trên máy thực thi. Một sqlite_home được quản lý hoặc đã cấu hình sẽ được ưu tiên hơn CODEX_SQLITE_HOME.
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."Câu hỏi thường gặp
Làm sao biết một lỗi có liên quan đến NFS hay không?
Một lỗi di chuyển như cannot open source database exclusively nghĩa là Codex không thể khóa cơ sở dữ liệu. Một ứng dụng khách khác cũng có thể gây ra lỗi này trên ổ đĩa cục bộ. Trên Linux, chạy findmnt -T "$DB_PATH" với đường dẫn đến cơ sở dữ liệu bị ảnh hưởng. Nếu lệnh báo nfs hoặc nfs4, hãy kiểm tra các tiến trình ghi trên mọi máy chủ và nhờ quản trị viên lưu trữ xác minh cơ chế khóa giữa các máy chủ trên điểm gắn kết đó. Dừng các ứng dụng khách còn lại trước khi thử lại.
Tôi nên chú ý điều gì trong đầu ra của quá trình di chuyển?
Với mỗi cơ sở dữ liệu, Codex in ra Migrated database: và WAL backup:, hoặc Already in DELETE mode:. Nếu dựa vào quyền nhóm hoặc quy tắc truy cập mở rộng, hãy xác minh chúng sau khi di chuyển và trước khi mở lại các ứng dụng khách.
Nếu log_dir đã được đặt, lệnh sẽ bỏ qua cơ sở dữ liệu nhật ký. Trước khi chia sẻ cơ sở dữ liệu đó giữa các máy chủ, hãy bảo đảm nó sử dụng DELETE hoặc giữ nó trên ổ đĩa cục bộ.
Nếu thấy No databases found., hãy kiểm tra thư mục SQLite có hiệu lực cho người dùng sở hữu thư mục chính. Nếu không gian lưu trữ tạm cục bộ không đủ, hãy chọn một thư mục cục bộ trên máy chủ có đủ dung lượng và truyền đường dẫn tuyệt đối của nó bằng --staging-dir.
Làm sao khôi phục sau khi di chuyển thất bại?
Giữ các ứng dụng khách khác ở trạng thái dừng. Lưu nguyên văn lỗi, đường dẫn cơ sở dữ liệu và đường dẫn bản sao lưu được in ra. Một số cơ sở dữ liệu có thể đã được di chuyển. Giữ cơ sở dữ liệu gốc cùng các tệp đi kèm trong cùng thư mục sao lưu của chúng. Sau khi xử lý lỗi khóa hoặc dung lượng, chạy lại codex migrate-nfs-db trên cùng máy chủ. Với lỗi toàn vẹn dữ liệu hoặc thiếu tệp thay thế, hãy thao tác trên các bản sao trước khi khôi phục bất cứ thứ gì. Các bản ghi phiên có thể giúp xây dựng lại lịch sử hội thoại. Việc khôi phục trạng thái chỉ có trong SQLite, bao gồm các mục tiêu, đòi hỏi cơ sở dữ liệu còn nguyên vẹn.
Trước khi bắt đầu một phiên CLI riêng, hãy xác nhận rằng cài đặt lưu trữ được quản lý sẽ không chuyển hướng thao tác ghi về thư mục chính bị ảnh hưởng. Sau đó khởi động Codex bằng một thư mục tạm trên ổ đĩa cục bộ. Thư mục chính mới có thể yêu cầu đăng nhập.
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."