Jika API dari dua branch yang berjalan bersamaan menukar sesi autentikasi atau menampilkan data cache yang tidak konsisten, periksa apakah kedua backend memakai Redis dan port worker yang sama. Pada setup multi-instans Git worktree—termasuk pola isolasi lingkungan dev seperti Treehouse—setiap worktree perlu konfigurasi, port, dan namespace Redis sendiri.
Git worktree memisahkan direktori dan branch, tetapi tidak otomatis memisahkan proses backend, layanan Redis, atau variabel lingkungan. Akibatnya, dua proses yang tampak terpisah dapat tetap menulis ke key Redis yang sama.
Studi kasus: sesi tertukar dan cache tertimpa
Seorang developer menjalankan API dari dua worktree: satu untuk branch utama dan satu untuk perubahan fitur. Kedua API berjalan bersamaan. Setelah login pada satu branch, permintaan dari branch lain kadang terlihat memakai sesi yang sama. Data yang dibaca juga dapat berasal dari branch yang berbeda atau berubah secara tidak terduga.
Dalam kasus ini, kedua instance memakai Redis yang sama dengan nama key sesi dan cache yang sama. Worker juga mencoba memakai port yang sama. Direktori kode memang berbeda, tetapi sumber daya runtime tidak diisolasi.
- Sesi tertukar: kedua instance dapat membaca atau menulis key sesi yang identik, terutama jika ID sesi yang sama digunakan.
- Cache tertimpa: key seperti
user:42dapat ditulis oleh kedua branch dengan nilai atau format yang berbeda. - Worker gagal bind: proses kedua mungkin gagal memulai karena port sudah dipakai, atau tanpa sengaja terhubung ke layanan yang bukan miliknya.
Telusuri collision dengan alat sistem dan Redis
1. Periksa proses dan port yang sedang dipakai
Gunakan lsof untuk melihat proses yang membuka port. Ganti nomor port sesuai konfigurasi backend dan worker Anda.
lsof -nP -iTCP:8000 -sTCP:LISTEN
lsof -nP -iTCP:9000 -sTCP:LISTEN
Periksa juga listener dengan ss pada Linux:
ss -ltnp | grep -E ':8000|:9000'
Jika proses kedua tidak muncul pada port yang diharapkan, periksa log startup untuk error bind. Jika port ditempati proses dari worktree lain, catat PID dan command line-nya sebelum menghentikan proses agar tidak memutus instance yang masih digunakan.
2. Amati perintah Redis saat kedua API aktif
Jalankan pemantauan singkat di lingkungan lokal:
redis-cli -h 127.0.0.1 -p 6379 MONITOR
Kirim permintaan ke kedua API, lalu amati apakah keduanya membaca atau menulis pola key yang sama, misalnya session:... atau cache:user:42. MONITOR menampilkan perintah yang diterima Redis, bukan identitas worktree secara otomatis. Karena itu, cocokkan waktu dan pola key dengan permintaan yang Anda kirim.
Catatan keamanan:
MONITORdapat menampilkan nilai yang dikirim ke Redis, termasuk data sensitif. Gunakan hanya pada lingkungan lokal atau terkontrol, batasi durasi, dan jangan menyalin keluaran ke log publik.
Perbaiki isolasi per worktree
Konfigurasi terpisah untuk setiap instance
Jalankan setiap backend dengan environment file atau environment prosesnya sendiri. Pisahkan sekurangnya port HTTP, port worker, konfigurasi koneksi Redis, dan prefix key. Contoh berikut menunjukkan nilai yang harus berbeda; sesuaikan nama variabel dengan aplikasi Anda.
# Worktree A
APP_PORT=8101
WORKER_PORT=9101
REDIS_URL=redis://127.0.0.1:6379/0
REDIS_PREFIX=dev_a_
# Worktree B
APP_PORT=8102
WORKER_PORT=9102
REDIS_URL=redis://127.0.0.1:6379/0
REDIS_PREFIX=dev_b_
Prefix harus diterapkan secara konsisten pada semua key yang dapat berbagi ruang nama: sesi, cache, antrean, lock, dan metadata worker. Nama variabel seperti REDIS_PREFIX bukan standar universal; pastikan aplikasi atau library yang digunakan benar-benar menerapkannya.
Alokasikan port tanpa mengandalkan satu nilai bersama
Untuk pengembangan lokal, tetapkan port berbeda per worktree melalui file environment yang tidak dibagikan, atau gunakan skrip startup yang memilih port kosong. Jika aplikasi mendukung binding ke port 0, sistem operasi dapat memilih port yang tersedia; aplikasi perlu mengekspos port hasil binding agar klien dan worker dapat menemukannya.
Memeriksa port kosong lalu menggunakannya kemudian memiliki celah race: proses lain dapat mengambil port di antara dua langkah itu. Untuk menghindarinya, pilih mekanisme binding yang meminta port langsung kepada sistem operasi atau gunakan supervisor yang mengelola alokasi port. Worker dan backend yang berkomunikasi harus menerima port aktual yang sama dari konfigurasi instance.
Bangun prefix Redis dari path worktree
Path worktree memberi identitas lokal yang berbeda. Hash pendek menghindari karakter path yang tidak sesuai untuk key, sedangkan awalan tetap memudahkan inspeksi.
WORKTREE_PATH=$(git rev-parse --show-toplevel)
WORKTREE_ID=$(printf '%s' "$WORKTREE_PATH" | sha256sum | cut -c1-12)
REDIS_PREFIX="dev_${WORKTREE_ID}_"
Contoh ini menggunakan sha256sum, yang tersedia pada banyak sistem Linux. Pada sistem tanpa perintah tersebut, gunakan utilitas hash yang tersedia dan pastikan semua proses dalam worktree menghasilkan ID yang sama. Jangan gunakan prefix lokal ini sebagai kontrol keamanan atau isolasi antar-tenant di lingkungan produksi.
Skrip minimal untuk memverifikasi environment
Skrip berikut menerima dua direktori worktree, menghitung ID dan port contoh dari path, lalu gagal jika hasilnya bertabrakan. Port di sini hanya pemeriksaan konfigurasi, bukan reservasi port; proses tetap perlu menangani kemungkinan port sudah digunakan.
#!/usr/bin/env bash
set -euo pipefail
for dir in "$@"; do
path=$(git -C "$dir" rev-parse --show-toplevel)
id=$(printf '%s' "$path" | sha256sum | cut -c1-8)
port=$((20000 + 0x$(printf '%s' "$id" | cut -c1-4) % 40000))
printf '%s\t%s\t%s\tdev_%s_\n' "$path" "$id" "$port" "$id"
done | awk -F '\t' '
seen_id[$2]++ || seen_port[$3]++ { print "Collision: " $0 > "/dev/stderr"; failed=1 }
{ print }
END { exit failed }
'
Simpan, misalnya, sebagai check-worktrees.sh, lalu jalankan dengan dua path worktree:
bash check-worktrees.sh ../project-main ../project-feature
Skrip ini memerlukan Bash, Git, sha256sum, dan awk. Hash path membuat kemungkinan tabrakan kecil, bukan mustahil; pemeriksaan mendeteksi tabrakan di antara direktori yang diberikan. Untuk alokasi port yang harus bebas race, gunakan binding port dinamis, bukan hasil perhitungan ini.
Verifikasi setelah perbaikan
- Pastikan kedua proses memakai file environment dan port yang berbeda.
- Login pada kedua API, lalu pastikan sesi masing-masing tetap terpisah.
- Picu operasi cache yang sama dari kedua branch dan periksa bahwa key Redis memiliki prefix berbeda.
- Gunakan
lsofataussuntuk memastikan listener berada pada port yang dikonfigurasi. - Hentikan pemantauan
MONITORsetelah pemeriksaan selesai.
Git worktree mengisolasi checkout kode, bukan layanan yang dipakai proses. Jika dua backend memang perlu berbagi Redis, prefix yang konsisten dan port worker yang unik mencegah collision key serta konflik listener tanpa harus menjalankan satu server Redis untuk setiap worktree.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!