(0275) 2974 127
Cara install RabbitMQ dapat berbeda tergantung pada sistem operasi dan kebutuhan pengguna. RabbitMQ bisa dijalankan di Linux, Windows, maupun melalui Docker. Setiap metode memiliki kelebihan tersendiri, mulai dari instalasi langsung pada server hingga penggunaan container yang lebih praktis untuk pengembangan aplikasi.
Artikel ini membahas cara install RabbitMQ secara bertahap, mulai dari persiapan sistem, instalasi, mengaktifkan dashboard, hingga melakukan pengujian untuk memastikan layanan berjalan dengan baik.
RabbitMQ adalah perangkat lunak message broker open source yang digunakan untuk menerima, menyimpan sementara, dan meneruskan pesan dari satu aplikasi ke aplikasi lainnya. RabbitMQ umumnya menggunakan protokol AMQP (Advanced Message Queuing Protocol), yang memungkinkan aplikasi berkomunikasi melalui mekanisme pertukaran pesan.
Sebagai contoh, sebuah website toko online dapat menggunakan RabbitMQ untuk mengirim tugas pembuatan invoice, pengiriman email konfirmasi, atau pemrosesan pesanan ke layanan lain. Dengan pendekatan ini, aplikasi tidak harus menyelesaikan seluruh proses dalam satu permintaan. Pesan dapat dimasukkan ke dalam antrean (queue) dan diproses oleh worker ketika sumber daya tersedia.
RabbitMQ membutuhkan Erlang/OTP sebagai lingkungan runtime. Oleh karena itu, pemilihan versi RabbitMQ dan Erlang yang kompatibel merupakan salah satu hal penting sebelum melakukan instalasi.
Sebelum memulai instalasi RabbitMQ, ada beberapa hal yang perlu dipersiapkan agar proses berjalan lancar.
Sistem operasi yang didukung
Tentukan apakah RabbitMQ akan dijalankan di Ubuntu, Debian, Windows, macOS, atau lingkungan container.
Erlang/OTP yang kompatibel
Untuk instalasi langsung, pastikan versi Erlang sesuai dengan versi RabbitMQ yang akan digunakan. Jika menggunakan Docker image resmi RabbitMQ, runtime yang dibutuhkan sudah disertakan dalam image.
Akses administrator
Instalasi di Linux biasanya membutuhkan akses sudo, sedangkan Windows mungkin memerlukan izin administrator.
Koneksi internet
Koneksi diperlukan untuk mengunduh paket instalasi atau image Docker.
Port jaringan yang sesuai
Port AMQP secara default adalah 5672, sedangkan dashboard manajemen menggunakan 15672 ketika plugin management diaktifkan.
Untuk penggunaan produksi, pastikan server memiliki sumber daya yang memadai dan akses jaringan telah dibatasi sesuai kebutuhan. Jangan membuka dashboard manajemen atau port RabbitMQ ke internet tanpa pengamanan yang tepat.
Ubuntu dan Debian dapat digunakan untuk menjalankan RabbitMQ pada server. Agar mendapatkan versi yang sesuai, gunakan repositori resmi RabbitMQ dan pastikan versi Erlang/OTP kompatibel dengan RabbitMQ yang akan diinstal.
Buka terminal, lalu jalankan perintah berikut untuk memperbarui daftar paket dan sistem.
sudo apt update
sudo apt upgrade -y
Tambahkan repositori resmi RabbitMQ dan Erlang sesuai versi Ubuntu atau Debian yang digunakan. Ikuti petunjuk pada dokumentasi resmi instalasi RabbitMQ agar konfigurasi repositori dan kunci penandatanganan paket sesuai.
Pastikan repositori yang digunakan kompatibel dengan distribusi Linux agar tidak terjadi konflik dependensi.
Setelah repositori dikonfigurasi, perbarui daftar paket dan instal RabbitMQ menggunakan perintah berikut.
sudo apt update
sudo apt install rabbitmq-server -y
Aktifkan RabbitMQ agar berjalan otomatis saat server dinyalakan, sekaligus menjalankan layanannya sekarang.
sudo systemctl enable --now rabbitmq-server
Periksa status layanan dengan perintah berikut.
sudo systemctl status rabbitmq-server
Jika status menunjukkan active (running), RabbitMQ telah berjalan. Jika terjadi kesalahan, periksa status layanan dan log sistem untuk mengetahui penyebabnya.
Docker memudahkan instalasi RabbitMQ tanpa perlu memasang Erlang secara terpisah. Metode ini cocok untuk pengembangan aplikasi, pengujian, maupun deployment berbasis container.
Periksa instalasi Docker menggunakan perintah berikut:
docker --version
docker run hello-world
Jika Docker belum tersedia, instal terlebih dahulu sesuai petunjuk pada dokumentasi resmi Docker.
Jalankan perintah berikut untuk mengunduh dan menjalankan RabbitMQ beserta dashboard manajemennya.
docker run -d \
--name rabbitmq \
--hostname rabbitmq-node \
-p 5672:5672 \
-p 15672:15672 \
rabbitmq:4-management
Port 5672 digunakan untuk komunikasi aplikasi melalui AMQP, sedangkan port 15672 digunakan untuk mengakses dashboard RabbitMQ.
Pastikan container berjalan menggunakan perintah berikut:
docker ps
docker logs rabbitmq
Perintah pertama memeriksa status container, sedangkan perintah kedua menampilkan log untuk membantu mendeteksi kesalahan saat RabbitMQ dijalankan.
Buka browser dan akses http://localhost:15672 jika Docker berjalan pada komputer yang sama.
Pada konfigurasi default, username dan password awal adalah guest. Akun ini dibatasi untuk koneksi lokal, sehingga sebaiknya buat akun khusus jika RabbitMQ akan diakses dari perangkat lain.
Untuk menghentikan RabbitMQ, jalankan:
docker stop rabbitmq
Untuk menjalankannya kembali, gunakan:
docker start rabbitmq
Perlu diperhatikan bahwa data dapat hilang jika container dihapus tanpa penyimpanan persisten. Untuk penggunaan jangka panjang, gunakan volume Docker agar data RabbitMQ tetap tersimpan meskipun container dibuat ulang.
RabbitMQ dapat diinstal langsung di Windows tanpa Docker. Sebelum instalasi, pastikan Erlang/OTP sudah terpasang dan kompatibel dengan versi RabbitMQ yang digunakan.
Unduh Erlang/OTP melalui situs resmi RabbitMQ, lalu instal versi yang sesuai dengan RabbitMQ dan arsitektur Windows.
Unduh paket instalasi Windows melalui dokumentasi resmi RabbitMQ. Ikuti petunjuk instalasi dan pastikan RabbitMQ dapat mengenali Erlang yang telah dipasang.
Buka PowerShell, kemudian periksa status layanan menggunakan perintah:
Get-Service RabbitMQ
Jika layanan belum berjalan, buka menu Services, cari layanan RabbitMQ, lalu pilih Start.
Untuk mengelola RabbitMQ melalui browser, buka Command Prompt atau PowerShell pada direktori sbin instalasi RabbitMQ, kemudian jalankan:
rabbitmq-plugins.bat enable rabbitmq_management
Setelah plugin aktif, restart layanan jika diperlukan, lalu buka browser dan akses http://localhost:15672.
Login menggunakan akun RabbitMQ yang telah dikonfigurasi. Jika dashboard tidak dapat diakses, periksa status layanan, aktivasi plugin, dan konfigurasi akun.
RabbitMQ Management Plugin menyediakan antarmuka berbasis web untuk memantau antrean pesan, koneksi, exchange, consumer, dan aktivitas server. Plugin ini sangat membantu administrator maupun developer dalam mengelola RabbitMQ tanpa harus selalu menggunakan terminal.
Pada instalasi Linux, plugin dapat diaktifkan dengan perintah:
sudo rabbitmq-plugins enable rabbitmq_management
Setelah plugin diaktifkan, periksa statusnya menggunakan:
sudo rabbitmq-plugins list
Pastikan rabbitmq_management tercantum sebagai plugin aktif. Jika diperlukan, restart layanan RabbitMQ:
sudo systemctl restart rabbitmq-server
Selanjutnya, akses dashboard melalui browser dengan alamat:
http://localhost:15672
Jika RabbitMQ berjalan di server jarak jauh, gunakan alamat IP atau hostname server yang sesuai. Pastikan port 15672 hanya dapat diakses oleh pihak yang berwenang.
Untuk meningkatkan keamanan, buat akun khusus RabbitMQ agar akses dashboard dan aplikasi dapat dikelola dengan lebih baik.
Jalankan perintah berikut pada server Linux:
sudo rabbitmqctl add_user appuser 'PasswordKuat123!'
Ganti appuser dan PasswordKuat123! dengan username dan password yang kuat serta unik.
Berikan izin kepada pengguna untuk mengakses virtual host default (/) menggunakan perintah berikut:
sudo rabbitmqctl set_permissions -p / appuser ".*" ".*" ".*"
Perintah ini memberikan izin konfigurasi, penulisan, dan pembacaan secara luas. Untuk server produksi, sesuaikan izin dengan kebutuhan aplikasi agar akses tidak berlebihan.
Jika akun juga digunakan untuk mengakses dashboard, tambahkan tag manajemen:
sudo rabbitmqctl set_user_tags appuser management
Tag management memberikan akses ke antarmuka manajemen, sedangkan izin virtual host tetap perlu diatur secara terpisah.
Untuk memastikan akun berhasil dibuat, jalankan:
sudo rabbitmqctl list_users
Perintah tersebut menampilkan daftar pengguna beserta tag yang dimiliki. Setelah itu, gunakan kredensial yang telah dibuat untuk login ke dashboard atau menghubungkan aplikasi ke RabbitMQ.
Setelah instalasi selesai, lakukan pemeriksaan untuk memastikan RabbitMQ berjalan dan siap digunakan.
Pada Ubuntu atau Debian, jalankan perintah berikut:
sudo rabbitmq-diagnostics status
Perintah ini menampilkan informasi status node RabbitMQ, termasuk versi dan kondisi runtime. Jika berhasil, RabbitMQ dapat merespons pemeriksaan diagnostik.
Untuk melihat antrean pesan pada virtual host default, gunakan:
sudo rabbitmqctl list_queues
Jika belum ada antrean yang dibuat, hasilnya bisa kosong. Hal ini normal selama belum ada aplikasi atau administrator yang membuat queue.
Pada Linux, periksa port yang digunakan RabbitMQ dengan perintah:
sudo ss -lntp
Port 5672 digunakan untuk komunikasi AMQP, sedangkan 15672 digunakan untuk dashboard jika Management Plugin aktif.
Jika menggunakan Docker, periksa status container dan log melalui perintah berikut:
docker ps
docker logs rabbitmq
Jika layanan atau container berjalan normal dan tidak menunjukkan kesalahan, instalasi RabbitMQ dapat dilanjutkan ke tahap konfigurasi dan pengujian koneksi aplikasi.
RabbitMQ menggunakan beberapa port untuk komunikasi aplikasi, manajemen, dan clustering. Port yang tersedia bergantung pada plugin dan konfigurasi yang diaktifkan.
| Port | Fungsi |
|---|---|
5672 |
Komunikasi aplikasi menggunakan AMQP tanpa TLS. |
5671 |
Komunikasi AMQP menggunakan TLS jika dikonfigurasi. |
15672 |
Dashboard dan HTTP API Management Plugin. |
25672 |
Komunikasi antarnode dan CLI pada konfigurasi default tertentu. |
4369 |
Layanan penemuan node Erlang, yaitu EPMD. |
Tidak semua port harus dibuka ke internet. Untuk server produksi, izinkan hanya port yang benar-benar diperlukan dan batasi akses berdasarkan alamat IP, jaringan privat, atau mekanisme keamanan lain yang sesuai.
Setiap metode instalasi RabbitMQ memiliki karakteristik yang berbeda. Pemilihan metode sebaiknya disesuaikan dengan kebutuhan pengembangan maupun operasional server.
| Aspek | Ubuntu/Debian | Windows | Docker |
|---|---|---|---|
| Proses instalasi | Menggunakan paket dan repositori | Menggunakan installer serta Erlang | Menjalankan image container |
| Pengelolaan layanan | systemctl dan CLI RabbitMQ |
Windows Services dan CLI | Perintah docker |
| Dependensi Erlang | Perlu dipastikan sesuai | Perlu dipasang secara kompatibel | Sudah disertakan dalam image |
| Fleksibilitas | Cocok untuk server Linux | Cocok untuk lingkungan Windows | Mudah dibuat ulang dan dipindahkan |
| Pengelolaan data | Bergantung pada konfigurasi penyimpanan | Bergantung pada konfigurasi penyimpanan | Perlu memperhatikan volume persisten |
| Penggunaan umum | Server dan lingkungan produksi | Pengembangan di Windows | Pengembangan, pengujian, dan deployment berbasis container |
Untuk pemula yang ingin mencoba RabbitMQ dengan cepat, Docker dapat menjadi pilihan praktis. Jika RabbitMQ akan dijalankan sebagai layanan pada server Linux, instalasi langsung melalui repositori resmi memberikan integrasi yang lebih erat dengan sistem operasi.
Instalasi RabbitMQ dapat mengalami kendala akibat ketidakcocokan dependensi, konfigurasi jaringan, atau kesalahan pengaturan layanan. Berikut beberapa masalah umum beserta cara mengatasinya.
Masalah ini dapat disebabkan oleh versi Erlang/OTP yang tidak kompatibel atau kesalahan konfigurasi. Periksa status layanan dan log menggunakan perintah berikut:
sudo systemctl status rabbitmq-server
sudo journalctl -u rabbitmq-server -n 100 --no-pager
Periksa pesan kesalahan yang muncul dan pastikan versi Erlang sesuai dengan persyaratan RabbitMQ.
Dashboard tidak dapat diakses jika Management Plugin belum aktif, layanan berhenti, atau port belum dikonfigurasi dengan benar.
Periksa status plugin menggunakan perintah:
sudo rabbitmq-plugins list
Jika menggunakan Docker, periksa pemetaan port dengan:
docker port rabbitmq
Pastikan port 15672 tersedia dan aturan firewall mengizinkan akses dari jaringan yang diperlukan.
Kesalahan login dapat terjadi karena username atau password tidak sesuai atau akun guest digunakan dari koneksi jarak jauh. Periksa daftar pengguna dan gunakan akun khusus dengan kredensial yang benar.
Konflik port terjadi ketika port yang dibutuhkan RabbitMQ telah digunakan oleh layanan lain. Periksa port yang aktif pada Linux menggunakan:
sudo ss -lntp
Jika terjadi konflik saat menjalankan Docker, gunakan port host lain yang tersedia dan sesuaikan alamat koneksi aplikasi.
Pesan yang menumpuk dapat disebabkan oleh consumer yang tidak aktif, konfigurasi routing yang salah, atau worker yang mengalami gangguan. Periksa jumlah pesan dalam queue, status koneksi, serta log aplikasi. Pastikan producer mengirim pesan ke exchange dan routing key yang sesuai dengan konfigurasi antrean.
RabbitMQ yang sudah berhasil diinstal tetap perlu dikonfigurasi dengan baik agar aman dan stabil. Beberapa langkah berikut penting diterapkan, terutama jika layanan digunakan untuk aplikasi produksi.
Gunakan akun khusus
Buat username dan password yang unik untuk setiap aplikasi atau kebutuhan administrasi.
Batasi akses jaringan
Jangan membuka port AMQP dan dashboard manajemen ke publik tanpa alasan yang jelas.
Gunakan TLS jika diperlukan
Enkripsi koneksi untuk melindungi komunikasi antara aplikasi dan RabbitMQ, terutama pada jaringan yang tidak sepenuhnya tepercaya.
Atur hak akses minimum
Berikan izin sesuai kebutuhan pengguna terhadap virtual host, exchange, dan queue.
Pantau penggunaan sumber daya
Periksa kapasitas memori, ruang disk, jumlah koneksi, serta antrean yang terus bertambah.
Siapkan penyimpanan persisten dan backup
Pastikan data penting dan konfigurasi dapat dipulihkan sesuai kebutuhan operasional.
Kelola pembaruan versi
Gunakan versi yang masih didukung dan lakukan pengujian sebelum memperbarui RabbitMQ atau Erlang di lingkungan produksi.
Langkah-langkah tersebut membantu mengurangi risiko akses tidak sah, kehilangan data, dan gangguan layanan.
Cara install RabbitMQ dapat dilakukan melalui Ubuntu atau Debian, Windows, maupun Docker. Instalasi langsung di Linux cocok untuk menjalankan layanan pada server, Windows dapat digunakan untuk kebutuhan pengembangan, sedangkan Docker mempermudah proses instalasi dan pengujian tanpa harus memasang Erlang secara terpisah.
Setelah instalasi, pastikan layanan RabbitMQ berjalan, aktifkan Management Plugin jika membutuhkan dashboard, buat akun dengan hak akses yang sesuai, dan lakukan pengujian koneksi. Untuk penggunaan produksi, perhatikan kompatibilitas versi, keamanan jaringan, pemantauan sumber daya, serta penyimpanan data yang persisten.
Untuk memahami lebih banyak tentang server, hosting, cloud, keamanan siber, dan perkembangan teknologi digital, simak berbagai artikel informatif lainnya di Blog Hosteko.
Free Shipping Threshold dapat diterapkan dalam berbagai jenis bisnis e-commerce, mulai dari marketplace, toko online…
Perkembangan kecerdasan buatan atau Artificial Intelligence (AI) telah mengubah cara manusia bekerja, mengolah informasi, dan…
Free Shipping Threshold menjadi salah satu strategi pemasaran yang digunakan dalam bisnis e-commerce untuk mendorong…
Dalam pengelolaan server dan infrastruktur website, menjaga performa serta ketersediaan layanan menjadi hal yang sangat…
Di tengah banyaknya konten yang muncul di media sosial setiap hari, menarik perhatian audiens menjadi…
Menentukan batas minimum gratis ongkir atau Free Shipping Threshold tidak boleh dilakukan secara sembarangan. Penjual…