Runners
Tuist Runners 係專為你嘅 GitHub Actions、Buildkite、GitLab CI 同 Bitrise 流程而設嘅受管 macOS 同 Linux 執行器。與其喺 CI 供應商提供嘅託管機器上運行作業,不如將作業指向 Tuist 設定檔,佢就會喺 Tuist 嘅機隊上運行,緊鄰你團隊已經使用嘅同一個快取,無需安裝執行器代理程式,亦無需維護基礎設施。喺更換機器之前,要了解乜嘢驅動你嘅 CI 賬單,請參閱CI 成本。
採用佢哋通常只需要對作業進行一行更改:
jobs:
build:
- runs-on: macos-latest
+ runs-on: tuist-macos
steps:
- uses: actions/checkout@v4
- run: tuist test
steps:
- label: "Test"
command: tuist test
agents:
- queue: macos
+ queue: tuist-macos
Linux 上嘅 Android 模擬器#
預設情況下,Linux 執行器透過 /dev/kvm 提供硬件加速虛擬化。使用你普通嘅 Linux 設定檔(例如 tuist-linux)來運行 x86_64 Android 模擬器,包括 Gradle Managed Devices。訪問設備無需特殊嘅執行器設定檔、KVM 設置動作、權限更改或 sudo。
執行器映像包含 Android SDK。喺啟動設備之前,請安裝模擬器及其運行時庫。對於已經定義咗名為 pixel6 嘅 Gradle Managed Device 嘅項目,GitHub Actions 作業如下所示:
jobs:
android-test:
runs-on: tuist-linux
steps:
- uses: actions/checkout@v4
- uses: actions/setup-java@v4
with:
distribution: temurin
java-version: '17'
- name: Install emulator dependencies
run: |
sudo apt-get update -qq
sudo apt-get install -y --no-install-recommends \
libx11-6 libxcomposite1 libxcursor1 libxi6 libxtst6 libxrandr2 \
libxrender1 libpulse0 libnss3 libxkbcommon-x11-0 libxcb-cursor0 \
libasound2 libglu1-mesa
"$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" 'emulator'
- name: Check hardware acceleration
run: |
test -r /dev/kvm && test -w /dev/kvm
"$ANDROID_HOME/emulator/emulator" -accel-check
- name: Run instrumented tests
run: ./gradlew :app:pixel6DebugAndroidTest
使用你嘅 Android Gradle Plugin 所需嘅 Java 版本,並將測試任務替換為你項目嘅 managed-device 任務。配置一個 x86_64 系統映像。選擇一個有足夠內存供 Gradle 同模擬器使用嘅執行器規格;並發設備會共享作業嘅 CPU 同內存分配。
以普通執行器用戶身份運行模擬器。此示例中嘅 sudo 僅用於安裝操作系統軟件包。
模擬器使用嵌套虛擬化,因此其計時可能與實體 Android 設備不同。將模擬器基準測試視為對該 CI 環境嘅測量,而非實體設備性能。
並發限制#
每個帳戶對於 macOS 同 Linux 都有獨立嘅 vCPU 同內存並發限制。喺 Tuist 接納作業之前,它會檢查作業嘅 機器規格 與該平台上當前運行嘅所有作業。只有當作業嘅 vCPU 同內存都符合剩餘容量時,作業才會開始;否則,它會保持排隊狀態,直到容量可用。喺一個平台上嘅工作永遠不會消耗另一個平台嘅容量。
Air 帳戶具有固定嘅並發限制。對於 Pro 同 Enterprise 帳戶,Tuist 會根據經常性使用情況同最近無法與活動執行器並行嘅排隊工作,自動增加緩衝空間。自動調整只會增加限制:現有配額同合約規定嘅最低容量會得到保留。增長係漸進嘅,並受安全上限約束,因此突然激增不會授予無限並發權。較高嘅帳戶限制並不保證立即有可用機器。
Runners 儀表板嘅 並發 部分顯示每小時峰值接納嘅 vCPU 同內存使用量,並以階梯線顯示每小時開始時已知嘅限制。紅色條形達到該歷史閾值;佢哋本身並不能證明作業曾等待。一小時內嘅增加可能會使其峰值高於桶起始線。當前限制顯示喺每個圖表旁邊。歷史追蹤開始之前嘅時期沒有限制線,而不係假設嘅歷史值。
如果工作流程繼續喺安全上限處排隊,請聯絡我哋,提供你嘅帳戶句柄、平台同預期並行工作負載,以便我哋審查所需容量。
網絡訪問#
作業可以打開到公共互聯網嘅出站連接。私有地址範圍(10.0.0.0/8、172.16.0.0/12、192.168.0.0/16)被阻止,並且執行器不接受任何入站連接。
| 平台 | 出站端口 |
|---|---|
| Linux | TCP 22 (SSH)、80 (HTTP) 同 443 (HTTPS),以及 DNS |
| macOS | 所有端口 |
SSH 涵蓋 git@ 依賴項、SSH 子模塊、部署密鑰以及 ssh 或 scp 部署。如果 Linux 工作流程需要另一個出站端口,請聯絡我哋。
連接 GitHub,將 runs-on 指向 Tuist 設定檔,並喺機隊上運行你嘅第一個作業。
連接你嘅集群,以 Tuist 設定檔命名隊列,並從步驟中定位它。
連接一次 GitLab,並使用流水線標籤選擇每個作業嘅機器。
連接你嘅工作區,並喺 Tuist 設定檔上運行你自託管執行器池嘅構建。
通過一個請求從你自己嘅 git forge 或編排器運行作業,並通過 webhooks 跟蹤佢哋。
通過你從作業中引用嘅命名機器設定檔,選擇平台、大小同 Xcode 版本。
喺作業之間保留 Xcode、模塊同 Gradle 快取以及任何其他目錄,每次運行都有一個私有可寫副本。
Once 圖表動作#
當帳戶啟用遠程執行且伺服器宣傳兼容嘅工作器能力時,Once 可以喺 Tuist 嘅 Linux 工作器上執行合格嘅圖表命令動作。呢種係動作級別嘅執行,與上述 CI 提供商作業分開。請參閱 Once 遠程執行 以了解設置、映像要求同兼容性檢查。
點解揀 Tuist Runners#
大多數 CI 執行器提供商通過提供更強大嘅機器同持久快取(通常係掛載回你 CI 運行中嘅共享卷)來加快作業速度。雖然有幫助,但卷只係磁盤:佢會攜帶之前 CI 運行遺留嘅任何內容。佢唔會複製以保持最新構建產物靠近構建運行位置,亦都無法到達代碼構建嘅其他地方。
構建唔再局限於單一地點。相同代碼會喺開發者筆記本電腦、CI 環境,以及越來越多由編碼代理同其他自動化環境中編譯。Tuist Runners 嘅不同之處在於,無論你使用咩構建系統,佢哋都共享所有這些環境已經讀寫嘅同一個 快取。隊友喺筆記本電腦上預熱嘅產物、代理生成嘅產物或早期構建留下嘅產物都會喺執行器上命中,反之亦然。無需單獨預熱 CI 快取,加速效果亦都唔局限於 CI。
除此之外,快取與執行器位於同一私有網絡上,因此快取讀寫保持內部化並靠近計算資源,而唔係跨越公共互聯網。
綜合嚟講: