Merge pull request #2641 from odidev/rabbitmq_LP

Deploy RabbitMQ on Google Cloud C4A (Arm-based Axion VMs)

Author: jasonrandrews

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/_index.md

@@ -0,0 +1,60 @@
+---
+title: Deploy RabbitMQ on Google Cloud C4A (Arm-based Axion VMs)
+
+minutes_to_complete: 30
+
+who_is_this_for: This is an introductory topic for software engineers and platform engineers migrating messaging and event-driven workloads from x86_64 to Arm-based servers, specifically on Google Cloud C4A virtual machines powered by Axion processors.
+
+learning_objectives:
+  - Provision an Arm-based SUSE SLES virtual machine on Google Cloud (C4A with Axion processors)
+  - Install and configure RabbitMQ on a SUSE Arm64 (C4A) instance
+  - Validate RabbitMQ deployment using baseline messaging tests
+  - Implement real-world RabbitMQ use cases such as event-driven processing and notification pipelines
+
+prerequisites:
+  - A [Google Cloud Platform (GCP)](https://cloud.google.com/free) account with billing enabled
+  - Basic understanding of message queues and messaging concepts (publishers, consumers)
+  - Familiarity with Linux command-line operations
+
+author: Pareena Verma
+
+##### Tags
+skilllevels: Introductory
+subjects: Databases
+cloud_service_providers: Google Cloud
+
+armips:
+  - Neoverse
+
+tools_software_languages:
+  - RabbitMQ
+  - Erlang
+  - Python
+  - pika
+
+operatingsystems:
+  - Linux
+
+# ================================================================================
+#       FIXED, DO NOT MODIFY
+# ================================================================================
+further_reading:
+  - resource:
+      title: Google Cloud documentation
+      link: https://cloud.google.com/docs
+      type: documentation
+
+  - resource:
+      title: RabbitMQ documentation
+      link: https://www.rabbitmq.com/documentation.html 
+      type: documentation
+
+  - resource:
+      title: RabbitMQ Tutorials
+      link: https://www.rabbitmq.com/getstarted.html
+      type: documentation
+
+weight: 1
+layout: "learningpathall"
+learning_path_main_page: "yes"
+---

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/_next-steps.md

@@ -0,0 +1,8 @@
+---
+# ================================================================================
+#       FIXED, DO NOT MODIFY THIS FILE
+# ================================================================================
+weight: 21                  # Set to always be larger than the content in this path to be at the end of the navigation.
+title: "Next Steps"         # Always the same, html page title.
+layout: "learningpathall"   # All files under learning paths have this same wrapper for Hugo processing.
+---

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/background.md

@@ -0,0 +1,25 @@
+---
+title: Getting started with RabbitMQ on Google Axion C4A (Arm Neoverse-V2)
+
+weight: 2
+
+layout: "learningpathall"
+---
+
+## Google Axion C4A Arm instances in Google Cloud
+
+Google Axion C4A is a family of Arm-based virtual machines built on Google’s custom Axion CPU, which is based on Arm Neoverse-V2 cores. Designed for high-performance and energy-efficient computing, these virtual machines offer strong performance for modern cloud workloads such as CI/CD pipelines, microservices, media processing, and general-purpose applications.
+
+The C4A series provides a cost-effective alternative to x86 virtual machines while leveraging the scalability and performance benefits of the Arm architecture in Google Cloud.
+
+To learn more about Google Axion, refer to the [Introducing Google Axion Processors, our new Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu) blog.
+
+## RabbitMQ
+
+RabbitMQ is an open-source **message broker** that enables applications to communicate asynchronously using messaging patterns such as queues, publish/subscribe, and routing. It acts as an intermediary that reliably receives, stores, and forwards messages between producers and consumers.
+
+RabbitMQ helps decouple application components, improve scalability, and increase fault tolerance by ensuring messages are not lost and can be processed independently. It supports multiple messaging protocols, including AMQP, and provides features such as message durability, acknowledgments, routing via exchanges, and flexible delivery guarantees.
+
+RabbitMQ is widely used for **event-driven architectures**, **background job processing**, **microservices communication**, and **notification systems**. It integrates easily with many programming languages and platforms.
+
+Learn more from the [RabbitMQ official website](https://www.rabbitmq.com/) and the [official documentation](https://www.rabbitmq.com/documentation.html).

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/baseline.md

@@ -0,0 +1,138 @@
+---
+title: RabbitMQ Baseline Testing on Google Axion C4A Arm Virtual Machine
+weight: 5
+
+### FIXED, DO NOT MODIFY
+layout: learningpathall
+---
+
+## RabbitMQ Baseline Validation on GCP SUSE Arm64 VM
+This document defines a **baseline validation procedure** for RabbitMQ installed on a **Google Cloud SUSE Linux Arm64 virtual machine**.  
+The purpose of this baseline is to confirm:
+
+- RabbitMQ service health
+- Management plugin availability
+- Queue operations (create, publish, consume)
+- CLI tooling functionality (`rabbitmqctl` and `rabbitmqadmin`)
+
+### Check RabbitMQ Node Status
+Verify that the RabbitMQ node is operational and healthy.
+
+```console
+sudo rabbitmqctl status
+```
+- Node status reports RabbitMQ is running
+- No active alarms
+- Listeners are active on ports 5672 and 15672
+- Memory and disk space are within safe limits
+
+### Verify Enabled Plugins
+Confirm that the RabbitMQ management plugins are enabled.
+
+```console
+sudo rabbitmq-plugins list | grep management
+```
+
+You should see an output similar to:
+```output
+[  ] rabbitmq_federation_management          4.2.0
+[E*] rabbitmq_management                     4.2.0
+[e*] rabbitmq_management_agent               4.2.0
+[  ] rabbitmq_shovel_management              4.2.0
+[  ] rabbitmq_stream_management              4.2.0
+```
+
+### Validate RabbitMQ Listeners
+Ensure RabbitMQ is listening on the required ports.
+
+```console
+sudo rabbitmqctl status | grep -A5 Listeners
+```
+
+You should see an output similar to:
+```output
+Listeners
+
+Interface: [::], port: 15672, protocol: http, purpose: HTTP API
+Interface: [::], port: 25672, protocol: clustering, purpose: inter-node and CLI tool communication
+Interface: [::], port: 5672, protocol: amqp, purpose: AMQP 0-9-1 and AMQP 1.0
+```
+
+### Download RabbitMQ Admin CLI Tool
+Download the rabbitmqadmin CLI tool from the local management endpoint.
+
+```console
+curl -u guest:guest http://localhost:15672/cli/rabbitmqadmin -o rabbitmqadmin
+```
+**Make the tool executable:**
+
+```console
+chmod +x rabbitmqadmin
+```
+### Validate Queue Creation
+Create a test queue to validate write operations.
+
+```console
+./rabbitmqadmin declare queue name=testqueue durable=false
+```
+
+You should see an output similar to:
+```output
+queue declared
+```
+
+### Publish a Test Message
+Send a test message to the queue.
+
+```console
+./rabbitmqadmin publish exchange=amq.default routing_key=testqueue payload="hello world"
+```
+
+You should see an output similar to:
+```output
+Message published
+```
+
+### Consume Message From Queue
+Retrieve messages from the queue to verify read functionality.
+
+```console
+./rabbitmqadmin get queue=testqueue
+```
+
+You should see an output similar to:
+```output
++-------------+----------+---------------+-------------+---------------+------------------+------------+-------------+
+| routing_key | exchange | message_count |   payload   | payload_bytes | payload_encoding | properties | redelivered |
++-------------+----------+---------------+-------------+---------------+------------------+------------+-------------+
+| testqueue   |          | 0             | hello world | 11            | string           |            | False       |
++-------------+----------+---------------+-------------+---------------+------------------+------------+-------------+
+```
+
+### Verify Queue State
+Confirm that the queue is empty after consumption.
+
+```console
+./rabbitmqadmin list queues name messages
+```
+
+You should see an output similar to:
+```output
++--------------+----------+
+|     name     | messages |
++--------------+----------+
+| jobs         | 0        |
+| order.events | 1        |
+| testqueue    | 1        |
+```
+
+Baseline Validation Summary
+
+- RabbitMQ node is running and healthy
+- The management plugin is enabled and accessible
+- Queue creation is successful
+- Message publishing works as expected
+- Message consumption functions correctly
+- CLI tools operate without error
+
+This confirms a successful baseline validation of RabbitMQ on a GCP SUSE Arm64 virtual machine.

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/images/gcp-vm.png

@@ -0,0 +1,144 @@
+---
+title: Install RabbitMQ
+weight: 4
+
+### FIXED, DO NOT MODIFY
+layout: learningpathall
+---
+
+## Install RabbitMQ on GCP SUSE Arm64 VM
+This guide describes a **step-by-step installation of RabbitMQ** on a **Google Cloud Platform SUSE Linux Arm64 virtual machine**, using **RPM packages** for both **Erlang** and **RabbitMQ Server**.
+
+RabbitMQ requires Erlang to be installed before setting up the server.
+
+
+### Prerequisites
+
+- GCP SUSE Linux Enterprise Server (Arm64)
+- Root or sudo privileges
+- Outbound internet access
+
+### Refresh System Repositories
+This step updates the system’s package list so the operating system knows about the latest software available from its repositories.
+
+```console
+sudo zypper refresh
+```
+
+### Install Required System Utilities
+You can install the basic tools needed to download and manage packages.
+
+```console
+sudo zypper install -y curl wget gnupg tar socat logrotate
+```
+
+### Download Erlang RPM (Arm64)
+RabbitMQ depends on Erlang. Download the Erlang RPM compatible with the Arm64 architecture.
+
+```console
+wget https://github.com/rabbitmq/erlang-rpm/releases/download/v26.2.5/erlang-26.2.5-1.el8.aarch64.rpm
+sudo rpm -Uvh erlang-26.2.5-1.el8.aarch64.rpm
+```
+
+### Verify Erlang Installation
+Confirm that Erlang is installed correctly.
+
+```console
+erl -eval 'io:format("~s~n", [erlang:system_info(system_version)]), halt().' -noshell
+```
+
+You should see an output similar to:
+
+```output
+Erlang/OTP 26 [erts-14.2.5] [source] [64-bit] [smp:4:4] [ds:4:4:10] [async-threads:1] [jit]
+```
+
+### Download RabbitMQ Server RPM
+Download the RabbitMQ Server RPM package.
+
+```console
+wget https://github.com/rabbitmq/rabbitmq-server/releases/download/v4.2.0/rabbitmq-server-4.2.0-1.el8.noarch.rpm
+sudo rpm -Uvh rabbitmq-server-4.2.0-1.el8.noarch.rpm
+```
+
+{{% notice Note %}}
+RabbitMQ version 3.11.0 introduced significant performance enhancements for Arm-based architectures. This version requires Erlang 25.0 or later, which brings Just-In-Time (JIT) compilation and modern flame graph profiling tooling to both x86 and ARM64 CPUs. These features result in improved performance on ARM64 architectures.
+You can view [this release note](https://github.com/rabbitmq/rabbitmq-server/blob/main/release-notes/3.11.0.md)
+
+The [Arm Ecosystem Dashboard](https://developer.arm.com/ecosystem-dashboard/) recommends RabbitMQ version 3.11.0, the minimum recommended on the Arm platforms.
+{{% /notice %}}
+
+### Enable and Start RabbitMQ Service
+Enable RabbitMQ to start automatically on boot and start the service immediately.
+
+```console
+sudo systemctl enable rabbitmq-server --now
+```
+
+### Verify RabbitMQ Service Status
+Check the status of the RabbitMQ service.
+
+```console
+sudo systemctl status rabbitmq-server
+```
+
+The service should be in an active (running) state.
+
+### Enable RabbitMQ Management Plugin
+Enable the RabbitMQ management plugin to access the web-based dashboard.
+
+```console
+sudo rabbitmq-plugins enable rabbitmq_management
+```
+
+### Restart RabbitMQ
+Restart RabbitMQ to apply plugin changes.
+
+```console
+sudo systemctl restart rabbitmq-server
+```
+
+### Verify RabbitMQ Version
+Confirm the installed RabbitMQ version.
+
+```console
+sudo rabbitmqctl version
+```
+
+You should see an output similar to:
+
+```output
+4.2.0
+```
+
+### Access RabbitMQ Management UI
+Create a new RabbitMQ user for remote access
+
+- Create a new `admin` user
+
+**Run these commands on the VM:**
+
+```console
+sudo rabbitmqctl add_user admin StrongPassword123
+sudo rabbitmqctl set_user_tags admin administrator
+sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
+```
+
+**Log in to Management UI**
+
+- **URL**: http://<VM_IP>:15672
+- **Username**: admin
+- **Password**: StrongPassword123
+
+This is the production-safe approach.
+
+Now, let’s test it from outside the VM. Open a web browser on your local machine (Chrome, Firefox, Edge, etc.) and enter the following URL in the address bar:
+
+```console
+[http://<YOUR_VM_PUBLIC_IP>/info.php](http://<VM_IP>:15672)
+```
+- Replace `<VM_IP>` with the public IP of your GCP VM.
+
+If everything is set up correctly, you will see a RabbitMQ login page in your browser. It looks like this:
+
+![RabbitMQ page alt-text#center](images/rabbitmq.png "Figure 1: RabbitMQ Login page")