Saltar al contenido

Documentación de compiler.dev

compiler.dev ejecuta sus jobs existentes de GitHub Actions en máquinas Linux rápidas y aisladas. Usted conserva GitHub Actions y sus checks; solo cambia la máquina. Con la configuración enrutada, si compiler.dev no puede aceptar un job, o si su crédito o su límite mensual se agota, el job se ejecuta en el runner que usaba antes de cambiar, ya sea alojado por GitHub o propio. La etiqueta de una sola línea runs-on: compiler-8cpu funciona una vez instalada la GitHub App, pero no tiene fallback automático: el job espera a un runner de compiler.dev (consulte etiquetas de tamaño).

Primeros pasos

1. Inicie sesión e instale la GitHub App. Inicie sesión con GitHub y, a continuación, instale la App de compiler.dev en su organización y elija los repositorios que podrá ver. La App lee los flujos de trabajo y los metadatos de los trabajos, registra runners de un solo uso para los trabajos enrutados a compiler.dev y, solo a través de la pull request de configuración, propone cambios en los flujos de trabajo. Nunca fusiona nada.

2. Elija un repositorio y un modo. Analizamos sus flujos de trabajo y mostramos qué trabajos se pueden mover. Elija Probar con seguridad (comparación: una copia se ejecuta en nuestras máquinas y sus resultados siguen viniendo de sus runners) o Cambiar ahora con el 10 %, 25 %, 50 % o 100 % de las pull requests. Una PR permanece en el mismo lado para todos sus pushes y reejecuciones.

3. Fusione la pull request de configuración. Cada flujo de trabajo enrutado recibe un pequeño trabajo compiler-route que consulta a compiler.dev dónde debe ejecutarse el trabajo; sus trabajos usan su respuesta como runs-on. Sus pasos no cambian. Nada se mueve hasta que la PR se fusiona.

4. Observe la primera ejecución. La aplicación muestra cada trabajo en tiempo real (en cola, arrancando, en ejecución, terminado), con el nombre de la máquina y la duración comparada con sus runners anteriores.

Qué trabajos se pueden mover

Respaldo y reversión

Caché de compilación (Nx / Turborepo)

En los runners de compiler.dev, Nx (20.8+) y Turborepo usan automáticamente una caché remota junto a los runners, sin que tenga que cambiar nada en sus workflows. Las cachés están aisladas por repositorio; las pull requests pueden leer la caché de la rama por defecto, pero solo escribir en la suya, de modo que una PR nunca puede inyectar artefactos en builds de confianza. Para desactivarla en un job, defina NX_SELF_HOSTED_REMOTE_CACHE_SERVER: "" and/or TURBO_API: "" en el env: de ese job.

OIDC con AWS

OIDC permite que un job obtenga credenciales temporales de AWS sin guardar una clave de acceso en GitHub. En cada ejecución, GitHub emite un token firmado y AWS lo cambia por credenciales temporales. El flujo del token es el estándar de GitHub Actions, así que el workflow siguiente es el habitual con la etiqueta runs-on de compiler.dev. Para una guía más detallada, consulte OIDC de GitHub Actions a AWS.

1. Añada GitHub como proveedor de identidad en IAM. URL del proveedor https://token.actions.githubusercontent.com, audiencia sts.amazonaws.com.

2. Cree un rol con esta política de confianza. Sustituya 111122223333, ORG y REPO. La condición sub es la que impide el acceso a otros repositorios y ramas, así que configúrela siempre.

{
  "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. Use el rol en su workflow. El job necesita 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 con Google Cloud

La federación de identidades de carga de trabajo permite que un job actúe como una cuenta de servicio de Google Cloud sin almacenar un archivo de clave. En cada ejecución, GitHub emite un token firmado y Google lo intercambia por credenciales de corta duración. El flujo de tokens es el estándar de GitHub Actions, por lo que el workflow siguiente es el habitual con la etiqueta runs-on de compiler.dev.

1. Cree un pool de identidades de carga de trabajo y un proveedor de GitHub. Emisor https://token.actions.githubusercontent.com. Asigne los claims a atributos y añada una condición para que solo se acepte su repositorio:

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. Permita que ese repositorio use una cuenta de servicio. Conceda roles/iam.workloadIdentityUser sobre la cuenta de servicio al conjunto de principales del repositorio:

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

3. Úselo en su workflow. El job necesita 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

Empiece con su máquina

Code in a box es su propia máquina Linux para agentes de programación (4 vCPU, 16 GB, disco de 100 GB). Claude Code o Codex trabaja en ella sobre sus repositorios; usted supervisa, dirige y abre la pull request. El disco persiste, así que los repositorios, los worktrees y las sesiones del agente seguirán ahí la próxima vez.

1. Inicie sesión. Inicie sesión con GitHub e instale la aplicación de compiler.dev en su organización (la misma aplicación que para CI). Su organización necesita crédito prepagado; si no tiene, la tarjeta del box muestra Añada crédito para iniciar su box con un enlace a Facturación.

2. Añada una clave. Abra Espacios de trabajo (o Empiece a programar en su box en la Descripción general) y cree su box. Después, pegue su propia clave: una clave de Anthropic para Claude Code (desde console.anthropic.com → API keys) o una clave de OpenAI para Codex (desde platform.openai.com → API keys). Las claves se almacenan cifradas, se envían solo a su box y no se vuelven a mostrar. El uso del modelo lo factura Anthropic u OpenAI directamente a usted.

3. Inicie el box. El primer arranque tarda alrededor de un minuto; después, Iniciar reanuda un box detenido en unos 15 segundos. Enviar un prompt a un box detenido también lo inicia.

4. Chatee. Elija un repositorio y el agente, describa el cambio y pulse Iniciar chat. Cada chat tiene su propio git worktree en la rama ws/…. Verá en directo los mensajes y comandos del agente, después las pruebas que ejecutó y el diff; envíe un mensaje de seguimiento para el siguiente cambio o abra la pull request. Hasta 3 agentes pueden trabajar en su box a la vez.

5. Abra en otro dispositivo. Abrir en otro dispositivo genera un enlace de un solo uso, válido durante 5 minutos, que abre los mismos chats en otro navegador (por ejemplo, su teléfono) durante 12 horas sin iniciar sesión allí. Cerrar sesión en otros dispositivos finaliza esas sesiones.

6. Detenga. Pulse Detener cuando termine, o simplemente déjelo: el box se detiene solo tras 60 minutos sin ningún agente trabajando y sin nadie en un chat abierto. Una pestaña que dejó abierta en segundo plano, o que no ha tocado durante 30 minutos, no lo mantiene activo. Detener conserva el disco; eliminar el box elimina el disco.

Menos tokens. Los agentes en un box ejecutan sus comandos de shell a través de RTK, que compacta la salida de compilaciones, pruebas y git antes de que el modelo la lea (normalmente entre un 60 y un 90 % menos). Ejecute rtk gain en el box para ver cuánto ha ahorrado. Para omitirlo en un solo comando, empiece el comando con RTK_DISABLED=1. Para desactivarlo en el box, ejecute rtk init -g --uninstall y rtk init -g --codex --uninstall; los agentes verán entonces la salida sin procesar, y el box no la volverá a activar hasta que publiquemos una versión más reciente de RTK.

GitLab (beta)

Ejecute sus trabajos de GitLab CI en las máquinas de compiler.dev añadiendo una etiqueta al trabajo. Funciona con proyectos y grupos en gitlab.com. Para GitLab autoalojado, escríbanos a contact@compiler.dev. Esta es una beta cerrada: la página GitLab (beta) aparece en la sección de CI del menú de la aplicación cuando la activamos para su organización.

1. Conecte. Abra GitLab (beta) en la aplicación y pulse Connect GitLab. Inicie sesión en GitLab y apruebe el acceso. compiler.dev solicita el ámbito api (GitLab no ofrece un ámbito más restringido que permita crear runners y webhooks) y read_user. El token se almacena cifrado y no volverá a mostrarse. Para activar algo necesita el rol de Owner en un grupo o el rol de Maintainer en un proyecto.

2. Active un grupo o proyecto. La página muestra los grupos de los que es propietario y los proyectos que mantiene, cada uno con un interruptor. Al activar uno, se crean en GitLab cuatro runners, uno por tamaño, y se añade un webhook de Job events (en cada proyecto del grupo, porque los webhooks de grupo requieren un plan de pago de GitLab). Al desactivarlo, se eliminan de nuevo; Disconnect hace lo mismo con todo. El resto de su GitLab no se modifica.

3. Añada una etiqueta al trabajo. En .gitlab-ci.yml:

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

Conecte Claude (MCP)

compiler.dev dispone de un servidor MCP remoto, para que pueda ver su CI y actuar sobre él desde Claude: consultar qué falló durante la noche, leer las últimas líneas del registro de un job, volver a ejecutar los jobs fallidos y revisar el consumo y los créditos. La URL es https://ci.compiler.dev/mcp.

Claude en la web y Claude Desktop.

Claude Code. Cree un token en Conectar con Claude y ejecute:

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

Lo que puede hacer Claude.

Notificaciones. Un servidor no puede despertar a Claude cuando no hay ninguna sesión abierta. compiler.dev mantiene un feed para usted (un job ha fallado, un job fallido se ha corregido, el crédito es bajo, se ha alcanzado el límite de gasto, un informe de Jumbo está listo; se conserva 30 días). Claude lo ve la próxima vez que se conecta o cuando usted lo pide («¿hay algo nuevo en CI?»), a través de recent_events o del recurso compiler://events. Las aplicaciones que mantienen una sesión abierta y se suscriben a ese recurso reciben la notificación de inmediato. Elija qué eventos entran en el feed en Conectar con Claude.

Revocar. Desconecte Claude o revoque un token desde la misma página; deja de funcionar de inmediato. Los tokens se almacenan con hash, por lo que no podemos volver a mostrarlos.

Facturación

Analíticas de uso y sus datos

Registramos eventos de producto y de CI (por ejemplo, un job en cola, iniciado y finalizado con su duración, aciertos de caché, pasos de incorporación y visitas a páginas) para prestar el servicio y alimentar sus paneles de uso. Los eventos contienen nombres de repositorios y de jobs, tiempos y recuentos, nunca código fuente, secretos ni direcciones de correo electrónico; las personas se identifican únicamente mediante un id de usuario interno. Los eventos de su organización solo son visibles para su organización y se conservan durante dos años.

Encargados del tratamiento de datos para Code review e Insights

Estos servicios externos procesan sus datos cuando Code review o Insights están activados:

Si desactiva Code review o Insights en Settings → Features, no se envía nada a estos servicios.

Ayuda

¿Tiene preguntas o un job que no se puede migrar? Escriba a contact@compiler.dev.