VPS Murah Nevacloud

Podman Quadlet: Kontainer Jadi Service systemd Tanpa Docker Daemon

Podman 4.4.0 memperkenalkan Quadlet pada Februari 2023, dan sejak 4.7.0 perintah podman generate systemd resmi ditandai usang. Artinya, cara resmi menjalankan kontainer di bawah systemd bukan lagi menyalin unit file hasil generate, melainkan menulis satu berkas kecil berisi deklarasi kontainer. Oke, lanjuutt.. Di artikel ini kita pasang Podman Quadlet di VPS: satu berkas .container per layanan, systemctl --user yang mengurus start/stop/restart, dan tidak ada daemon Docker yang harus hidup lebih dulu supaya kontainer bisa jalan.

Ini penting untuk VPS kecil. Docker butuh daemon root yang berjalan terus, dan setiap kontainer hidup di bawah satu titik kegagalan yang sama. Podman berjalan tanpa daemon, bisa rootless, dan menyerahkan urusan siklus hidup ke systemd, komponen yang memang sudah ada di setiap server Linux.

Kenapa Quadlet, Bukan podman generate systemd

Dulu, untuk menjadikan kontainer sebagai service, kita menjalankan podman generate systemd --new lalu menyimpan hasilnya sebagai unit file. Cara itu punya dua masalah: unit file yang dihasilkan panjang dan berisi semua flag podman run mentah, dan setiap kali opsi kontainer berubah, kita harus generate ulang.

Quadlet membalik arahnya. Kita menulis berkas nama.container dengan bagian [Container], lalu systemd generator membacanya saat boot atau saat systemctl daemon-reload dan menerjemahkannya menjadi unit .service biasa. Yang kita pelihara cuma satu berkas pendek, sisanya urusan systemd.

Beberapa hal yang perlu dipegang sebelum mulai:

  • Hanya ada satu kunci wajib di [Container], yaitu Image. Sisanya opsional dan kebanyakan memetakan langsung ke flag podman run (misalnya PublishPort=8080:80 setara --publish 8080:80).
  • Nama kontainer otomatis diberi awalan systemd-. Berkas web.container menghasilkan service web.service dan kontainer bernama systemd-web. Kalau ingin nama sendiri, pakai ContainerName=.
  • Berkas Quadlet bukan unit systemd permanen. Unit .service hasil generate bersifat transien, jadi systemctl enable tidak berlaku untuknya. Cara mengaktifkannya adalah menambahkan bagian [Install].

Langkah 1: Cek Prasyarat di VPS

Quadlet butuh cgroups v2, dan rootless Podman butuh rentang UID/GID bawahan untuk penggunanya. Cek ketiganya sekaligus:


podman --version
podman info --format 'rootless={{.Host.Security.Rootless}} cgroups={{.Host.CgroupsVersion}}'
grep "^$USER:" /etc/subuid /etc/subgid
loginctl show-user "$USER" --property=Linger

Yang kita harapkan: versi Podman minimal 4.4 (lebih baik 5.x atau 6.x), rootless=true, cgroups=v2, dua baris subuid/subgid untuk user kita, dan Linger=no — untuk sementara. Linger=no itu normal di tahap ini dan akan kita perbaiki di langkah 4.

Di Debian 13 dan Ubuntu 25.10 paket repositori masih di jalur 5.4, sedangkan Fedora 43 sudah 5.8 dan Arch 6.2. Perhatikan versi minimum tiap kunci: Quadlet sendiri ada sejak 4.4, HealthCmd sejak 4.5, AutoUpdate sejak 4.6, dan Notify=healthy sejak 4.7 — jadi Ubuntu 24.04 (4.9) sudah cukup untuk semuanya, sementara Debian 12 (4.3) belum bisa Quadlet sama sekali. Dan kalau podman info melaporkan cgroups v1, Quadlet tidak akan jalan dan tidak ada cara memperbaikinya dari sisi berkas unit.

Langkah 2: Tulis Berkas .container Pertama

Buat direktori Quadlet milik user, lalu tulis satu layanan contoh. Untuk rootless, jalurnya ~/.config/containers/systemd/ — salah satu dari beberapa search path yang dibaca generator, dan yang paling masuk akal untuk layanan milik sendiri.


mkdir -p ~/.config/containers/systemd

[Unit]
Description=Nginx statis lewat Quadlet

[Container]
Image=docker.io/library/nginx:latest
ContainerName=web-nginx
PublishPort=8080:80
Volume=/srv/nginx/html:/usr/share/nginx/html:ro
AutoUpdate=registry
HealthCmd=curl -fsS http://localhost/ || exit 1
HealthInterval=30s

[Service]
Restart=always
TimeoutStartSec=900

Beberapa keputusan di berkas itu sengaja dipilih, bukan asal salin:

  • Port diikat ke 8080, bukan 80. Di rootless Podman, port di bawah 1024 butuh sysctl khusus; kita bahas di bagian jebakan.
  • Volume=/srv/nginx/html:...:ro memakai path absolut. Quadlet memang bisa resolve path relatif (yang diawali titik) terhadap lokasi berkas unit, tapi path absolut lebih mudah diaudit saat layanan pindah server.
  • HealthCmd + HealthInterval memberi systemd sinyal kesehatan kontainer. Berguna nanti kalau kita memakai Notify=healthy.
  • TimeoutStartSec=900 mengatasi masalah paling sering: systemd memberi batas start 90 detik, sedangkan tarik image pertama bisa jauh lebih lama. Dokumentasi Podman sendiri menyarankan potongan [Service] ini persis untuk kasus tersebut.

Kalau ingin lebih rapi lagi, Notify=healthy menunda status “started” sampai healthcheck menyatakan kontainer sehat. Tanpa itu, systemd menganggap service sudah jalan begitu proses kontainer hidup, padahal aplikasi di dalamnya belum tentu siap menerima koneksi.

Langkah 3: Generate dan Jalankan Service

Setelah berkas ditulis, minta systemd membacanya ulang. Generator akan mengubah .container menjadi .service pada saat itu juga:


systemctl --user daemon-reload
systemctl --user start web.service
systemctl --user status web.service

Verifikasi bahwa kontainer benar-benar berjalan, bukan cuma unit-nya:


podman ps
curl -I http://127.0.0.1:8080

podman ps seharusnya menampilkan kontainer bernama web-nginx, persis seperti nilai ContainerName= yang kita tulis. Tanpa kunci itu barulah namanya jadi systemd-web. Kalau unit web.service tidak ditemukan padahal berkasnya ada, hampir selalu penyebabnya daemon-reload belum dijalankan — generator hanya bekerja pada dua momen itu: boot dan reload.

Satu hal yang sering membingungkan: launchctl-style “enable” tidak ada di sini. systemctl --user enable web.service akan gagal karena unit hasil generate bersifat transien. Yang benar, tambahkan bagian install di berkas Quadlet:


[Install]
WantedBy=default.target

Untuk unit rootless, default.target adalah target yang tepat. Setelah itu daemon-reload sekali lagi dan service akan ikut start saat sesi systemd user dimulai.

Langkah 4: Pastikan Tetap Hidup Setelah Logout dan Reboot

Ini langkah yang paling sering terlewat, dan gejalanya menyesatkan: semua tampak benar sampai kita keluar dari SSH, lalu beberapa saat kemudian kontainer mati. Penyebabnya bukan Quadlet, tapi systemd user. Instance systemd milik user dimatikan begitu sesi terakhir berakhir.


loginctl enable-linger "$USER"
loginctl show-user "$USER" --property=Linger

Linger=yes membuat systemd user tetap hidup tanpa sesi login, sehingga service di dalamnya ikut hidup sejak boot. Untuk layanan produksi di VPS, ini wajib. Tanpa linger, WantedBy=default.target pun tidak menolong karena tidak ada yang menyalakan target itu saat tidak ada sesi.

Langkah 5: Update Image Otomatis Tanpa Menyentuh Terminal

AutoUpdate=registry di berkas contoh bukan sekadar label kosmetik. Podman membaca label io.containers.autoupdate yang dipetakan oleh kunci itu, lalu memeriksa registry apakah digest image berubah. Syaratnya satu: referensi image harus lengkap dengan nama registry, misalnya docker.io/library/nginx:latest. Kalau kita memakai nama pendek atau image ID, Podman tidak tahu harus memeriksa apa dan auto-update tidak akan pernah jalan.

Pemeriksaannya dijalankan oleh podman-auto-update.service, yang dipicu podman-auto-update.timer setiap tengah malam. Sebelum membiarkan timer bekerja sendiri, cek dulu hasilnya:


podman auto-update --dry-run --format "{{.Image}} {{.Updated}}"

Status pending berarti ada image baru dan belum ditarik. Untuk menjalankan pembaruan sungguhan, cukup podman auto-update. Kalau service gagal naik setelah image baru dipasang, Podman otomatis kembali ke image sebelumnya (--rollback aktif secara default) — tapi deteksi kegagalan itu jauh lebih andal kalau kontainer mengirim sinyal READY lewat sdnotify, bukan sekadar “prosesnya sempat hidup”. Di sinilah Notify=healthy dan healthcheck tadi berguna.

Jebakan yang Paling Sering Kena

Bagian ini yang membedakan tutorial yang jalan di laptop penulis dari tutorial yang berguna di VPS sungguhan. Semuanya berasal dari dokumentasi dan panduan troubleshooting resmi Podman.

Port 80 ditolak: pasta failed / bind: permission denied

Rootless Podman memakai pasta (sejak 5.0) atau slirp4netns (4.x) untuk jaringan, dan keduanya tidak boleh membuka port di bawah 1024 secara default:


Error: pasta failed with exit code 1:
Listen failed for HOST TCP port */80: Permission denied

Dua pilihan: tetap di port 8080 dan taruh reverse proxy di depannya, atau izinkan user biasa mengikat port 80 permanen:


# /etc/sysctl.d/99-podman-ports.conf
net.ipv4.ip_unprivileged_port_start=80

sudo sysctl --system

Pilihan kedua menurunkan ambang port istimewa untuk seluruh sistem, bukan hanya Podman. Kalau ada alasan keamanan, pilihan pertama lebih baik.

Unit tidak muncul dan kontainer mati setelah logout

Dua gejala, dua penyebab berbeda. Unit tidak muncul berarti daemon-reload belum jalan atau berkas ada di direktori yang salah (ingat: rootless membaca ~/.config/containers/systemd/, rootful membaca /etc/containers/systemd/). Kontainer mati setelah logout hampir pasti soal linger, bukan berkas unit.

systemctl enable gagal pada unit Quadlet

Ini bukan bug. Unit hasil generate tidak bisa di-enable seperti unit biasa; pakai [Install] WantedBy=default.target di berkas sumber. Sama seperti unit transien lainnya, systemctl --user list-unit-files tetap mendaftarkannya, tapi statusnya bukan “enabled”.

Start timeout saat tarik image

Gejalanya Job for web.service timed out pada start pertama, padahal podman run manual untuk image yang sama berhasil. Naikkan TimeoutStartSec di [Service] atau tarik image lebih dulu dengan podman pull. Untuk unit bertipe oneshot, timeout start justru tidak aktif secara default — jadi unit seperti itu tidak akan pernah gagal karena waktu.

Nama kontainer tidak seperti yang ditulis

Berkas web.container bukan berarti kontainernya bernama web. Tanpa ContainerName=, namanya systemd-web. Ini penting saat menulis skrip pemantauan atau saat mencari kontainer di Dozzle dan alat lain: yang dicari adalah nama dengan awalan itu, bukan nama berkas.

Kesimpulan

Podman Quadlet mengubah cara kita memikirkan kontainer di VPS: bukan daemon yang mengawasi kontainer, tapi systemd yang mengawasi kontainer lewat satu berkas deklaratif per layanan. Kita menulis web.container, menjalankan systemctl --user daemon-reload, dan sejak itu start, stop, restart, log, dan dependensi ditangani alat yang sudah terbukti di setiap server Linux.

Tiga hal yang wajib diingat sebelum memindahkan layanan produksi: cgroups v2, linger untuk unit rootless, dan referensi image yang lengkap kalau ingin auto-update bekerja. Sisanya — port, timeout, healthcheck — adalah penyetelan yang bisa kita lakukan sambil jalan.

Kalau VPS-mu saat ini menjalankan Docker Compose, tidak perlu migrasi serentak. Pilih satu layanan yang paling sederhana, jadikan berkas Quadlet, dan biarkan sisanya tetap seperti sekarang. Setelah satu layanan bertahan melewati reboot tanpa disentuh, baru pindahkan yang kedua. Selamat mencoba, dan semoga VPS-nya tidak perlu lagi kita bangunkan manual tiap pagi.

Baca juga

Nevacloud VPS Indonesia

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *