Merge pull request #1546 from jasonrandrews/review

jasonrandrews · web-flow · commit 18497965b127 · 2025-01-21T16:16:40.000-06:00
Update GitHub Arm-hosted runner Learning Path for public repositories.
diff --git a/content/learning-paths/cross-platform/github-arm-runners/_images/lscpu.png b/content/learning-paths/cross-platform/github-arm-runners/_images/lscpu.png
diff --git a/content/learning-paths/cross-platform/github-arm-runners/_index.md b/content/learning-paths/cross-platform/github-arm-runners/_index.md
@@ -10,14 +10,14 @@ learning_objectives:
     - Use GitHub Actions to automate image builds.
 
 prerequisites:
-    - A GitHub account with a Team or Enterprise Cloud plan.
+    - A GitHub account (a Team or Enterprise Cloud plan is required for private repositories).
     - A Docker Hub account.
 
 author_primary: Jason Andrews
 
 ### Tags
 skilllevels: Introductory
-subjects: Containers and Virtualization
+subjects: CI-CD
 armips:
     - Neoverse
 operatingsystems:
diff --git a/content/learning-paths/cross-platform/github-arm-runners/_next-steps.md b/content/learning-paths/cross-platform/github-arm-runners/_next-steps.md
@@ -17,14 +17,14 @@ recommended_path: "/learning-paths/cross-platform/docker-build-cloud/"
     # General online references                 (type: website) 
 
 further_reading:
+    - resource:
+        title: Linux arm64 hosted runners now available for free in public repositories
+        link: https://github.blog/changelog/2025-01-16-linux-arm64-hosted-runners-now-available-for-free-in-public-repositories-public-preview/
+        type: documentation
     - resource:
         title: Using GitHub-hosted runners
         link: https://docs.github.com/en/actions/using-github-hosted-runners
         type: documentation
-    - resource:
-        title: Supercharge your CI/CD with Arm Runners in GitHub Actions
-        link: https://www.youtube.com/watch?v=vrr_OgMk458
-        type: video
     - resource:
         title: Arm64 on GitHub Actions Powering faster, more efficient build systems
         link: https://github.blog/2024-06-03-arm64-on-github-actions-powering-faster-more-efficient-build-systems/
diff --git a/content/learning-paths/cross-platform/github-arm-runners/actions.md b/content/learning-paths/cross-platform/github-arm-runners/actions.md
@@ -1,14 +1,14 @@
 ---
 title: "Run GitHub Actions jobs on the Arm-hosted runner"
 
-weight: 3
+weight: 5
 
 layout: "learningpathall"
 ---
 
 ## Use GitHub Actions
 
-You can use GitHub Actions to build multi-architecture images by using your new Arm-hosted runner alongside a standard runner by creating a workflow file.
+You can use GitHub Actions to build multi-architecture images by creating a workflow file and using Arm-hosted runners.
 
 ## Create a new GitHub repository
 
diff --git a/content/learning-paths/cross-platform/github-arm-runners/intro.md b/content/learning-paths/cross-platform/github-arm-runners/intro.md
@@ -0,0 +1,27 @@
+---
+title: "Build options for multi-architecture container images"
+
+weight: 2
+
+layout: "learningpathall"
+---
+
+## How can I build multi-architecture container images?
+
+Building multi-architecture container images for complex projects is challenging.
+
+There are two common ways to build multi-architecture images, and both are explained in [Learn how to use Docker](/learning-paths/cross-platform/docker/).
+
+### Use instruction emulation
+
+The first method uses instruction emulation. You can learn about this method in [Build multi-architecture images with Docker buildx](/learning-paths/cross-platform/docker/buildx/). The drawback of emulation is slow performance, especially for complex builds which involve tasks such as compiling large C++ applications. 
+
+### Use a manifest and multiple computers
+
+The second method uses multiple computers, one for each architecture, and joins the images to create a multi-architecture image using Docker manifest. You can learn about this method in [Use Docker manifest to create multi-architecture images](/learning-paths/cross-platform/docker/manifest/). The drawback of the manifest method is its complexity as it requires multiple systems.
+
+### Arm-hosted runners
+
+Arm-hosted runners from GitHub provide a way to create multi-architecture images with higher performance and lower complexity compared to the two methods described above. 
+
+When you use Arm-hosted runners, you don't need to worry about self-hosting (managing servers) or instruction emulation (slow performance).
diff --git a/content/learning-paths/cross-platform/github-arm-runners/public-repos.md b/content/learning-paths/cross-platform/github-arm-runners/public-repos.md
@@ -0,0 +1,50 @@
+---
+title: "Arm-hosted runners for public repositories"
+
+weight: 3
+
+layout: "learningpathall"
+---
+
+## What are Arm-hosted runners?
+
+Runners are the machines that execute jobs in a GitHub Actions workflow. An Arm-hosted runner is a runner that is managed by GitHub and uses the Arm architecture. This means that you don't need to provide a server to run Actions workflows. GitHub provides the system and runs the Action workflows for you.
+
+Arm-hosted runners are available for public and private repositories. 
+
+If you have a free plan, Arm-hosted runners are available in public repositories at no cost, subject to standard usage limits. 
+
+You can use Arm-hosted runners in private repositories with a Teams or Enterprise Cloud account (covered on the next page).
+
+## What kind of server hardware is used by Arm-hosted runners?
+
+You may have software that relies on Arm architecture features. Arm-hosted runners are powered by Cobalt 100 processors, based on the Arm Neoverse N2. The free runners have 4 vCPUs and Armv9-A features including Scalable Vector Extension 2 (SVE2). 
+
+The output of the `lscpu` command is below.
+
+![Arm-hosted runner info #center](_images/lscpu.png)
+
+## What do I need to change in my workflow to use Arm-hosted runners?
+
+To use Arm-hosted Linux runners, use the `ubuntu-22.04-arm` and `ubuntu-24.04-arm` labels in your public repository workflow runs.
+
+For example, if you have a workflow file with:
+
+```console
+runs-on: ubuntu-24.04
+```
+
+You can replace it with the Arm-hosted runner:
+
+```console
+runs-on: ubuntu-24.04-arm
+```
+
+## How can I find out more about the software installed on the Arm-hosted runners?
+
+You can look at the [GitHub Actions Partner Images repository](https://github.com/actions/partner-runner-images/) for information about the runner images and installed software.
+
+You can also use the repository to report issues or request additional software be added to the images. 
+
+
+
diff --git a/content/learning-paths/cross-platform/github-arm-runners/runner.md b/content/learning-paths/cross-platform/github-arm-runners/runner.md
@@ -1,36 +1,16 @@
 ---
-title: "Create a new Arm-hosted runner"
+title: "Create a new Arm-hosted runner for private repositories"
 
-weight: 2
+weight: 4
 
 layout: "learningpathall"
 ---
 
-## How can I build multi-architecture container images?
+## Can I use Arm-hosted runners for private repositories?
 
-Building multi-architecture container images for complex projects is challenging.
+Yes, you can use Arm-hosted runners in private repositories.
 
-There are two common ways to build multi-architecture images, and both are explained in [Learn how to use Docker](/learning-paths/cross-platform/docker/).
-
-The first method uses instruction emulation. You can learn about this method in [Build multi-architecture images with Docker buildx](/learning-paths/cross-platform/docker/buildx/). The drawback of emulation is slow performance, especially for complex builds which involve tasks such as compiling large C++ applications. 
-
-The second method uses multiple machines, one for each architecture, and joins the images to create a multi-architecture image using Docker manifest. You can learn about this method in [Use Docker manifest to create multi-architecture images](/learning-paths/cross-platform/docker/manifest/). The drawback of the manifest method is its complexity as it requires multiple machines.
-
-Arm-hosted runners from GitHub provide a way to create multi-architecture images with higher performance and lower complexity compared to the two methods described above. 
-
-When you use Arm-hosted runners, you don't need to worry about self-hosting (managing servers) or instruction emulation (slow performance).
-
-## What are Arm-hosted runners?
-
-Runners are the machines that execute the jobs in a GitHub Actions workflow. An Arm-hosted runner is a runner that is managed by GitHub and uses the Arm architecture. This means that you don't need to provide a server to run Actions workflows. GitHub provides the system and runs the Action workflows for you.
-
-Arm-hosted runners are available for Linux and Windows. 
-
-This Learning Path uses Linux. 
-
-{{% notice Note %}}
 You must have a Team or Enterprise Cloud plan to use Arm-hosted runners.
-{{% /notice %}}
 
 Two types of GitHub-hosted runners are available; standard runners, and larger runners. Larger runners are differentiated from standard runners because users can control the amount of RAM, the number of CPUs, and configure the allocated disk space. Larger runners have additional options for a static IP address and the ability to group runners and control settings across the runner group. Currently, Arm-hosted runners are a type of larger runner.
 
