Zum Inhalt springen

compiler.dev Dokumentation

compiler.dev führt Ihre bestehenden GitHub Actions Jobs auf schnellen, isolierten Linux-Maschinen aus. Sie behalten GitHub Actions und Ihre Checks; nur die Maschine ändert sich. Beim gerouteten Setup gilt: Kann compiler.dev einen Job nicht übernehmen oder ist Ihr Guthaben bzw. Ihr monatliches Limit aufgebraucht, läuft der Job auf dem Runner, den Sie vor der Umstellung verwendet haben, egal ob GitHub-gehostet oder selbst betrieben. Das einzeilige runs-on: compiler-8cpu-Label funktioniert, sobald die GitHub App installiert ist, hat aber keinen automatischen Fallback: Der Job wartet auf einen compiler.dev Runner (siehe Größen-Labels).

Erste Schritte

1. Anmelden und GitHub App installieren. Mit GitHub anmelden, dann installieren Sie die compiler.dev App für Ihre Organisation und wählen die Repositories aus, die sie sehen darf. Die App liest Workflows und Job-Metadaten, registriert einmalige Runner für Jobs, die zu compiler.dev geroutet werden, und schlägt – nur über den Setup-PR – Workflow-Änderungen vor. Sie führt nie selbst Merges durch.

2. Repository und Modus wählen. Wir analysieren die Workflows und zeigen, welche Jobs verschoben werden können. Wählen Sie Sicher testen (Vergleich: Eine Kopie läuft auf unseren Maschinen, Ihre Ergebnisse stammen weiterhin von Ihren Runnern) oder Jetzt umstellen mit 10 %, 25 %, 50 % oder 100 % der Pull Requests. Ein PR bleibt für alle seine Pushes und Re-Runs auf derselben Seite.

3. Setup-PR mergen. Jeder geroutete Workflow erhält einen kleinen compiler-route-Job, der bei compiler.dev anfragt, wo der Job laufen soll; Ihre Jobs übernehmen diese Antwort als runs-on. Ihre Schritte bleiben unverändert. Bis der PR gemergt ist, wird nichts verschoben.

4. Den ersten Lauf beobachten. Die App zeigt jeden Job live – eingereiht, startend, laufend, fertig – mit dem Maschinennamen und der Dauer im Vergleich zu Ihren bisherigen Runnern.

Welche Jobs verschoben werden können

Fallback & Rollback

Build-Cache (Nx / Turborepo)

On compiler.dev runners, Nx (20.8+) and Turborepo automatically use a remote cache next to the runners — nothing to change in your workflows. Caches are isolated per repository; pull requests can read the default branch's cache but only write their own, so a PR can never inject artifacts into trusted builds. To opt out for a job, set NX_SELF_HOSTED_REMOTE_CACHE_SERVER: "" and/or TURBO_API: "" in that job's env:.

OIDC mit AWS

OIDC ermöglicht einem Job kurzlebige AWS-Zugangsdaten, ohne dass ein Zugriffsschlüssel in GitHub gespeichert werden muss. Bei jedem Lauf fordert GitHub ein signiertes Token an, und AWS tauscht es gegen temporäre Zugangsdaten. Der Token-Ablauf entspricht dem Standard von GitHub Actions, daher ist der folgende Workflow der übliche mit dem compiler.dev-runs-on-Label. Eine ausführlichere Anleitung finden Sie unter GitHub Actions OIDC zu AWS.

1. Fügen Sie GitHub in IAM als Identity Provider hinzu. Provider-URL https://token.actions.githubusercontent.com, Audience sts.amazonaws.com.

2. Erstellen Sie eine Rolle mit dieser Trust-Policy. Ersetzen Sie 111122223333, ORG und REPO. Die sub-Bedingung verhindert, dass andere Repositories und Branches zugreifen, setzen Sie sie daher immer.

{
  "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. Verwenden Sie die Rolle in Ihrem Workflow. Der Job benötigt 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

OIDC mit Google Cloud

Mit Workload Identity Federation kann ein Job als Google-Cloud-Dienstkonto agieren, ohne eine gespeicherte Schlüsseldatei. Jeder Lauf fordert von GitHub ein signiertes Token an, und Google tauscht es gegen kurzlebige Anmeldedaten ein. Der Token-Ablauf entspricht dem Standard von GitHub Actions, daher ist der folgende Workflow der übliche mit dem compiler.dev-Label runs-on.

1. Erstellen Sie einen Workload-Identity-Pool und einen GitHub-Provider. Aussteller https://token.actions.githubusercontent.com. Ordnen Sie Claims Attributen zu und fügen Sie eine Bedingung hinzu, damit nur Ihr Repository akzeptiert wird:

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. Lassen Sie dieses Repository ein Dienstkonto verwenden. Gewähren Sie roles/iam.workloadIdentityUser auf dem Dienstkonto für das Principal-Set des Repositorys:

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

3. Verwenden Sie es in Ihrem Workflow. Der Job benötigt 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

Starten Sie mit Ihrer Box

Code in a box ist Ihre eigene Linux-Maschine für Coding-Agents (4 vCPU, 16 GB, 100 GB Speicherplatz). Claude Code oder Codex arbeitet darin an Ihren Repositories; Sie beobachten, steuern und öffnen den Pull Request. Der Speicherplatz bleibt erhalten, sodass Repositories, Worktrees und Agent-Sitzungen beim nächsten Mal noch vorhanden sind.

1. Anmelden. Mit GitHub anmelden und die compiler.dev App in Ihrer Organisation installieren (dieselbe App wie für CI). Ihre Organisation benötigt Guthaben im Voraus; ist keines vorhanden, zeigt die Box-Karte Guthaben hinzufügen, um Ihre Box zu starten mit einem Link zur Abrechnung an.

2. Schlüssel hinzufügen. Öffnen Sie Workspaces (oder Mit dem Coding in Ihrer Box beginnen auf der Übersicht) und erstellen Sie Ihre Box. Fügen Sie anschließend Ihren eigenen Schlüssel ein: einen Anthropic-Schlüssel für Claude Code (unter console.anthropic.com → API keys) oder einen OpenAI-Schlüssel für Codex (unter platform.openai.com → API keys). Schlüssel werden verschlüsselt gespeichert, nur an Ihre Box gesendet und nie erneut angezeigt. Die Modellnutzung wird Ihnen direkt von Anthropic bzw. OpenAI berechnet.

3. Starten. Der erste Start dauert etwa eine Minute; danach nimmt Starten eine angehaltene Box in etwa 15 Sekunden wieder auf. Das Senden eines Prompts an eine angehaltene Box startet sie ebenfalls.

4. Chatten. Wählen Sie ein Repository und den Agenten, beschreiben Sie die Änderung und drücken Sie Chat starten. Jeder Chat erhält einen eigenen Git-Worktree auf dem Branch ws/…. Sie sehen die Nachrichten und Befehle des Agenten live, danach die ausgeführten Tests und den Diff; senden Sie eine Folgeanfrage für die nächste Änderung oder öffnen Sie den Pull Request. Bis zu 3 Agenten können gleichzeitig auf Ihrer Box arbeiten.

5. Auf einem anderen Gerät öffnen. Auf einem anderen Gerät öffnen erstellt einen einmaligen Link, der 5 Minuten gültig ist und es ermöglicht, dieselben Chats in einem anderen Browser (z. B. auf Ihrem Smartphone) 12 Stunden lang ohne Anmeldung dort zu öffnen. Andere Geräte abmelden beendet diese Sitzungen.

6. Anhalten. Drücken Sie Anhalten, wenn Sie fertig sind, oder lassen Sie es einfach: Die Box hält sich nach 60 Minuten von selbst an, wenn kein Agent arbeitet und niemand in einem geöffneten Chat ist. Ein im Hintergrund offener Tab, der 30 Minuten lang nicht berührt wurde, hält sie nicht wach. Anhalten behält den Speicherplatz; das Löschen der Box löscht auch den Speicherplatz.

Weniger Tokens. Agenten in einer Box führen ihre Shell-Befehle über RTK aus, das die Ausgabe von Builds, Tests und Git verdichtet, bevor das Modell sie liest (typischerweise 60–90 % weniger). Führen Sie rtk gain in der Box aus, um zu sehen, wie viel eingespart wurde. Um es für einen einzelnen Befehl zu umgehen, stellen Sie dem Befehl RTK_DISABLED=1 voran. Um es für die Box zu deaktivieren, führen Sie rtk init -g --uninstall und rtk init -g --codex --uninstall aus; die Agenten sehen dann die unverarbeitete Ausgabe, und die Box aktiviert sie nicht wieder, bis wir eine neuere RTK-Version ausliefern.

GitLab (Beta)

Führen Sie Ihre GitLab-CI-Jobs auf compiler.dev-Maschinen aus, indem Sie dem Job einen Tag hinzufügen. Das funktioniert für Projekte und Gruppen auf gitlab.com. Selbstverwaltetes GitLab: Fragen Sie uns unter contact@compiler.dev. Dies ist eine geschlossene Beta: Die Seite GitLab (Beta) erscheint im CI-Bereich des Menüs der App, sobald wir sie für Ihre Organisation aktivieren.

1. Verbinden. Öffnen Sie GitLab (Beta) in der App und klicken Sie auf GitLab verbinden. Sie melden sich bei GitLab an und bestätigen. compiler.dev fordert den Scope api an (GitLab bietet keinen engeren Scope, mit dem Runner und Webhooks erstellt werden können) sowie read_user. Das Token wird verschlüsselt gespeichert und nie erneut angezeigt. Zum Aktivieren benötigen Sie die Rolle Owner für eine Gruppe oder die Rolle Maintainer für ein Projekt.

2. Gruppe oder Projekt aktivieren. Die Seite listet die Gruppen, deren Owner Sie sind, und die Projekte, die Sie pflegen, jeweils mit einem Schalter. Das Aktivieren eines Eintrags erstellt in GitLab vier Runner, einen pro Größe, und fügt einen Webhook für Job events hinzu (bei Gruppen für jedes Projekt der Gruppe, da Gruppen-Webhooks einen kostenpflichtigen GitLab-Tarif erfordern). Das Deaktivieren löscht sie wieder, und Trennen entfernt alles. Nichts anderes in Ihrem GitLab wird verändert.

3. Dem Job einen Tag hinzufügen. In .gitlab-ci.yml:

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

Claude verbinden (MCP)

compiler.dev verfügt über einen entfernten MCP-Server, sodass Sie Ihre CI direkt aus Claude heraus einsehen und steuern können: Fragen Sie, was über Nacht fehlgeschlagen ist, lesen Sie das Ende eines Job-Logs, führen Sie fehlgeschlagene Jobs erneut aus und prüfen Sie Nutzung und Guthaben. Die URL lautet https://ci.compiler.dev/mcp.

Claude im Web und Claude Desktop.

Claude Code. Erstellen Sie unter Mit Claude verbinden ein Token und führen Sie aus:

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

Was Claude tun kann.

Benachrichtigungen. Ein Server kann Claude nicht wecken, wenn keine Sitzung offen ist. compiler.dev führt für Sie einen Feed (ein Job ist fehlgeschlagen, ein fehlschlagender Job wurde behoben, das Guthaben ist niedrig, das Ausgabenlimit wurde erreicht, ein Jumbo-Bericht ist bereit; 30 Tage gespeichert). Claude sieht ihn, wenn er sich das nächste Mal verbindet oder wenn Sie fragen („Gibt es etwas Neues in der CI?“), über recent_events oder die Ressource compiler://events. Apps, die eine Sitzung offen halten und diese Ressource abonnieren, werden sofort benachrichtigt. Welche Events in den Feed aufgenommen werden, wählen Sie unter Mit Claude verbinden.

Widerrufen. Trennen Sie Claude oder widerrufen Sie ein Token auf derselben Seite; es funktioniert sofort nicht mehr. Tokens werden gehasht gespeichert, daher können wir sie nicht erneut anzeigen.

Abrechnung

Nutzungsanalysen & Ihre Daten

Wir erfassen Produkt- und CI-Ereignisse (zum Beispiel Job in Warteschlange, gestartet und beendet mit Dauer, Cache-Treffer, Onboarding-Schritte und Seitenaufrufe), um den Dienst zu betreiben und Ihre Nutzungsdashboards zu speisen. Ereignisse enthalten Repository- und Job-Namen, Zeiten und Anzahlen, niemals Quellcode, Secrets oder E-Mail-Adressen; Personen werden ausschließlich über eine interne Benutzer-ID identifiziert. Die Ereignisse Ihrer Organisation sind nur für Ihre Organisation sichtbar und werden zwei Jahre lang aufbewahrt.

Auftragsverarbeiter für Code-Review und Insights

Wenn Code-Review oder Insights aktiviert ist, verarbeiten folgende externe Dienste Ihre Daten:

Wenn Sie Code-Review oder Insights unter Einstellungen → Funktionen deaktivieren, werden keine Daten an diese Dienste gesendet.

Hilfe

Fragen oder ein Job, der nicht umzieht? Schreiben Sie an contact@compiler.dev.