如何在 Github Actions 中指定架构？

Question

如何在 Github Actions 中指定架构（例如 x86 或 arm64）？

Answer 1

不，您无法设置 GitHub 托管运行器的架构。这些虚拟机运行 x64。目前无法指定或请求其他架构。

如果您需要 arm64 或 x86 上的运行程序，则需要设置自己的主机/虚拟机，并将运行程序以及构建过程所需的任何其他工具安装到其中。

您可以使用 GitHub/virtual-environments 存储库借用设置脚本，但您需要进行适当的调整以支持您选择的架构。

Answer 2

正如 @jessehouwing 所说，您将需要使用自托管运行器。 GitHub 托管的运行器尚不支持arm64。您可以通过启动arm64虚拟机并安装actions/runner来自己创建运行程序。您还可以使用单独的更完整的解决方案来动态创建这些跑步者。您有三个可靠的选择：

• terraform-aws-github-runner 有有关创建arm64运行器的文档。
• Kubernetes actions-runner-controller 没有任何容易找到的arm64支持，但我敢打赌它确实支持它。
• cdk-github-runners 这是我的项目，所以我对它有点偏见。我相信这是最容易设置的。您可以使用以下命令来获取arm64运行程序：

import { aws_codebuild as codebuild } from 'aws-cdk-lib';
import { Architecture, CodeBuildRunnerProvider } from '@cloudsnorkel/cdk-github-runners';

new GitHubRunners(this, 'runners', {
  providers: [
    new CodeBuildRunnerProvider(this, 'CodeBuild ARM64', {
      labels: ['codebuild', 'arm64'],
      computeType: codebuild.ComputeType.SMALL,
      imageBuilder: CodeBuildRunnerProvider.imageBuilder(this, 'Runner Image Builder', {
        architecture: Architecture.ARM64,
      }),
    }),
  ],
});

然后您的工作流程应该使用runs-on：[self-hosted，codebuild，arm64]。

Answer 3

您可以结合使用 qemu 和跨平台 docker 映像来实现结果。有一个 GH 工作流程操作尝试为您打包此操作，称为 run-on-architecture 。

您还可以将构建操作打包到 dockerfile 中，构建该 dockerfile 并（如有必要）将输出复制到主机运行程序。我将尝试提供一个小例子：

Dockerfile：

FROM debian:bullseye

ENV project myproject
ENV DEBIAN_FRONTEND noninteractive
ENV LC_ALL en_US.UTF-8
ENV LANG ${LC_ALL}

RUN echo "#log: ${project}: Setup system" \
  && set -x \
  && apt-get update -y \
  && apt-get install -y \
    build-essential \
    python3 \
  && apt-get clean \
  && sync

ADD . /usr/local/opt/${project}
WORKDIR /usr/local/opt/${project}

RUN echo "#log: ${project}: Running build" \
  && set -x \
  && ./configure \
  && make \
  && make dist

CMD /bin/bash -l

到目前为止，这都是普通的 dockerfile。现在的技巧是在 quemu-user 的帮助下在多个架构上运行它。 github 上有一个操作也可以进行此设置。

对于初学者来说，以下是如何在本地跨平台运行此程序：

docker build --name --tag my-builder --platform linux/arm64
docker build --name --tag my-builder --platform linux/arm

然后您可以使用 docker create 和 docker cp 复制工件：

CONTAINER=$docker create --platform "linux/arm64" my-builder)
docker cp "$CONTAINER:/usr/local/opt/myproject/*.tar.gz" .
docker rm "$CONTAINER"

CONTAINER=$docker create --platform "linux/arm" my-builder)
docker cp "$CONTAINER:/usr/local/opt/myproject/*.tar.gz" .
docker rm "$CONTAINER"

从这里，有几个在 github 操作中运行它的方法。一种是使用 setup-qemu-action。然后在工作流程中运行构建和复制步骤。像这样的东西：

jobs:
  build:
    runs-on: ubuntu-22.04
    strategy:
      matrix:
        platform: [linux/amd64, linux/arm64, linux/arm]
    steps:
      - uses: actions/checkout@v4
      - uses: docker/setup-qemu-action@v3
        with:
          image: tonistiigi/binfmt:latest
          platforms: arm,arm64
      - run: >
          docker build .
          --tag my-builder
          --platform ${{ matrix.platform }}
      - run: >
          docker create
          --name node-bcryptjs-builder
          --platform ${{ matrix.platform }}
          my-builder
      - run: docker cp "my-builder:/usr/local/opt/myproject/*.tar.gz .

另请参阅：

• https://docs.docker.com/build/建筑/多平台/
• https://nullprogram.com/blog/2021/08/21/
• https://www.stereolabs.com/docs/docker/building-arm-container-on-x86/

Answer 4

如果您有 Github Teams 或 Enterprise，则可以使用 runs-on。

这是一个示例，文档为 此处

我看到的唯一 Arm 类型是 XLarge arm64 (M1)

name: learn-github-actions-testing
on: [push]
jobs:
  build:
    runs-on: macos-13-xlarge
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: swift build
      - name: Run tests
        run: swift test

Answer 5

我相信您可以将架构指定为环境变量。

- name: Set up Python 3.8.5
  uses: actions/setup-python@v3
  with:
    architecture: 'x64'
    python-version: 3.8.5