コンテンツへスキップ

Buildkite

招待制

Tuist Runnersは現在、招待制です。アカウントへのアクセスをリクエストするには、お問い合わせいただくか、コミュニティSlackでご連絡ください。

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

  1. クラスターを接続する。 Buildkite でクラスターを開き、Agent Tokens に移動してトークンを作成します。トークンは bkct_ で始まります。Tuist ダッシュボードで Settings → Integrations に移動し、Buildkite カードの Connect を選択して、組織のスラッグとトークンを入力します。トークンは暗号化されて保存され、二度と表示されることはありません。後で組織を変更したりトークンを更新する場合は、カード上のフィールドを編集して Save changes を選択してください。Tuist は 1 分以内にクラスターの監視を開始します。

  2. キューに Tuist プロファイルに基づく名前を付ける。 有効なアカウントには、すぐに使用できる 2 つの プロファイル(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 キャッシュ、およびその他のディレクトリを保持します。これらはチェックアウトの後、それらを使用するコマンドの前に追加してください。