Membuat proyek baru di Ruby on Rails sering terasa membingungkan kalau belum tahu urutannya. Panduan ini membahas langkah setup proyek baru di Ruby on Rails, dari instalasi hingga siap dijalankan di server.
Menyiapkan Ruby dan Rails
Cek dulu apakah Ruby sudah terpasang dengan perintah ruby -v di terminal. Kalau belum ada, instal Ruby memakai rbenv atau rvm. Setelah Ruby siap, jalankan gem install rails dan pastikan versi Rails yang terpasang sesuai kebutuhan proyek.
Siapkan juga database. Rails mendukung SQLite secara default, tetapi PostgreSQL atau MySQL lebih cocok untuk proyek serius. Instal database yang kamu pilih dan pastikan service-nya berjalan.
Membuat Proyek Rails Baru
Buat proyek baru dengan perintah rails new nama_proyek. Ganti nama_proyek sesuai keinginanmu. Perintah ini membuat struktur direktori lengkap dan menginstal dependensi. Prosesnya bisa memakan waktu beberapa menit tergantung koneksi internet.
Untuk memakai database tertentu, tambahkan opsi -d postgresql atau -d mysql di belakang perintah, misalnya rails new proyekku -d postgresql.
Mengatur Konfigurasi Database
Buka file config/database.yml dan sesuaikan pengaturan koneksi database. Untuk PostgreSQL, isi username, password, dan host. Buat database dengan perintah rails db:create.
Kalau memakai SQLite, tidak ada konfigurasi tambahan karena Rails sudah menyiapkannya otomatis.
Menjalankan Server dan Melihat Hasilnya
Jalankan server dengan rails server atau rails s, lalu buka http://localhost:3000 di browser. Halaman selamat datang Rails berarti proyekmu sudah berjalan.
Coba juga buat scaffold sederhana dengan rails generate scaffold Post title:string body:text lalu jalankan rails db:migrate. Langkah ini memberi gambaran awal tentang cara kerja Rails.
Struktur Direktori dan File Penting
Kenali struktur direktori Rails agar tidak bingung saat mengembangkan proyek. Beberapa folder penting:
- app: kode aplikasi utama seperti model, view, dan controller.
- config: konfigurasi aplikasi, termasuk routing dan database.
- db: file migrasi dan skema database.
- public: aset statis seperti gambar dan file HTML.
- spec atau test: tempat menulis pengujian.
Routing menghubungkan URL dengan controller dan action. Untuk mempelajarinya lebih dalam, baca tips memahami routing di Ruby on Rails untuk pemula yang membahas konsep dasar dengan contoh praktis.
Menggunakan Git untuk Version Control
Rails menginisialisasi repositori Git otomatis saat membuat proyek baru, jadi kamu bisa langsung melakukan commit pertama. Pastikan file .gitignore mencakup file yang tidak perlu dilacak seperti log/, tmp/, dan .env.
Buat repositori di GitHub atau GitLab, lalu hubungkan dengan proyek lokal supaya kolaborasi dan backup kode lebih mudah.
Menambahkan Gem yang Dibutuhkan
Gem adalah library Ruby yang memperluas fungsionalitas aplikasi. Beberapa gem yang sering dipakai:
- devise untuk autentikasi pengguna.
- pundit untuk otorisasi.
- simple_form untuk merapikan form.
- rspec-rails untuk pengujian.
Tambahkan gem ke Gemfile lalu jalankan bundle install. Ikuti dokumentasi masing-masing gem untuk konfigurasi lebih lanjut.
Menyiapkan Aset dan Tampilan
Rails mengelola CSS, JavaScript, dan gambar lewat pipeline aset. Secara default Rails menyertakan Sprockets atau Webpacker tergantung versinya. Pastikan aset dikonfigurasi dengan benar agar tampilan aplikasi tidak berantakan.
Kalau perlu menulis JavaScript atau CSS tambahan, panduan tips praktis menulis kode PHP, JS, dan CSS untuk pemula bisa jadi referensi. Untuk proyek yang melibatkan form interaktif, pelajari cara membuat form validasi jQuery langkah demi langkah agar pengalaman pengguna lebih baik.
Melakukan Migrasi Database
Setelah membuat model atau mengubah skema, jalankan rails db:migrate. Migrasi memperbarui struktur database sesuai perubahanmu. Periksa file migrasi sebelum menjalankannya untuk menghindari kesalahan.
Untuk migrasi yang aman, baca tips migrasi database Rails tanpa bikin aplikasi down yang membahas strategi menghindari downtime.
Menguji Aplikasi secara Lokal
Sebelum deploy, uji aplikasi secara lokal. Jalankan rails test kalau kamu menulis tes, dan pastikan semua fitur berjalan sesuai harapan. Coba akses dari perangkat lain di jaringan yang sama untuk memastikan tidak ada masalah jaringan.
Agar aplikasi tetap responsif, ikuti tips meningkatkan kecepatan load aplikasi Rails.
Deploy ke Server Produksi
Deploy adalah langkah akhir dari setup proyek. Kamu bisa memakai layanan seperti Heroku atau menyiapkan server sendiri. Panduan lengkapnya ada di 9 langkah deploy aplikasi Rails ke server produksi. Pastikan environment variable, database, dan aset sudah dikonfigurasi dengan benar.
Setelah deploy, lakukan pengujian terakhir dan cek log server untuk memastikan tidak ada error. Proyek Rails-mu sudah online.
Panduan setup proyek baru di Ruby on Rails ini mencakup instalasi hingga deploy. Jangan ragu bereksperimen dengan fitur lain. Kalau butuh hiburan sejenak, kamu bisa nonton bareng gratis di tarkamlive.com yang menyediakan streaming olahraga seperti basket, sepakbola, dan UFC dengan host yang menghibur.
Pertanyaan yang Sering Diajukan
Apakah harus menggunakan PostgreSQL untuk proyek Rails?
Tidak wajib. SQLite cocok untuk pengembangan awal, tetapi PostgreSQL atau MySQL lebih disarankan untuk produksi karena skalabilitas dan fitur yang lebih lengkap.
Bagaimana cara mengatasi error saat menjalankan rails new?
Error umumnya disebabkan versi Ruby yang tidak kompatibel atau gem yang belum terinstal. Periksa pesan error, pastikan Ruby dan Rails versi terbaru, dan jalankan bundle install jika perlu.
Apakah perlu menggunakan Git sejak awal?
Sangat dianjurkan. Git membantu melacak perubahan dan memudahkan kolaborasi. Rails sudah menyiapkan repositori Git otomatis, jadi kamu tinggal commit.