# Buildkite {#buildkite}

> [!IMPORTANT]
> **招待制**
>
> Tuist Runnersは現在、招待制です。アカウントへのアクセスをリクエストするには、[お問い合わせ](mailto:contact@tuist.dev)いただくか、[コミュニティSlack](https://slack.tuist.dev)でご連絡ください。


Tuist は Buildkite クラスター内のセルフホストキューを監視し、検出したジョブをフリート上で実行します。パイプラインは引き続き Buildkite 上で動作し、変更されるのはコンピューティングリソースのみです。フリートでジョブを実行するには、次の 3 つの変更が必要です。クラスターを接続し、キューに Tuist の <.localized_link href="/guides/features/runners/profiles">プロファイル</.localized_link> に基づいた名前を付け、ステップからそのキューを対象とします。

1. **クラスターを接続する。** Buildkite でクラスターを開き、**Agent Tokens** に移動してトークンを作成します。トークンは `bkct_` で始まります。Tuist ダッシュボードで **Settings → Integrations** に移動し、Buildkite カードの **Connect** を選択して、組織のスラッグとトークンを入力します。トークンは暗号化されて保存され、二度と表示されることはありません。後で組織を変更したりトークンを更新する場合は、カード上のフィールドを編集して **Save changes** を選択してください。Tuist は 1 分以内にクラスターの監視を開始します。
2. **キューに Tuist プロファイルに基づく名前を付ける。** 有効なアカウントには、すぐに使用できる 2 つの <.localized_link href="/guides/features/runners/profiles">プロファイル</.localized_link>（`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 トークンは不要です。

## 一時停止と切断 {#pausing-and-disconnecting}

Buildkite キューでのディスパッチを一時停止すると、Tuist がそのキューから新しいジョブを取得しなくなります。すでに実行中のジョブには影響しません。

**Settings → Integrations** 下の Buildkite カードでクラスターを切断すると、Tuist による監視が完全に停止します。

## キャッシュボリューム {#cache-volumes}

<.localized_link href="/guides/features/runners/cache-volumes">キャッシュボリューム</.localized_link> を使用して、ジョブ間で Xcode キャッシュ、モジュールキャッシュ、Gradle キャッシュ、およびその他のディレクトリを保持します。これらはチェックアウトの後、それらを使用するコマンドの前に追加してください。
