Skip to content

Commit fb6860f

Browse files
Merge pull request #1 from DougAnsonAustinTX/copilot/fix-rabbitmq-gcp-lp
Fix RabbitMQ GCP Learning Path style compliance
2 parents 6f7a0be + 14c39e9 commit fb6860f

7 files changed

Lines changed: 72 additions & 90 deletions

File tree

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Google Axion C4A is a family of Arm-based virtual machines built on Google’s c
1212

1313
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.
1414

15-
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.
15+
To learn more about Google Axion, see the [Introducing Google Axion Processors, Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu) blog.
1616

1717
## RabbitMQ
1818

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

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The purpose of this baseline is to confirm:
1515
- Queue operations (create, publish, consume)
1616
- CLI tooling functionality (`rabbitmqctl` and `rabbitmqadmin`)
1717

18-
### Check RabbitMQ Node Status
18+
### Check RabbitMQ node status
1919
Verify that the RabbitMQ node is operational and healthy.
2020

2121
```console
@@ -26,7 +26,7 @@ sudo rabbitmqctl status
2626
- Listeners are active on ports 5672 and 15672
2727
- Memory and disk space are within safe limits
2828

29-
### Verify Enabled Plugins
29+
### Verify enabled plugins
3030
Confirm that the RabbitMQ management plugins are enabled.
3131

3232
```console
@@ -42,7 +42,7 @@ You should see an output similar to:
4242
[ ] rabbitmq_stream_management 4.2.0
4343
```
4444

45-
### Validate RabbitMQ Listeners
45+
### Validate RabbitMQ listeners
4646
Ensure RabbitMQ is listening on the required ports.
4747

4848
```console
@@ -58,7 +58,7 @@ Interface: [::], port: 25672, protocol: clustering, purpose: inter-node and CLI
5858
Interface: [::], port: 5672, protocol: amqp, purpose: AMQP 0-9-1 and AMQP 1.0
5959
```
6060

61-
### Download RabbitMQ Admin CLI Tool
61+
### Download RabbitMQ Admin CLI tool
6262
Download the rabbitmqadmin CLI tool from the local management endpoint.
6363

6464
```console
@@ -69,7 +69,7 @@ curl -u guest:guest http://localhost:15672/cli/rabbitmqadmin -o rabbitmqadmin
6969
```console
7070
chmod +x rabbitmqadmin
7171
```
72-
### Validate Queue Creation
72+
### Validate queue creation
7373
Create a test queue to validate write operations.
7474

7575
```console
@@ -81,7 +81,7 @@ You should see an output similar to:
8181
queue declared
8282
```
8383

84-
### Publish a Test Message
84+
### Publish a test message
8585
Send a test message to the queue.
8686

8787
```console
@@ -93,7 +93,7 @@ You should see an output similar to:
9393
Message published
9494
```
9595

96-
### Consume Message From Queue
96+
### Consume message from queue
9797
Retrieve messages from the queue to verify read functionality.
9898

9999
```console
@@ -109,7 +109,7 @@ You should see an output similar to:
109109
+-------------+----------+---------------+-------------+---------------+------------------+------------+-------------+
110110
```
111111

112-
### Verify Queue State
112+
### Verify queue state
113113
Confirm that the queue is empty after consumption.
114114

115115
```console
@@ -126,7 +126,7 @@ You should see an output similar to:
126126
| testqueue | 1 |
127127
```
128128

129-
Baseline Validation Summary
129+
### Baseline validation summary
130130

131131
- RabbitMQ node is running and healthy
132132
- The management plugin is enabled and accessible

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

Lines changed: 10 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,35 +8,29 @@ layout: learningpathall
88

99
## Overview
1010

11-
In this section, you will learn how to create a Firewall Rule within Google Cloud Console. For this learning path, we need to expose TCP port 15672.
11+
In this section, you create a Firewall Rule within Google Cloud Console to expose TCP port 15672.
1212

1313
{{% notice Note %}}
1414
For support on GCP setup, see the Learning Path [Getting started with Google Cloud Platform](https://learn.arm.com/learning-paths/servers-and-cloud-computing/csp/google/).
1515
{{% /notice %}}
1616

1717
## Create a Firewall Rule in GCP
1818

19-
For this learning path, we need to expose TCP port 15672. To accomplish this, we first need to create a firewall rule.
20-
- Navigate to the [Google Cloud Console](https://console.cloud.google.com/).
21-
- Go to **VPC Network > Firewall** and press **Create firewall rule**.
19+
To expose TCP port 15672, create a firewall rule.
20+
21+
Navigate to the [Google Cloud Console](https://console.cloud.google.com/), go to **VPC Network > Firewall**, and select **Create firewall rule**.
2222

2323
![Create a firewall rule](images/firewall-rule.png "Create a firewall rule")
2424

25-
- Next, we create the firewall rule that will expose TCP port 15672 for our learning path.
26-
- Set the "Name" of the new rule to "allow-tcp-15672"
27-
- Select your network that you intend to bind to your VM (default is "autoscaling-net" but your organization might have others that you need to use)
28-
- Direction of traffic should be set to "Ingress"
29-
- Allow on match should be set to "Allow" and the "Targets" should be set to "Specified target tags".
30-
- Enter "allow-tcp-15672" to the "Target tags" text field
31-
- Set the "Source IPv4 ranges" text value to "0.0.0.0/0"
25+
Next, create the firewall rule that exposes TCP port 15672.
26+
Set the **Name** of the new rule to "allow-tcp-15672". Select your network that you intend to bind to your VM (default is "autoscaling-net" but your organization might have others).
27+
28+
Set **Direction of traffic** to "Ingress". Set **Allow on match** to "Allow" and **Targets** to "Specified target tags". Enter "allow-tcp-15672" in the **Target tags** text field. Set **Source IPv4 ranges** to "0.0.0.0/0".
3229

3330
![Create a firewall rule](images/network-rule.png "Creating the TCP/15672 firewall rule")
3431

35-
- Lastly, we select "Specified protocols and ports" under the "Protocols and ports" section
36-
- Select the "TCP" checkbox
37-
- Enter "15672" in the "Ports" text field
38-
- Press "Create"
32+
Finally, select **Specified protocols and ports** under the **Protocols and ports** section. Select the **TCP** checkbox, enter "15672" in the **Ports** text field, and select **Create**.
3933

4034
![Specifying the TCP port to expose](images/network-port.png "Specifying the TCP port to expose")
4135

42-
Our network firewall rule is now created so we can continue with the VM creation!
36+
The network firewall rule is now created and you can continue with the VM creation.

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

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ layout: learningpathall
99
## Install RabbitMQ on GCP SUSE Arm64 VM
1010
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**.
1111

12-
RabbitMQ requires Erlang to be installed before setting up the server.
12+
RabbitMQ needs Erlang to be installed before setting up the server.
1313

1414

1515
### Prerequisites
@@ -18,14 +18,14 @@ RabbitMQ requires Erlang to be installed before setting up the server.
1818
- Root or sudo privileges
1919
- Outbound internet access
2020

21-
### Refresh System Repositories
21+
### Refresh system repositories
2222
This step updates the system’s package list so the operating system knows about the latest software available from its repositories.
2323

2424
```console
2525
sudo zypper refresh
2626
```
2727

28-
### Install Required System Utilities
28+
### Install required system utilities
2929
You can install the basic tools needed to download and manage packages.
3030

3131
```console
@@ -40,7 +40,7 @@ wget https://github.com/rabbitmq/erlang-rpm/releases/download/v26.2.5/erlang-26.
4040
sudo rpm -Uvh erlang-26.2.5-1.el8.aarch64.rpm
4141
```
4242

43-
### Verify Erlang Installation
43+
### Verify Erlang installation
4444
Confirm that Erlang is installed correctly.
4545

4646
```console
@@ -62,20 +62,20 @@ sudo rpm -Uvh rabbitmq-server-4.2.0-1.el8.noarch.rpm
6262
```
6363

6464
{{% notice Note %}}
65-
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.
65+
RabbitMQ version 3.11.0 introduced significant performance enhancements for Arm-based architectures. This version needs 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.
6666
You can view [this release note](https://github.com/rabbitmq/rabbitmq-server/blob/main/release-notes/3.11.0.md)
6767

68-
The [Arm Ecosystem Dashboard](https://developer.arm.com/ecosystem-dashboard/) recommends RabbitMQ version 3.11.0, the minimum recommended on the Arm platforms.
68+
The [Arm Ecosystem Dashboard](https://developer.arm.com/ecosystem-dashboard/) recommends RabbitMQ version 3.11.0, the minimum recommended on Arm platforms.
6969
{{% /notice %}}
7070

71-
### Enable and Start RabbitMQ Service
71+
### Enable and start RabbitMQ service
7272
Enable RabbitMQ to start automatically on boot and start the service immediately.
7373

7474
```console
7575
sudo systemctl enable rabbitmq-server --now
7676
```
7777

78-
### Verify RabbitMQ Service Status
78+
### Verify RabbitMQ service status
7979
Check the status of the RabbitMQ service.
8080

8181
```console
@@ -84,7 +84,7 @@ sudo systemctl status rabbitmq-server
8484

8585
The service should be in an active (running) state.
8686

87-
### Enable RabbitMQ Management Plugin
87+
### Enable RabbitMQ management plugin
8888
Enable the RabbitMQ management plugin to access the web-based dashboard.
8989

9090
```console
@@ -98,7 +98,7 @@ Restart RabbitMQ to apply plugin changes.
9898
sudo systemctl restart rabbitmq-server
9999
```
100100

101-
### Verify RabbitMQ Version
101+
### Verify RabbitMQ version
102102
Confirm the installed RabbitMQ version.
103103

104104
```console
@@ -111,12 +111,10 @@ You should see an output similar to:
111111
4.2.0
112112
```
113113

114-
### Access RabbitMQ Management UI
115-
Create a new RabbitMQ user for remote access
114+
### Access RabbitMQ management UI
115+
Create a new RabbitMQ user for remote access.
116116

117-
- Create a new `admin` user
118-
119-
**Run these commands on the VM:**
117+
Create a new `admin` user by running these commands on the VM:
120118

121119
```console
122120
sudo rabbitmqctl add_user admin StrongPassword123
@@ -126,15 +124,15 @@ sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
126124

127125
**Log in to Management UI**
128126

129-
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 and credentials in the address bar:
127+
Now, test it from outside the VM. Open a web browser on your local machine (Chrome, Firefox, Edge, etc.) and enter the following URL and credentials in the address bar:
130128

131129
- **URL**: http://<VM_IP>:15672
132130
- **Username**: admin
133131
- **Password**: StrongPassword123
134132

135133
Replace `<VM_IP>` with the public IP of your GCP VM.
136134

137-
If everything is set up correctly, you will see a RabbitMQ login page in your browser. It looks like this:
135+
If everything is configured correctly, you see a RabbitMQ login page in your browser that looks like this:
138136

139137
![RabbitMQ page alt-text#center](images/rabbitmq.png "Figure 1: RabbitMQ Login page")
140138

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

Lines changed: 11 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -8,42 +8,32 @@ layout: learningpathall
88

99
## Overview
1010

11-
In this section, you will learn how to provision a Google Axion C4A Arm virtual machine on Google Cloud Platform (GCP) using the `c4a-standard-4` (4 vCPUs, 16 GB memory) machine type in the Google Cloud Console.
11+
In this section, you provision a Google Axion C4A Arm virtual machine on Google Cloud Platform (GCP) using the `c4a-standard-4` (4 vCPUs, 16 GB memory) machine type in the Google Cloud Console.
1212

1313
{{% notice Note %}}
1414
For support on GCP setup, see the Learning Path [Getting started with Google Cloud Platform](https://learn.arm.com/learning-paths/servers-and-cloud-computing/csp/google/).
1515
{{% /notice %}}
1616

1717
## Provision a Google Axion C4A Arm VM in Google Cloud Console
1818

19-
To create a virtual machine based on the C4A instance type:
20-
- Navigate to the [Google Cloud Console](https://console.cloud.google.com/).
21-
- Go to **Compute Engine > VM Instances** and select **Create Instance**.
22-
- Under **Machine configuration**:
23-
- Populate fields such as **Instance name**, **Region**, and **Zone**.
24-
- Set **Series** to `C4A`.
25-
- Select `c4a-standard-4` for machine type.
19+
To create a virtual machine based on the C4A instance type, navigate to the [Google Cloud Console](https://console.cloud.google.com/) and go to **Compute Engine > VM Instances**. Select **Create Instance**.
20+
21+
Under **Machine configuration**, populate fields such as **Instance name**, **Region**, and **Zone**. Set **Series** to `C4A` and select `c4a-standard-4` for machine type.
2622

2723
![Create a Google Axion C4A Arm virtual machine in the Google Cloud Console with c4a-standard-4 selected alt-text#center](images/gcp-vm.png "Creating a Google Axion C4A Arm virtual machine in Google Cloud Console")
2824

25+
Under **OS and Storage**, select **Change**, then choose an Arm64-based OS image. For this Learning Path, use **SUSE Linux Enterprise Server**. Select "Pay As You Go" for the license type and select **Select**.
2926

30-
- Under **OS and Storage**, select **Change**, then choose an Arm64-based OS image. For this Learning Path, use **SUSE Linux Enterprise Server**.
31-
- If using use **SUSE Linux Enterprise Server**. Select "Pay As You Go" for the license type.
32-
- Once appropriately selected, please Click **Select**.
33-
- Under **Networking**, enable **Allow HTTP traffic**.
34-
- Also under **Networking**, in the "Network tags" text field add "allow-tcp-15672" as an additional tag
27+
Under **Networking**, enable **Allow HTTP traffic** and add "allow-tcp-15672" as a network tag in the **Network tags** text field.
3528

36-
![Adding the TCP/15672 firewall rule to our VM](images/network-config.png "Adding the TCP/15672 firewall rule to our VM")
29+
![Adding the TCP/15672 firewall rule to the VM](images/network-config.png "Adding the TCP/15672 firewall rule to the VM")
3730

38-
- Click **Create** to launch the instance.
39-
- Once created, you should see a "SSH" option to the right in your list of VM instances. You should also see the public IP address for your VM.
40-
- Save off the public IP address for your VM as you will need this in the next step.
41-
- Click on this to launch a SSH shell into your VM instance:
31+
Select **Create** to launch the instance. Once created, you see an **SSH** option and the public IP address for your VM in the list of VM instances. Save the public IP address as you need it in the next step. Select the **SSH** option to launch an SSH shell into your VM instance.
4232

43-
![Invoke a SSH session via your browser alt-text#center](images/gcp-pubip-ssh.png "Invoke a SSH session into your running VM instance")
33+
![Invoke an SSH session via your browser alt-text#center](images/gcp-pubip-ssh.png "Invoke an SSH session into your running VM instance")
4434

45-
- A window from your browser should come up and you should now see a shell into your VM instance:
35+
A window opens from your browser and you see a shell into your VM instance.
4636

4737
![Terminal Shell in your VM instance alt-text#center](images/gcp-shell.png "Terminal shell in your VM instance")
4838

49-
Next, let's install RabbitMQ!
39+
Next, install RabbitMQ.

0 commit comments

Comments
 (0)