Menjalankan aplikasi Rails di VPS dengan systemd
Dokumen ini merangkum menjalankan Rails di VPS Linux (Debian/Ubuntu) sebagai layanan systemd dengan Puma. Contoh di bawah disadur dari konfigurasi produksi; ganti user Linux, root aplikasi, nama unit, dan nama EnvironmentFile agar seragam di server Anda.
Prasyarat singkat
- Aplikasi sudah di-deploy ke direktori tetap (contoh:
/var/www/nama_app— gantinama_appsesuai kebijakan deployment). - Ruby, Bundler, dan gem tersedia untuk user yang memiliki proses layanan (bukan root).
RAILS_ENV=production(dan secret lain) diatur lewatEnvironmentFileatau config yang konsisten.
1. Unit file systemd (contoh produksi)
Simpan unit misalnya di /etc/systemd/system/rails-app.service lalu isi (sesuaikan nama berkas, user, dan path):
[Unit]
Description=Puma HTTP server (aplikasi Rails, produksi)
After=network.target
[Service]
User=app
Group=app
WorkingDirectory=/var/www/nama_app
# --- PENTING UNTUK LOGGING ---
# Pastikan Rails TIDAK melempar log ke STDOUT, tapi ke file log/production.log
# (Hapus baris ini jika di production.rb Anda tidak ada logika RAILS_LOG_TO_STDOUT)
Environment=RAILS_LOG_TO_STDOUT=false
Environment=RAILS_SERVE_STATIC_FILES=true
EnvironmentFile=/etc/nama_app.env
# Simpan output Puma (startup info) dan error sistem ke file terpisah
StandardOutput=append:/var/www/nama_app/log/puma.access.log
StandardError=append:/var/www/nama_app/log/puma.error.log
ExecStart=/bin/bash -lc 'bundle exec puma -C /var/www/nama_app/config/puma.rb'
Restart=always
KillMode=process
[Install]
WantedBy=multi-user.targetType=simple: tidak wajib ditulis; itu default untuk systemd versi baru — perilaku setara contoh lama “menjalankan satu proses”.
RAILS_LOG_TO_STDOUT=false: agar log aplikasi mengikuti log/production.log, bukan diserahkan ke journal lewat STDOUT. Sesuaikan dengan isi config/environments/production.rb: jika tidak ada guard RAILS_LOG_TO_STDOUT, baris Environment=... yang tidak relevan bisa dihapus.
RAILS_SERVE_STATIC_FILES=true: meminta Rails (Puma) melayani aset statis; umum bila tidak semua aset hanya lewat reverse proxy.
EnvironmentFile=/etc/nama_app.env: variabel tunggal per baris (KEY=nilai), sering memuat RAILS_ENV, database URL, secret key base, dsb. Berkas sebaiknya hanya dibaca root (chmod 600) dan isinya tidak di-commit.
StandardOutput / StandardError: stdout Puma (misalnya startup) dan stderr sistem dialihkan ke log/puma.access.log dan log/puma.error.log. pastikan direktori log/ ada dan dimiliki user yang sama dengan User=. Log request Rails yang “normal” tetap ke log/production.log selama RAILS_LOG_TO_STDOUT=false dan Puma/Rails memang menulis ke file.
ExecStart=... bash -lc '...': login shell memuat profile (misalnya rbenv/rvm/nvm), sehingga bundle dan Ruby terbaca walau PATH tidak di-hardcode di unit.
KillMode=process: sinyal berhenti mengarah ke proses utama; cocok bila worker Puma membutuhkan pola penghentian yang terkontrol. Bila butuh SIGTERM ke seluruh cgroup anak, tim lain memakai mixed (sesuaikan ke perilaku cluster Puma versi Anda).
WorkingDirectory: wajib mengarah ke root Rails agar relative path bundle exec dan asumsi Puma benar.
2. Berkas EnvironmentFile (ilustrasi)
Hanya contoh; jangan salin secret asli ke dokumentasi.
# /etc/nama_app.env
RAILS_ENV=production
# DATABASE_URL=...
# RAILS_MASTER_KEY=... atau key lain yang dipakai appSetelah mengubah .env atau unit: sudo systemctl daemon-reload bila perlu, lalu sudo systemctl restart rails-app.service.
3. Konfigurasi Puma (ringkas)
Di config/puma.rb pastikan bind selaras dengan Nginx: socket UNIX (unix://...) atau 127.0.0.1:port. Pastikan log/, tmp/pids/, tmp/sockets/ dapat ditulis user layanan.
4. Mengaktifkan dan mengelola layanan
sudo systemctl daemon-reload
sudo systemctl enable rails-app.service
sudo systemctl start rails-app.service
sudo systemctl status rails-app.service- Setelah deploy atau ganti gem:
sudo systemctl restart rails-app.service - Cek journal bila perlu (pesan systemd / kegagalan start):
sudo journalctl -u rails-app.service -e - Log startup Puma:
log/puma.access.logdanlog/puma.error.log; log aplikasi:log/production.log
5. Masalah yang sering muncul
- Permission denied pada
log/atau socket: samakan pemilik direktori denganUser=. bundle: command not found: perbaiki PATH (misalnya tetap memakaibash -lc) atau pasang wrapper penuh diExecStart.- Dobel logging: jika
RAILS_LOG_TO_STDOUTtidakfalsedi runtime, isi journal + file bisa tumpang-tindih — konsistenkan denganproduction.rbdanEnvironment=.
6. Nginx
Nginx meneruskan trafik ke bind Puma. Konfigurasi upstream / proxy_pass harus mengarah ke socket atau port yang sama dengan puma.rb.
Ringkasnya: user khusus (bukan root), WorkingDirectory, EnvironmentFile, variabel RAILS_*, StandardOutput/StandardError ke file Puma, dan bash -lc untuk bundle membentuk pola yang stabil di produksi. Samakan di seluruh baris: nama unit (.service), User/Group, root aplikasi, isi path di ExecStart dan di log, serta nama berkas di /etc/.