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)或其他工具與動作來切換 Xcode 版本的步驟。這些步驟通常參考 GitHub 託管映像檔特有的 Xcode 安裝路徑,可能在 Tuist 執行器上失敗。若要使用其他 Xcode 版本,請建立或選擇包含該版本的設定檔並更新
runs-on,例如runs-on: tuist-xcode-26-4。xcodebuild、xcrun與swift隨後會使用設定檔所選的 Xcode,無需在工作流程中進行額外設定。 -
推送並觀察。 作業會被放入佇列、由執行器領取,並串流回 Tuist 儀表板的執行器區段,你可以在那裡追蹤其日誌、步驟與機器指標。
快取磁碟區#
使用快取磁碟區在作業之間保留 Xcode、模組與 Gradle 快取以及其他目錄。在 checkout 之後、在使用這些目錄的命令之前加入它們。
授予作業 id-token: write 權限,讓其快取磁碟區與已快取的 checkout 在作業啟動時立即掛載。若缺少此權限,執行器會等待 GitHub 回報正在執行的作業,而 GitHub 延遲回報的作業將會以空快取啟動。使用 OpenID Connect 登入 Tuist 的工作流程已預設授予此權限。
permissions:
contents: read
id-token: write