Cara Install RabbitMQ dengan Mudah di Ubuntu, Windows, dan Docker

RabbitMQ merupakan salah satu message broker yang banyak digunakan untuk menghubungkan berbagai layanan dalam sebuah aplikasi. Teknologi ini membantu aplikasi mengirim, menerima, dan memproses pesan secara asynchronous tanpa harus membuat setiap komponen saling menunggu. Agar dapat digunakan dalam pengembangan aplikasi, RabbitMQ perlu diinstal dan dikonfigurasi sesuai dengan lingkungan yang digunakan.

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.

Apa Itu RabbitMQ?

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.

Persiapan Sebelum Install RabbitMQ

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.

Cara Install RabbitMQ di Ubuntu dan Debian

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.

Memperbarui Paket Sistem

Buka terminal, lalu jalankan perintah berikut untuk memperbarui daftar paket dan sistem.

sudo apt update
sudo apt upgrade -y

Menambahkan Repositori RabbitMQ

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.

Menginstal RabbitMQ

Setelah repositori dikonfigurasi, perbarui daftar paket dan instal RabbitMQ menggunakan perintah berikut.

sudo apt update
sudo apt install rabbitmq-server -y

Mengaktifkan dan Memeriksa Layanan

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.

Cara Install RabbitMQ Menggunakan Docker

Docker memudahkan instalasi RabbitMQ tanpa perlu memasang Erlang secara terpisah. Metode ini cocok untuk pengembangan aplikasi, pengujian, maupun deployment berbasis container.

Memastikan Docker Terinstal

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.

Menjalankan Container RabbitMQ

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.

Memeriksa Status Container

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.

Mengakses Dashboard RabbitMQ

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.

Menghentikan dan Menjalankan Kembali Container

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.

Cara Install RabbitMQ di Windows

RabbitMQ dapat diinstal langsung di Windows tanpa Docker. Sebelum instalasi, pastikan Erlang/OTP sudah terpasang dan kompatibel dengan versi RabbitMQ yang digunakan.

Menginstal Erlang/OTP

Unduh Erlang/OTP melalui situs resmi RabbitMQ, lalu instal versi yang sesuai dengan RabbitMQ dan arsitektur Windows.

Mengunduh dan Menginstal RabbitMQ

Unduh paket instalasi Windows melalui dokumentasi resmi RabbitMQ. Ikuti petunjuk instalasi dan pastikan RabbitMQ dapat mengenali Erlang yang telah dipasang.

Memeriksa Layanan RabbitMQ

Buka PowerShell, kemudian periksa status layanan menggunakan perintah:

Get-Service RabbitMQ

Jika layanan belum berjalan, buka menu Services, cari layanan RabbitMQ, lalu pilih Start.

Mengaktifkan Dashboard Management

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.

Cara Mengaktifkan RabbitMQ Management Plugin

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.

Cara Membuat User dan Password RabbitMQ

Untuk meningkatkan keamanan, buat akun khusus RabbitMQ agar akses dashboard dan aplikasi dapat dikelola dengan lebih baik.

Membuat User Baru

Jalankan perintah berikut pada server Linux:

sudo rabbitmqctl add_user appuser 'PasswordKuat123!'

Ganti appuser dan PasswordKuat123! dengan username dan password yang kuat serta unik.

Mengatur Hak Akses User

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.

Memeriksa Daftar User

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.

Cara Memverifikasi Instalasi RabbitMQ

Setelah instalasi selesai, lakukan pemeriksaan untuk memastikan RabbitMQ berjalan dan siap digunakan.

Memeriksa Status RabbitMQ

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.

Memeriksa Daftar Queue

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.

Memeriksa Port dan Container

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.

Port Penting pada RabbitMQ

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.

Perbedaan Instalasi RabbitMQ di Ubuntu, Windows, dan Docker

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.

Masalah yang Sering Terjadi Saat Install RabbitMQ

Instalasi RabbitMQ dapat mengalami kendala akibat ketidakcocokan dependensi, konfigurasi jaringan, atau kesalahan pengaturan layanan. Berikut beberapa masalah umum beserta cara mengatasinya.

RabbitMQ Tidak Bisa Dijalankan

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 RabbitMQ Tidak Bisa Dibuka

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.

Login RabbitMQ Ditolak

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.

Port RabbitMQ Sudah Digunakan

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 RabbitMQ Tidak Diproses

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.

Tips Keamanan Setelah Install RabbitMQ

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.

Kesimpulan

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.

5/5 - (3 votes)

Cara Install RabbitMQ dengan Mudah di Ubuntu, Windows, dan Docker