Skip to content

Commit d04e121

Browse files
Merge pull request #2557 from DougAnsonAustinTX/rust_LP_review
rust_LP_review: minor updates and draft mode setting
2 parents dc10c85 + 02a51d5 commit d04e121

File tree

6 files changed

+33
-14
lines changed

6 files changed

+33
-14
lines changed

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
11
---
22
title: Deploy Rust on Google Cloud C4A (Arm-based Axion VMs)
33

4+
draft: true
5+
cascade:
6+
draft: true
7+
48
minutes_to_complete: 30
59

610
who_is_this_for: This learning path is intended for software developers deploying and optimizing Rust workloads on Linux/Arm64 environments, specifically using Google Cloud C4A virtual machines powered by Axion processors.

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,12 @@ rustc --version
1717
cargo --version
1818
```
1919

20+
You should see an output similar to:
21+
```output
22+
rustc 1.91.0 (f8297e351 2025-10-28)
23+
cargo 1.91.0 (ea2d97820 2025-10-10)
24+
```
25+
2026
### Create a Sample Rust Program
2127
Create and build a simple “Hello, World” application to ensure everything is functioning properly:
2228

content/learning-paths/servers-and-cloud-computing/rust-on-gcp/benchmarking.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,12 @@ rustc --version
1818
cargo --version
1919
```
2020

21+
You should see an output similar to:
22+
```output
23+
rustc 1.91.0 (f8297e351 2025-10-28)
24+
cargo 1.91.0 (ea2d97820 2025-10-10)
25+
```
26+
2127
### Create a New Rust Project
2228
Create a new Rust project for benchmarking:
2329

@@ -26,7 +32,7 @@ cargo new rust-benchmark
2632
cd rust-benchmark
2733
```
2834
### Add Criterion Benchmarking Dependency
29-
**Criterion** is the officially recommended benchmarking crate for Rust. Add it to your project by editing the `Cargo.toml` file located inside your project root directory (for example, rust-benchmark/Cargo.toml):
35+
**Criterion** is the officially recommended benchmarking crate for Rust. Add it to your project by editing the `Cargo.toml` file located inside your project root directory using your favorite editor (location example: rust-benchmark/Cargo.toml). Replace your "[dependencies]" tag within your file with this content, then save the file:
3036

3137
```toml
3238
[dependencies]
@@ -39,11 +45,11 @@ harness = false
3945
This enables Criterion for high-precision benchmarking.
4046

4147
### Create the Benchmark File
42-
Create a new benchmark file inside the `benches/` directory:
48+
Create a new benchmark file inside the `benches/` directory using your favorite editor ("edit" used in the example below):
4349

4450
```console
4551
mkdir benches
46-
vi benches/my_benchmark.rs
52+
edit benches/my_benchmark.rs
4753
```
4854
Benchmark files in this directory are automatically detected by Cargo.
4955

@@ -96,22 +102,13 @@ Found 1 outliers among 100 measurements (1.00%)
96102
- **Plotting Backend:** Used `plotters` since Gnuplot was not found.
97103
- The results show **consistent performance** with only slight variation across 100 measurements.
98104

99-
### Benchmark summary on x86_64
100-
To compare the benchmark results, the following results were collected by running the same benchmark on a `x86 - c4-standard-4` (4 vCPUs, 15 GB Memory) x86_64 VM in GCP, running SUSE:
101-
102-
| **Benchmark** | **Average Time (µs)** | **Min (µs)** | **Max (µs)** | **Outliers (%)** | **Remarks** |
103-
|--------------------|----------------------:|--------------:|--------------:|-----------------:|----------------------------------|
104-
| **fibonacci 20** | 19.152 | 19.100 | 19.205 | 6.00% | Minor outliers, stable overall. |
105-
106-
### Benchmark summary on Arm64
105+
### Benchmark summary
107106
Results from the earlier run on the `c4a-standard-4` (4 vCPU, 16 GB memory) Arm64 VM in GCP (SUSE):
108107

109108
| **Benchmark** | **Average Time (µs)** | **Min (µs)** | **Max (µs)** | **Outliers (%)** | **Remarks** |
110109
|--------------------|----------------------:|--------------:|--------------:|-----------------:|----------------------------------|
111110
| **fibonacci 20** | 12.028 | 12.026 | 12.030 | 1.00% | Very stable performance, minimal variation. |
112111

113-
### Rust benchmarking comparison on Arm64 and x86_64
114-
115112
- The **Fibonacci (n=20)** benchmark demonstrated **consistent performance** with minimal deviation.
116113
- **Average execution time** was around **12.028 µs**, indicating efficient CPU computation on **Arm64**.
117114
- Only **1% outliers** were detected, showing **high stability** and **repeatability** of results.
22.3 KB
Loading
12.5 KB
Loading

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

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,18 @@ To create a virtual machine based on the C4A instance type:
2626

2727
![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")
2828

29-
- Under **OS and Storage**, select **Change**, then choose an Arm64-based OS image. For this Learning Path, use **SUSE Linux Enterprise Server**. Pick the preferred version for your Operating System. Ensure you select the **Arm image** variant. Click **Select**.
29+
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**.
3033
- Under **Networking**, enable **Allow HTTP traffic**.
3134
- Click **Create** to launch the instance.
35+
- Once created, you should see a "SSH" option to the right in your list of VM instances. Click on this to launch a SSH shell into your VM instance:
36+
37+
![Invoke a SSH session via your browser alt-text#center](images/gcp-ssh.png "Invoke a SSH session into your running VM instance")
38+
39+
- A window from your browser should come up and you should now see a shell into your VM instance:
40+
41+
![Terminal Shell in your VM instance alt-text#center](images/gcp-shell.png "Terminal shell in your VM instance")
42+
43+
Next, let's install rust!

0 commit comments

Comments
 (0)