Skip to content

Commit 7cb1977

Browse files
Fix style and formatting issues in RabbitMQ GCP Learning Path
Co-authored-by: DougAnsonAustinTX <4755232+DougAnsonAustinTX@users.noreply.github.com>
1 parent 3bc19f3 commit 7cb1977

7 files changed

Lines changed: 35 additions & 53 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: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -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: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -62,10 +62,10 @@ 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

7171
### Enable and Start RabbitMQ Service
@@ -112,11 +112,9 @@ You should see an output similar to:
112112
```
113113

114114
### Access RabbitMQ Management UI
115-
Create a new RabbitMQ user for remote access
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.

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Create a durable topic exchange to route events based on routing keys.
4646
```
4747

4848
- Creates a durable topic exchange named events.
49-
- Routes messages using wildcard-based routing keys (e.g., order.*).
49+
- Routes messages using wildcard-based routing keys (for example, order.*).
5050
- Ensures the exchange survives broker restarts.
5151

5252
### Declare a Durable Queue
@@ -115,7 +115,7 @@ Create a Python worker file to process messages from a queue.
115115

116116
A **Python worker** was created to process messages from a RabbitMQ queue (jobs) using the pika library. The queue is durable, ensuring message persistence. The worker implements fair dispatch (prefetch_count=1) and manual acknowledgments to reliably process each job without loss. Messages were successfully published to the queue using rabbitmqadmin, and the worker consumed them as expected.
117117

118-
Using your favorite editor (example is using "edit" below...) create your "worker.py" file:
118+
Using your favorite editor (the example uses "edit") create your "worker.py" file:
119119

120120
```console
121121
edit worker.py
@@ -200,7 +200,7 @@ Publish another job:
200200
Worker started. Waiting for jobs...
201201
[Worker] Received job: {'job': 'hello1'}
202202
```
203-
Now press "CTRL-C" to exit the worker application.
203+
Press "CTRL-C" to exit the worker application.
204204

205205
## Use Case Validation
206206

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -260,15 +260,15 @@ WhatsApp Worker started. Waiting for messages...
260260
- Queue consumption is successful
261261
- Manual acknowledgments are applied
262262

263-
End-to-end message flow validated.
263+
This validates the end-to-end message flow.
264264

265265
### Verify Queue State
266266

267267
```console
268268
./rabbitmqadmin list queues name messages consumers
269269
```
270270

271-
Expected output should be similar to:
271+
Expected output is similar to:
272272

273273
```output
274274
+------------------------+----------+-----------+
@@ -281,7 +281,7 @@ Expected output should be similar to:
281281
+------------------------+----------+-----------+
282282
```
283283

284-
**This confirms that:**
284+
This confirms that:
285285

286286
- Messages were consumed successfully
287287
- One active consumer is connected

0 commit comments

Comments
 (0)