コンテンツへスキップ

compiler.dev ドキュメント

compiler.dev は、既存の GitHub Actions ジョブを高速で隔離された Linux マシン上で実行します。GitHub Actions とチェックはそのまま使用でき、変わるのはマシンだけです。ルーティング設定を使用している場合、compiler.dev がジョブを処理できない場合や、クレジットまたは月間上限を使い切った場合、ジョブは切り替え前に使用していたランナー(GitHub がホストするものでも、お客様が用意したものでも)で実行されます。1 行の runs-on: compiler-8cpu ラベルは GitHub App のインストール後に使用できますが、自動フォールバックはありません。ジョブは compiler.dev ランナーが空くまで待機します(サイズラベルを参照してください)。

はじめに

1. サインインして GitHub App をインストールします。GitHub でサインイン後、compiler.dev App を組織にインストールし、アクセスを許可するリポジトリを選択してください。App はワークフローとジョブのメタデータを読み取り、compiler.dev にルーティングされるジョブ用の一時的なランナーを登録します。また、セットアップ PR を通じてのみワークフローの変更を提案します。App が何かをマージすることはありません。

2. リポジトリとモードを選択します。ワークフローを分析し、移行できるジョブを表示します。安全に試す(比較:コピーは当社のマシンで実行され、結果はご自身のランナーのものが使われます)を選ぶか、プルリクエストの10%、25%、50%、100%を対象に今すぐ切り替えるを選択できます。PR は、その後のすべてのプッシュと再実行でも同じ側に留まります。

3. セットアップ PR をマージします。ルーティング対象の各ワークフローには、小さな compiler-route ジョブが追加されます。これは、ジョブをどこで実行すべきかを compiler.dev に問い合わせるもので、ジョブはその回答を runs-on として使用します。ステップは変更されません。PR がマージされるまでは何も移動しません。

4. 最初の実行を確認します。App は各ジョブを、キュー待ち、起動中、実行中、完了といった状態でリアルタイムに表示します。マシン名と、以前のランナーとの所要時間の比較も確認できます。

移行できるジョブ

フォールバックとロールバック

ビルドキャッシュ(Nx / Turborepo)

compiler.devのランナーでは、Nx(20.8以降)とTurborepoがランナーと並んで提供されるリモートキャッシュを自動的に使用します。ワークフローに変更は必要ありません。キャッシュはリポジトリごとに分離されています。プルリクエストはデフォルトブランチのキャッシュを読み取れますが、書き込みは自身のキャッシュにのみ可能です。そのため、PRが信頼されたビルドにアーティファクトを注入することはできません。特定のジョブでこの機能を無効にするには、そのジョブのenv:でNX_SELF_HOSTED_REMOTE_CACHE_SERVER: ""and/orTURBO_API: ""を設定します。

AWS での OIDC

OIDCを使うと、GitHubにアクセスキーを保存することなく、ジョブが短期間有効なAWS認証情報を取得できます。各実行時にGitHubが署名付きトークンを発行し、AWSがそのトークンを一時的な認証情報と交換します。トークンの仕組みはGitHub Actionsの標準的なものです。そのため、以下のワークフローはcompiler.devのruns-onラベルを使う一般的な構成になります。詳しい手順はGitHub Actions OIDCからAWSへの接続をご覧ください。

1. IAMにGitHubをIDプロバイダーとして追加します。 プロバイダーURLはhttps://token.actions.githubusercontent.com、オーディエンスはsts.amazonaws.comに設定します。

2. 次のトラストポリシーでロールを作成します。 111122223333、ORG、REPOを置き換えてください。他のリポジトリやブランチからのアクセスを防ぐのがsub条件の役割ですので、必ず設定してください。

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Principal": { "Federated": "arn:aws:iam::111122223333:oidc-provider/token.actions.githubusercontent.com" },
    "Action": "sts:AssumeRoleWithWebIdentity",
    "Condition": {
      "StringEquals": {
        "token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
        "token.actions.githubusercontent.com:sub": "repo:ORG/REPO:ref:refs/heads/main"
      }
    }
  }]
}

3. ワークフローでロールを使用します。 ジョブにはid-token: writeが必要です。

permissions:
  id-token: write
  contents: read

jobs:
  deploy:
    runs-on: compiler-8cpu
    steps:
      - uses: actions/checkout@v4
      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::111122223333:role/github-deploy
          aws-region: eu-west-2
      - run: aws sts get-caller-identity

Google Cloud での OIDC

ワークロードID連携を使うと、キーファイルを保存せずにジョブがGoogle Cloudのサービスアカウントとして動作できます。実行のたびにGitHubが署名付きトークンを発行し、Googleがそれを短期間有効な認証情報に交換します。トークンの流れは標準のGitHub Actionsと同じなので、以下のワークフローはcompiler.devのruns-onラベルを指定した通常のものです。

1. ワークロードIDプールとGitHubプロバイダーを作成します。発行者はhttps://token.actions.githubusercontent.comです。クレームを属性にマッピングし、リポジトリだけを受け入れるよう条件を追加します:

gcloud iam workload-identity-pools providers create-oidc github \
  --project=MY_PROJECT --location=global --workload-identity-pool=github-pool \
  --issuer-uri="https://token.actions.githubusercontent.com" \
  --attribute-mapping="google.subject=assertion.sub,attribute.repository=assertion.repository,attribute.ref=assertion.ref" \
  --attribute-condition="assertion.repository == 'ORG/REPO'"

2. そのリポジトリにサービスアカウントの使用を許可します。リポジトリのプリンシパルセットに、サービスアカウントに対するroles/iam.workloadIdentityUserを付与します:

principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/github-pool/attribute.repository/ORG/REPO

3. ワークフローで使用します。ジョブにはid-token: writeが必要です:

permissions:
  id-token: write
  contents: read

jobs:
  deploy:
    runs-on: compiler-8cpu
    steps:
      - uses: actions/checkout@v4
      - uses: google-github-actions/auth@v2
        with:
          workload_identity_provider: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/github-pool/providers/github
          service_account: deploy@MY_PROJECT.iam.gserviceaccount.com
      - uses: google-github-actions/setup-gcloud@v2
      - run: gcloud auth list

ご自身のボックスで始める

Code in a box は、コーディングエージェント用の自分専用Linuxマシンです(4 vCPU、16 GB、100 GB ディスク)。Claude Code または Codex がそこでお使いのリポジトリに対して作業します。進行状況を確認し、方向性を指示し、プルリクエストを開くことができます。ディスクは永続化されるため、リポジトリ、ワークツリー、エージェントのセッションは次回も残ります。

1. サインインします。 GitHub でサインインし、組織に compiler.dev App をインストールしてください(CI で使うものと同じ App です)。組織にはプリペイドクレジットが必要です。クレジットがない場合、ボックスのカードには ボックスを開始するにはクレジットを追加 と表示され、請求ページへのリンクが示されます。

2. キーを追加します。 ワークスペース(または概要画面の ボックスでコーディングを開始)を開き、ボックスを作成します。次に、ご自身のキーを貼り付けます。Claude Code 用は Anthropic キー(console.anthropic.com → API keys から取得)、Codex 用は OpenAI キー(platform.openai.com → API keys から取得)です。キーは暗号化して保存され、ご自身のボックスにのみ送信され、再表示されることはありません。モデルの利用料金は Anthropic または OpenAI からお客様に請求されます。

3. 起動します。 初回の起動には約1分かかります。それ以降は、開始を押すと停止中のボックスを約15秒で再開できます。停止中のボックスにプロンプトを送信しても、自動的に起動します。

4. チャットします。 リポジトリとエージェントを選び、変更内容を説明して、チャットを開始を押します。各チャットには、ブランチ ws/… 上の専用の git ワークツリーが作成されます。エージェントのメッセージとコマンドをリアルタイムで確認でき、その後、実行されたテストと差分が表示されます。次の変更にはフォローアップを送信し、プルリクエストを開くこともできます。1つのボックスでは、最大3つのエージェントが同時に作業できます。

別のデバイスで開きます。 別のデバイスで開くを押すと、5分間有効な一度限りのリンクが作成されます。このリンクを使うと、別のブラウザ(例:スマートフォン)で、そこではサインインせずに同じチャットを12時間開けます。他のデバイスからサインアウトを押すと、それらのセッションを終了できます。

6. 停止します。 作業が終わったら停止を押すか、そのまま放置してください。エージェントが作業しておらず、開いているチャットに誰もいない状態が60分続くと、ボックスは自動的に停止します。バックグラウンドで開いたままのタブや、30分間操作していないタブがあっても、ボックスは起動したままになりません。停止してもディスクは保持されます。ボックスを削除すると、ディスクも削除されます。

トークンの削減。 ボックス内のエージェントは、シェルコマンドを RTK 経由で実行します。RTK は、モデルが読む前にビルド、テスト、git の出力を圧縮します(通常60〜90%削減)。ボックス内で rtk gain を実行すると、削減量を確認できます。特定のコマンドだけ RTK を経由させたくない場合は、コマンドの先頭に RTK_DISABLED=1 を付けてください。ボックス全体で無効にするには、rtk init -g --uninstall と rtk init -g --codex --uninstall を実行します。これでエージェントは未加工の出力を見るようになります。新しい RTK バージョンを提供するまで、ボックスが自動的に元に戻すことはありません。

GitLab (ベータ版)

ジョブにタグを追加すると、GitLab CIのジョブをcompiler.devのマシンで実行できます。gitlab.comのプロジェクトとグループで利用できます。セルフマネージドのGitLabについては、contact@compiler.devまでお問い合わせください。現在はクローズドベータです。お客様の組織で有効化されると、アプリのメニューのCerセクションにGitLab(ベータ)のページが表示されます。

1. 接続します。アプリでGitLab(ベータ)を開き、GitLabに接続を押します。GitLabにサインインして承認してください。compiler.devはapiスコープ(ランナーとWebhookを作成できる、より狭いスコープはGitLabにありません)とread_userを要求します。トークンは暗号化して保存され、再表示されることはありません。有効化するには、グループのオーナーロール、またはプロジェクトのメンテナーロールが必要です。

2. グループまたはプロジェクトを有効にします。このページには、お客様がオーナーのグループと、メンテナーとして管理しているプロジェクトが、それぞれスイッチとともに一覧表示されます。有効にすると、GitLabに4つのランナーがサイズごとに1つずつ作成され、Job eventsのWebhookが追加されます(グループのWebhookには有料のGitLabプランが必要なため、Webhookはグループ内のすべてのプロジェクトに追加されます)。無効にすると、それらのランナーは削除されます。接続解除を行うと、すべてのランナーが削除されます。GitLabのそれ以外の部分は変更されません。

3. ジョブにタグを追加します。 .gitlab-ci.yml で:

test:
  tags: [compiler-8cpu]
  script:
    - npm test

Claude を接続(MCP)

compiler.dev はリモートのMCPサーバーを提供しているため、Claude から CI の状況を確認し、操作できます。たとえば、夜間に失敗した内容を尋ねたり、ジョブログの末尾を読んだり、失敗したジョブを再実行したり、利用状況とクレジットを確認したりできます。URL はhttps://ci.compiler.dev/mcpです。

Web 版の Claude と Claude Desktop。

Claude Code。Claude に接続でトークンを作成し、次のコマンドを実行します:

claude mcp add --transport http compiler https://ci.compiler.dev/mcp --header "Authorization: Bearer <your token>"

Claude にできること

通知。セッションが開いていない場合、サーバーから Claude を起動することはできません。そのため compiler.dev では、お客様向けのフィードを保持しています(ジョブの失敗、失敗していたジョブの修正、クレジット残高の不足、利用上限への到達、Jumbo レポートの準備完了など。30 日間保存されます)。Claude は次に接続したとき、またはお客様が尋ねたとき(「CI に新しいことはある?」など)に、recent_eventsまたはcompiler://eventsリソースを通じてこれを確認します。セッションを開いたままにし、そのリソースを購読しているアプリには、直ちに通知されます。フィードに含めるイベントはClaude に接続で選択できます。

取り消し。同じページで Claude の接続を解除するか、トークンを取り消してください。取り消したトークンは直ちに使用できなくなります。トークンはハッシュ化して保存されるため、再度表示することはできません。

課金

利用状況の分析とデータ

当社は、サービスの運用と利用状況ダッシュボードの提供のために、製品および CI のイベントを記録します。たとえば、ジョブのキュー投入、開始、終了(所要時間を含む)、キャッシュヒット、オンボーディングの各ステップ、ページビューなどです。イベントにはリポジトリ名、ジョブ名、所要時間、件数が含まれますが、ソースコード、シークレット、メールアドレスは含まれません。ユーザーは内部のユーザー ID のみで識別されます。組織のイベントはその組織のみが閲覧でき、2 年間保存されます。

コードレビューとインサイトのデータ処理者

Code review または Insights を有効にすると、次の外部サービスがお客様のデータを処理します。

設定 → 機能 で Code review または Insights を無効にすると、これらのサービスには何も送信されません。

ヘルプ

ご不明な点や移行できないジョブがある場合は、contact@compiler.dev までメールでお問い合わせください。