GitHub Actions
在集群上运行作业需要进行三项更改:连接 GitHub、将 runs-on 指向 Tuist 配置文件,然后推送代码。
-
连接 GitHub。 确保你的项目已连接到你的 GitHub 组织。Tuist 会接收该组织的
workflow_job事件,并将匹配的作业分派到集群。如果没有此连接,作业将无法到达你的运行器。 -
将
runs-on指向 Tuist 配置文件。 每个启用的账户都默认提供两个即开即用的配置文件:linux和macos。使用tuist-前缀来引用它们:jobs: build: runs-on: tuist-macos # or tuist-linux steps: - uses: actions/checkout@v4 - run: tuist testyamljobs:build:runs-on: tuist-macos # or tuist-linuxsteps:- uses: actions/checkout@v4- run: tuist test通过运行器配置文件选择 XcodemacOS 运行器镜像包含单个 Xcode 版本,Tuist 会在作业开始前根据配置文件进行选择。如果你正在从 GitHub 托管的运行器迁移,请移除使用
xcode-select --switch(或xcode-select -s)或其他工具和 Action 来切换 Xcode 版本的步骤。这些步骤通常引用特定于 GitHub 托管镜像的 Xcode 安装路径,在 Tuist Runners 上可能会失败。要使用其他 Xcode 版本,请创建或选择一个包含该版本的配置文件并更新
runs-on,例如runs-on: tuist-xcode-26-4。xcodebuild、xcrun和swift随后将使用配置文件所选的 Xcode,无需在工作流中进行额外设置。 -
推送并观察。 作业会被加入队列,由运行器领取,并实时流式传输回 Tuist 仪表板的Runners部分,你可以在那里跟踪其日志、步骤和机器指标。
缓存卷#
使用缓存卷在作业之间保留 Xcode、模块和 Gradle 缓存以及其他目录。在检出代码之后、在使用这些目录的命令之前添加它们。
为作业授予 id-token: write 权限,以便其缓存卷和缓存的检出内容在作业启动时立即挂载。如果没有此权限,运行器将等待 GitHub 报告其正在运行的作业,而 GitHub 延迟报告的作业将以空缓存启动。使用 OpenID Connect 登录 Tuist 的工作流已自动授予此权限。
permissions:
contents: read
id-token: write