跳至內容

Buildkite

僅限邀請

Tuist Runners 目前僅限邀請。聯絡我們或在 社群 Slack 上聯繫我們,以申請您的帳戶存取權限。

Tuist 會監控你 Buildkite 叢集中的自託管佇列,並在執行器群集上執行找到的工作。你的流水線仍會在 Buildkite 上運行;只有運算資源有所改變。要在執行器群集上執行工作,需要進行三項變更:連接你的叢集、以 Tuist 設定檔 命名佇列,並從步驟中指定該佇列。

  1. 連接你的叢集。 在 Buildkite 中,開啟你的叢集,前往 Agent Tokens 並建立權杖;其開頭為 bkct_。在你的 Tuist 儀表板中,前往 Settings → Integrations,在 Buildkite 卡片上選擇 Connect,然後輸入你的組織 slug 與權杖。該權杖會以加密方式儲存,且不會再次顯示。若之後要變更組織或輪替權杖,請編輯卡片上的欄位並選擇 Save changes。Tuist 會在一分鐘內開始監控該叢集。

  2. 以 Tuist 設定檔命名佇列。 每個已啟用的帳戶都會提供兩個可直接使用的設定檔:linux 與 macos。當工作的佇列金鑰與設定檔的標籤相符時,就會被接收。在你的叢集中建立金鑰為 tuist-linux 與 tuist-macos 的自託管佇列,然後從步驟中指定其中一個:

    yaml
    # .buildkite/pipeline.yml
    steps:
    - label: "Test"
    command: tuist test
    agents:
    queue: tuist-macos # or tuist-linux
  3. 推送並觀察。 工作會被加入佇列、由執行器領取,並串流回 Tuist 儀表板的 Runners 區段,你可以在那裡追蹤其日誌、步驟與機器指標。執行器會使用僅限該單一工作的憑證,從工作內部傳送日誌,因此不需要 Buildkite API 權杖。

暫停與斷開連線#

暫停 Buildkite 佇列的分派後,Tuist 將不再從該佇列接收新工作。已在執行的工作不受影響。

在 Settings → Integrations 下的 Buildkite 卡片上斷開叢集連線,會讓 Tuist 完全停止監控該叢集。

快取磁碟區#

使用快取磁碟區在工作之間保留 Xcode、模組與 Gradle 快取以及其他目錄。在 checkout 之後、在使用這些目錄的命令之前加入它們。