Saltar a contenido

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:

  1. Te muestra tu bitbucket-pipelines.yml actual y la fusión propuesta: tus definitions.steps y pipelines.custom.*, más los de NEO.
  2. Te pide confirmación antes de escribir.
  3. 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-setup escribe un archivo ci.env (que viaja como artifact) y feature-e2e lo carga.
  • No hay when: always a 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 el after-script de feature-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 hacen echo. 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:

  1. Andá a Pipelines → Run pipeline.
  2. Elegí la rama del PR.
  3. Elegí el pipeline custom: qa-feature-e2e y ejecutalo.

También se puede lanzar por la API de Bitbucket (POST /repositories/{workspace}/{repo_slug}/pipelines/) indicando ese pipeline custom.

⚠️ El step feature-e2e usa neo event --provider bitbucket para 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