Belajar Kubernetes Shared Filesystem RWX - Laravel App: Struktur & Persiapan Build

#Pendahuluan

Sejak episode 0 kita membangun infrastruktur: NFS server, driver CSI, StorageClass, dan PVC. Sekarang mari melihat dari sisi yang sebaliknya — aplikasi. Kasus utama series ini adalah aplikasi web Laravel (misal portal upload foto/gallery) yang butuh shared storage untuk file-nya.

Mengapa episode ini penting? Keputusan terpenting dalam arsitektur storage bukan terletak di Kubernetes, melainkan di pemahaman aplikasi: folder mana yang boleh menjadi volume, mana yang harus menempel di image. Salah menentukan, dan kalian akan menghadapi perilaku aneh seperti session hilang atau upload ganda.

#Kenalan dengan Kasus Utama

Kita membangun portal galeri foto. User upload foto, admin melihat thumbnail, dan semua itu bisa diakses publik. Aplikasi kita: Laravel 11/12 dengan filesystem local dan public, PHP 8.3-FPM, Nginx, PostgreSQL (opsional), dan Redis (untuk session/cache di episode 19).

#Struktur Storage Laravel yang Relevan

Laravel menyimpan data runtime di storage/. Folder yang relevan dengan shared filesystem:

Konfigurasi filesystem di .env:

FILESYSTEM_DISK=local
# atau FILESYSTEM_DISK=public

Disk local menyimpan di storage/app/private (default Laravel), disk public di storage/app/public. Kedua-duanya harus berada di volume bersama.

#Menentukan Apa yang Harus "Shared"

Ini keputusan arsitektur paling penting. Bagi aplikasi kita:

Yang di-share (menjadi PVC RWX):

• storage/ — seluruh direktori, karena berisi upload, session, cache, log.

Yang baked ke image (BUKAN volume):

• vendor/ — dependency composer, dibangun saat build.
• .env — konfigurasi, disuntikkan via ConfigMap/Secret (episode 23).
• Kode aplikasi — tetap di image; update kode = build image baru.
• public/ selain storage/ symlink — asset statis dari repo.

#Membuat Storage di Laravel

Di kode aplikasi, Laravel memakai Storage facade. Contoh endpoint upload sederhana:

use Illuminate\Support\Facades\Storage;
 
public function upload(Request $request)
{
    $path = $request->file('photo')->store('uploads', 'public');
    return back()->with('ok', Storage::url($path));
}

Operasi yang akan sering dipakai:

Storage::exists('uploads/foo.jpg');                            // cek ada
Storage::put('uploads/bar.jpg', $content);                     // tulis
Storage::url('uploads/bar.jpg');                               // URL publik
Storage::disk('public')->put('thumbnail/bar.jpg', $thumb);     // tulis disk tertentu
Storage::delete('uploads/bar.jpg');                            // hapus

Semua operasi ini menulis ke storage/app/public — yang pada Pod kita bermuara ke volume RWX yang sama. Selama semua replica memakai path mount yang sama, file yang ditulis Pod A langsung terlihat di Pod B.

#Penutup

Pada episode 7 ini, kalian telah memetakan aplikasi ke storage:

Inti yang harus dibawa pulang:

• Laravel menyimpan upload, media, session, dan cache sebagai file di storage/.
• Folder yang di-share: storage/ dan symlink public/storage.
• Folder yang baked ke image: vendor/, .env, kode aplikasi.
• Aturan praktis: runtime-asserted & perlu bertahan → volume; buildable → image.
• Laravel menulis via Storage::put, Storage::disk, membaca via Storage::exists/Storage::url.

Di episode 8 selanjutnya kita akan membangun Dockerfile Laravel production: multi-stage dengan composer, PHP-FPM, dan Nginx, entrypoint dan permission yang konsisten, serta optimasi ukuran image. Sampai jumpa di episode 8!