You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/learning-paths/servers-and-cloud-computing/github-on-arm/_index.md
+22-26Lines changed: 22 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,18 @@
1
1
---
2
2
title: Deploy GitHub Actions Self-Hosted Runner on Google Axion C4A virtual machine
3
3
4
-
draft: true
5
-
cascade:
6
-
draft: true
7
-
8
4
minutes_to_complete: 15
9
5
10
-
who_is_this_for: This is an introductory topic for developers who want to deploy GitHub Actions Self-Hosted Runner on an Arm-based Google Axion C4A instance.
6
+
who_is_this_for: This is an introductory topic for developers who want to deploy a GitHub Actions self-hosted runner on an Arm-based Google Axion C4A instance.
11
7
12
8
learning_objectives:
13
-
- Provision an Arm virtual machine on the Google Cloud Platform using the C4A Google Axion instance family.
14
-
- Set up and validate a GitHub Actions self-hosted runner on the Arm virtual machine.
15
-
- Deploy a basic CI workflow with NGINX and verify execution on Arm infrastructure.
9
+
- Provision an Arm virtual machine on the Google Cloud Platform using the C4A Google Axion instance family
10
+
- Set up and validate a GitHub Actions self-hosted runner on the Arm virtual machine
11
+
- Deploy a basic CI workflow with NGINX and verify execution on Arm infrastructure
16
12
17
13
prerequisites:
18
-
- A [Google Cloud Platform (GCP)](https://cloud.google.com/free?utm_source=google&hl=en) account with billing enabled.
19
-
- A GitHub account. You can sign up [here](https://github.com/signup).
14
+
- A [Google Cloud Platform (GCP)](https://cloud.google.com/free?utm_source=google&hl=en) account with billing enabled
15
+
- A GitHub account; you can sign up [here](https://github.com/signup)
Copy file name to clipboardExpand all lines: content/learning-paths/servers-and-cloud-computing/github-on-arm/background.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,20 +8,20 @@ layout: "learningpathall"
8
8
9
9
## Google Axion C4A series
10
10
11
-
The Google Axion C4A series 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 ideal for modern cloud workloads such as CI/CD pipelines, microservices, media processing, and general-purpose applications.
11
+
The Google Axion C4A series is a family of Arm-based virtual machines (VMs) 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 ideal for modern cloud workloads such as CI/CD pipelines, microservices, media processing, and general-purpose applications.
12
12
13
-
The C4A series provides offer a cost-effective virtual machine while leveraging the scalability and performance benefits of the Arm architecture in Google Cloud.
13
+
The C4A series provides cost-effective VMs while leveraging the scalability and performance benefits of the Arm architecture on Google Cloud.
14
14
15
-
To learn more about Google Axion, refer to the blog [Introducing Google Axion Processors, our new Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu).
15
+
Learn more in Google’s announcement: [Introducing Google Axion processors, our new Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu).
16
16
17
17
## GitHub Actions and CI/CD
18
18
19
-
GitHub Actions is a powerful CI/CD (Continuous Integration and Continuous Delivery) platform built into GitHub. It allows developers to automate tasks such as building, testing, and deploying code in response to events like code pushes, pull requests, or scheduled jobs—directly from their GitHub repositories. This helps improve development speed, reliability, and collaboration.
19
+
GitHub Actions is a powerful CI/CD (Continuous Integration and Continuous Delivery) platform built into GitHub. It allows developers to automate tasks such as building, testing, and deploying code in response to events like code pushes, pull requests, or scheduled jobs - directly from their GitHub repositories. This helps improve development speed, reliability, and collaboration.
20
20
21
21
A key feature of GitHub Actions is [self-hosted runners](https://docs.github.com/en/actions/concepts/runners/about-self-hosted-runners), which let you run workflows on your own infrastructure instead of GitHub’s hosted servers. This is especially useful for:
22
22
23
-
- Running on custom hardware, including Arm64-based systems (e.g., Google Axion virtual machine), to optimize performance and ensure architecture-specific compatibility.
24
-
- Private network access, allowing secure interaction with internal services or databases.
25
-
- Faster execution, especially for resource-intensive workflows, by using dedicated or high-performance machines.
23
+
- Running on custom hardware, including Arm64-based systems (for example, Google Axion virtual machine), to optimize performance and ensure architecture-specific compatibility
24
+
- Private network access, allowing secure interaction with internal services or databases
25
+
- Faster execution, especially for resource-intensive workflows, by using dedicated or high-performance machines
26
26
27
-
Self-hosted runners provide more control, flexibility, and cost-efficiency—making them ideal for advanced CI/CD pipelines and platform-specific testing.
27
+
Self-hosted runners give you more control, flexibility, and costefficiency - ideal for advanced CI/CD pipelines and platform-specific testing.
Copy file name to clipboardExpand all lines: content/learning-paths/servers-and-cloud-computing/github-on-arm/deploy.md
+60-60Lines changed: 60 additions & 60 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,10 +6,11 @@ weight: 4
6
6
layout: learningpathall
7
7
---
8
8
9
+
## Overview
9
10
10
-
This section shows how to deploy a self-hosted GitHub Actions runner on your instance. It covers installing Git and GitHub CLI, authenticating with GitHub and configuring the runner on an Arm64 environment for optimized CI/CD workflows.
11
+
This section shows you how to deploy a GitHub Actions self-hosted runner on your Arm64 Google Axion C4A instance. You will install Git and GitHub CLI, authenticate with GitHub, and register the runner so CI/CD workflows run on Arm infrastructure.
11
12
12
-
###Set up development environment
13
+
## Set up your development environment
13
14
14
15
Start by installing the required dependencies using the `apt` package manager:
15
16
@@ -18,7 +19,7 @@ sudo apt update
18
19
sudo apt install -y git gh vim
19
20
```
20
21
21
-
Next step is to configure your git credentials. Update the command with your name and email.
Now you are ready to connect the machine to GitHub. The command below is used to authenticate the GitHub CLI with your GitHub account. It allows you to securely log in using a web browser or token, enabling the CLI to interact with repositories, actions, and other GitHub features on your behalf.
29
30
31
+
Authenticate with GitHub:
30
32
31
33
```console
32
34
gh auth login
33
35
```
34
36
35
-
The command will prompt you to make a few choices. For this use-case, you can use the default ones as shown in the image below.
37
+
Follow the prompts and accept the defaults:
36
38
37
-
39
+
![Login to GitHub alt-text#center](./images/gh-auth.png"Screenshot of GitHub authentication prompt")
38
40
39
-
{{% notice %}}
40
-
If you get an error opening the browser on your virtual machine, you can navigate to the following URL on the host machine.
41
+
{{% notice Note %}}
42
+
If you get an error opening the browser on your virtual machine, you can navigate to the following URL on the host machine and enter the device code displayed in the CLI of the virtual machine:
41
43
```
42
44
https://github.com/login/device
43
45
```
44
-
From there, you can enter the code displayed in the CLI of the virtual machine.
45
46
{{% /notice %}}
46
47
47
-
If the log in was successful, you will see the following confirmation in your browser window.
48
+
When authentication succeeds, you will see a confirmation screen in your browser:
48
49
49
-
50
+
![GitHub UIalt-text#center](./images/login-page.png"Screenshot of successful GitHub login confirmation")
50
51
51
-
###Test GitHub CLI and Git
52
+
## Test GitHub CLI and Git
52
53
53
-
The command below creates a new public GitHub repository named **test-repo** using the GitHub CLI. It sets the repository visibility to public, meaning anyone can view it
54
+
The command below creates a new public GitHub repository named `test-repo` using the GitHub CLI. It sets the repository visibility to public, meaning that anyone can view it:
54
55
55
56
```console
56
57
gh repo create test-repo --public
@@ -59,66 +60,65 @@ You should see an output similar to:
59
60
```output
60
61
✓ Created repository <your-github-account>/test-repo on GitHub
* Go to your repository's **Settings > Actions**, and under the **Runners** section
68
-
* Click on **Add Runner** or view existing self-hosted runners.
68
+
In your repository, go to **Settings** → **Actions** → **Runners** and select **Add runner**, or view existing self-hosted runners.
69
69
70
-
{{% notice Note %}}
71
-
If the **Actions** tab is not visible, ensure Actions are enabled by navigating to **Settings > Actions > General**, and select**Allow all actions and reusable workflows**.
72
-
{{% /notice %}}
70
+
{{% notice Note %}}
71
+
If the **Actions** tab is not visible, enable Actions under **Settings** → **Actions** → **General** by selecting**Allow all actions and reusable workflows**.
72
+
{{% /notice %}}
73
73
74
-
74
+
![runner alt-text#center](./images/newsh-runner.png"Screenshot of repository Runners settings page")
75
75
76
-
Then, click on the **New self-hosted runner** button. In the **Add new self-hosted runner** section. Select Linux for the operating system, and choose ARM64 for the architecture. This will generate commands to set up the runner. Copy and run them on your Google Axion C4A virtual machine.
76
+
Click **New self-hosted runner**. In the setup panel, choose `Linux` as the operating system and `ARM64` as the architecture. Copy the generated setup commands and run them on your C4A VM.
77
+
78
+
![new-runner alt-text#center](./images/new-runner.png"Screenshot of the Add new self-hosted runner panel")
77
79
78
-
80
+
The final command links the runner to your GitHub repository using a one-time registration token.
81
+
During setup, you will be prompted for the runner group, runner name, and work folder. Press **Enter** at each prompt to accept the defaults. The output should look similar to:
79
82
80
-
The final command links the runner to your GitHub repo using a one-time registration token.
During the command’s execution, you will be prompted to provide the runner group, the name of the runner, and the work folder name. You can accept the defaults by pressing **Enter** at each step. The output will resemble as below:
Copy file name to clipboardExpand all lines: content/learning-paths/servers-and-cloud-computing/github-on-arm/instance.md
+19-17Lines changed: 19 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,28 +6,30 @@ weight: 3
6
6
layout: learningpathall
7
7
---
8
8
9
-
## Introduction
9
+
## Overview
10
10
11
-
This section walks you through creating **Google Axion C4A Arm virtual machine** on GCP with the **c4a-standard-4 (4 vCPUs, 16 GB Memory)** machine type, using the **Google Cloud Console**.
11
+
This section walks you through creating a Google Axion C4A Arm virtual machine on Google Cloud with the `c4a-standard-4` (4 vCPUs, 16 GB memory) machine type using the Google Cloud Console. You will use this VM later as the host for a GitHub Actions self-hosted runner.
12
12
13
-
If you haven't got a Google Cloud account, you can follow the Learning Path on [Getting Started with Google Cloud Platform](https://learn.arm.com/learning-paths/servers-and-cloud-computing/csp/google/) to get started.
13
+
If you don't have a Google Cloud account, see the Learning Path [Getting started with Google Cloud Platform](https://learn.arm.com/learning-paths/servers-and-cloud-computing/csp/google/).
14
14
15
-
###Create an Arm-based Virtual Machine (C4A)
15
+
## Create an Arm-based virtual machine (C4A)
16
16
17
-
To create a virtual machine based on the C4A Arm architecture:
18
-
1. Open the [Google Cloud Console](https://console.cloud.google.com/).
19
-
2. Navigate to the card **Compute Engine** and click on **Create Instance**.
20
-
3. Under the **Machine Configuration**:
21
-
- Fill in basic details like **Instance Name**, **Region**, and **Zone**.
4. Under the **OS and Storage**, click on **Change**, pick **Ubuntu** as the Operating System with **Ubuntu 24.04 LTS Minimal** as the Version. Make sure you pick the version of image for Arm.
26
-
5. Under **Networking**, enable **Allow HTTP traffic** to test workloads like NGINX later.
27
-
6. Click on **Create**, and the instance will launch.
17
+
Follow these steps in the Google Cloud Console:
18
+
19
+
- Open the [Google Cloud Console](https://console.cloud.google.com/).
20
+
- Go to **Navigation menu ▸ Compute Engine ▸ VM instances**, then select **Create instance**.
21
+
- Under **Machine configuration**:
22
+
- Enter **Instance name**, **Region**, and **Zone**
23
+
- Set **Series** to `C4A`
24
+
- Choose a machine type such as `c4a-standard-4`
25
+
- Under **OS and storage**, select **Change**, pick **Ubuntu** as the operating system, and choose **Ubuntu 24.04 LTS Minimal**. Make sure you select the Arm image variant.
26
+
- Under **Networking**, enable **Allow HTTP traffic** so you can test workloads like NGINX later.
27
+
- Select **Create** to launch the instance.
28
+
29
+
![Google Cloud Console page showing C4A VM creation with c4a-standard-4 selectedalt-text#center](./images/select-instance.png"Create a C4A VM in the Google Cloud Console")
28
30
29
31
{{% notice Important %}}
30
-
You should not enable the **Allow HTTP traffic**permanently, since this poses a security risk. For the long-term, you should only allow traffic from the IP address you use to connect to the instance.
32
+
Do not leave **Allow HTTP traffic**enabled permanently. For long-term use, allow traffic only from the IP addresses you use to connect to the instance.
31
33
{{% /notice %}}
32
34
33
-
You can access the Google Cloud Console by clicking the **SSH** button in the instance overview. Use this command line interface (CLI) to run the commands in the remainder of this Learning Path.
35
+
Access the VM from the instance list by selecting **SSH** in the instance overview. Use this command line interface (CLI) to run the commands in the remainder of this Learning Path.
0 commit comments