Configurar Bitbucket Pipelines
Estado: ⚠️ El pipeline de NEO está generado y usa el engine real, pero hoy no se dispara solo cuando un PR tiene un label. Bitbucket no permite filtrar por label dentro del YAML, y el componente que lo haría desde afuera (un webhook handler) todavía no está implementado. Mientras tanto, el pipeline se lanza a mano.
Valor en qa-stack.yaml |
stack.pipeline_provider: bitbucket |
| Archivo | bitbucket-pipelines.yml (en la raíz: Bitbucket no permite otro lugar) |
| Copia de referencia | .bitbucket/neo-ci-jobs/neo-ci-manager.yml (Bitbucket no la lee) |
Pipeline de NEO |
custom → qa-feature-e2e |
| Cómo se dispara | A mano, desde la interfaz de Bitbucket o por API |
| Imagen | registry.gitlab.crowdaronline.com/lippia/products/neo/crowdar-engine-mvp:c4cd2740-playwright (registry privado) |
1. Qué genera lippia-neo-ci-bootstrap
Si el repositorio no tiene bitbucket-pipelines.yml
Escribe el archivo completo en la raíz y guarda una copia idéntica en .bitbucket/neo-ci-jobs/neo-ci-manager.yml, solo como referencia.
Si el repositorio ya tiene bitbucket-pipelines.yml
Bitbucket no permite repartir el pipeline en varios archivos (no tiene include:), así que no hay una integración de una línea como en GitLab. lippia-neo-ci-bootstrap:
- Te muestra tu
bitbucket-pipelines.ymlactual y la fusión propuesta: tusdefinitions.stepsypipelines.custom.*, más los deNEO. - Te pide confirmación antes de escribir.
- Guarda igual la copia de referencia de la plantilla completa en
.bitbucket/neo-ci-jobs/.
Revisá bien el diff: si tu pipeline ya usa anchors o nombres de step iguales (
initial-setup,feature-e2e…), puede haber choques.
2. El pipeline de NEO
| Pipeline custom | Steps | Qué hace |
|---|---|---|
qa-feature-e2e |
initial-setup → feature-e2e |
Detecta el framework e instala dependencias. Después clona las skills, escribe .env.tests, lee el PR (neo event), ejecuta el plan feature-new-end-to-end, sube los resultados a una rama y comenta el resultado en el PR |
Dos particularidades de Bitbucket que explican cómo está armado:
- Cada step se ejecuta en un contenedor nuevo, y las variables de un step no pasan al siguiente. Por eso
initial-setupescribe un archivoci.env(que viaja como artifact) yfeature-e2elo carga. - No hay
when: alwaysa nivel de step, es decir, no se puede forzar que un step se ejecute si el anterior falló. Por eso el reporte se hace en elafter-scriptdefeature-e2e, que se ejecuta siempre, y no en un step aparte.
El archivo también trae pipelines de ejemplo del diseño anterior (
default,pull-requests/**,branches/main,qa-full,qa-scheduled,qa-ui-only,qa-api-only). Esos no usan el engine: solo hacenecho. Si no los necesitás, podés borrarlos para que no ejecuten en cada push.
3. Paso a paso
Paso 1 — Habilitar Pipelines
En Bitbucket: Repository settings → Pipelines → Settings → Enable Pipelines.
Paso 2 — Generar el archivo
Con qa-stack.yaml ya creado (pipeline_provider: bitbucket), pedile al asistente:
Generá el CI del proyecto con lippia-neo-ci-bootstrap
Revisá el archivo (o la fusión propuesta) y hacé commit.
Paso 3 — Cargar las variables
En Bitbucket: Repository settings → Pipelines → Repository variables.
| Variable | ¿Secured? | Para qué |
|---|---|---|
CROWDAR_REGISTRY_USER |
No | Usuario para descargar la imagen crowdar-engine-mvp del registry de GitLab de Crowdar |
CROWDAR_REGISTRY_TOKEN |
Sí | Token de ese usuario |
SKILLS_REPO_TOKEN |
Sí | Token con lectura de crowdar-qa-skills (está en GitLab) |
ANTHROPIC_API_KEY |
Sí | Modelos de Claude |
OPENAI_API_KEY |
Sí | Modelos de OpenAI, si el plan los usa |
CROWDAR_CI_TOKEN |
Sí | Comentar en el PR y subir la rama de resultados |
APP_USER / APP_PASSWORD |
APP_PASSWORD: Sí |
Usuario de prueba de la app |
APP_BASE_URL |
No | URL de la app bajo prueba |
Si las historias vienen de Jira o Azure DevOps, cargá también sus variables (ver la tabla general), con los tokens como Secured. Bitbucket expone las repository variables como variables de entorno en todos los steps, así que el engine las recibe sin tocar el YAML.
Paso 4 — Ejecutar el pipeline
Mientras no exista el disparo automático:
- Andá a Pipelines → Run pipeline.
- Elegí la rama del PR.
- Elegí el pipeline
custom: qa-feature-e2ey ejecutalo.
También se puede lanzar por la API de Bitbucket (POST /repositories/{workspace}/{repo_slug}/pipelines/) indicando ese pipeline custom.
⚠️ El step
feature-e2eusaneo event --provider bitbucketpara leer el PR. Si lo lanzás a mano sin un PR asociado, puede no encontrar los datos del PR. Lanzalo sobre la rama de un PR abierto.
Para ejecutarlo de forma programada
Los schedules de Bitbucket se configuran en la interfaz (Pipelines → Schedules), no en el YAML. El archivo trae un pipeline custom: qa-scheduled de referencia, pero es del diseño anterior y solo hace echo.
4. Problemas comunes (y qué hacer)
| Lo que ves | Por qué puede pasar | Qué hacer |
|---|---|---|
El pipeline de NEO no se ejecuta al poner un label |
Limitación actual: Bitbucket no filtra por label y el webhook todavía no existe | Lanzar qa-feature-e2e a mano (Paso 4) |
Ejecutan pipelines que solo hacen echo en cada push |
Son los pipelines de ejemplo del diseño anterior | Borrar default, pull-requests/** y branches/main si no los usás |
| Error al descargar la imagen | CROWDAR_REGISTRY_USER / CROWDAR_REGISTRY_TOKEN faltan o no tienen acceso |
Revisar las variables |
| Falla el clon de las skills | SKILLS_REPO_TOKEN falta o no tiene lectura |
Revisar la variable |
feature-e2e no encuentra el framework detectado |
No llegó el ci.env de initial-setup |
Ejecutar los dos steps juntos dentro del mismo pipeline qa-feature-e2e |
| No se abre el PR de resultados | El job sube la rama, pero no crea el PR | Abrir el PR a mano desde esa rama |
| Los resultados de una ejecución anterior no están | Los artifacts de Bitbucket viven solo dentro del mismo pipeline | Descargarlos al terminar cada ejecución |