Bitbucket Pipelines Preview
Extensión de VS Code para ver, simular y ejecutar el bitbucket-pipelines.yml de tu repositorio sin salir del editor, con una interfaz inspirada en la vista de Pipelines de Bitbucket.
Las capturas usan datos ficticios (repositorio acme/platform-templates).

Qué hace
- Historial de ejecuciones: tus simulaciones locales y, si conectas tu cuenta, las ejecuciones reales del repositorio en Bitbucket, en una sola lista con Status, Started y Duration. Se actualiza sola (cada 5 s si hay algo en curso, cada 20 s si no).
- Run Pipeline: el mismo diálogo de Bitbucket (rama, pipeline, variables con sus
allowed-values y descripciones), con dos opciones:
- Simular: recorre los steps en orden, sin ejecutar nada, mostrando cada comando con tus variables ya sustituidas.
- Correr en Bitbucket: lanza el pipeline real (pide confirmación).
- Log en vivo de una ejecución real: dividido en Build setup, un bloque por comando y Build teardown, con colores ANSI, estado por sección y seguimiento del final del log.
- Stop / Rerun de ejecuciones reales.
- Configuración de cada pipeline: steps, imagen, servicios (con memoria de
definitions), OIDC, runners self-hosted, caches, artifacts y comandos.
- Datos del repo local: nombre del repo (del remote
origin), ramas reales, commit actual y autores recientes salen de git.
- Soporta
default, branches, tags, bookmarks, pull-requests y custom, además de parallel, stage, trigger: manual, anclas YAML (&/*/<<:) y after-script.
- Tema oscuro y claro según el tema de VS Code.
| Run Pipeline |
Simulación local |
 |
 |
| Ejecución real con log en vivo |
Configuración del pipeline |
 |
 |
Instalación
Desde el .vsix:
code --install-extension bitbucket-pipelines-preview-<versión>.vsix
O desde el código fuente:
npm install
npm run package # genera bitbucket-pipelines-preview-<versión>.vsix
code --install-extension bitbucket-pipelines-preview-*.vsix
Requiere VS Code 1.82 o superior y git en el PATH.
Uso
- Abre un archivo
bitbucket-pipelines.yml (o cualquier bitbucket-pipelines*.yml).
- Pulsa el ícono de preview en la barra del editor, o ejecuta Bitbucket: Open Pipeline Preview desde la paleta de comandos.
- Usa Run pipeline para simular o lanzar un pipeline. El preview se actualiza mientras editas el YAML; si el YAML es inválido, muestra el error y mantiene la última versión válida.

Conectar Bitbucket (opcional)
Sin conexión la extensión funciona igual para previsualizar y simular. Para ver las ejecuciones reales, sus logs y lanzar pipelines:
Crea un API token con scopes en id.atlassian.com → Security → API tokens → Create API token with scopes → Bitbucket, con:
read:pipeline:bitbucket — listar ejecuciones y leer logs
write:pipeline:bitbucket — lanzar y detener pipelines
read:repository:bitbucket
admin:pipeline:bitbucket no incluye lectura: los scopes de lectura y escritura deben marcarse explícitamente.
También sirve un Repository/Workspace Access Token con permisos Pipelines: Read y Write (deja el email vacío al conectarte).
En el preview pulsa Conectar Bitbucket e ingresa tu email de Atlassian y el token.
El workspace y el repositorio se toman del remote origin (git@bitbucket.org:<workspace>/<repo>.git o la URL HTTPS).
Seguridad
- El token se guarda en el almacenamiento cifrado de VS Code (
SecretStorage), nunca en archivos del proyecto ni en la configuración.
- Solo se habla con
api.bitbucket.org. La extensión no consulta Bitbucket por su cuenta salvo para refrescar la lista y el estado mientras el panel está visible.
- Si Bitbucket rechaza el token (401) se borra automáticamente. Para cambiarlo: botón Cambiar token o comando Bitbucket: Sign out (borrar token).
- Lanzar o detener un pipeline siempre pide confirmación.
Comandos
| Comando |
Descripción |
Bitbucket: Open Pipeline Preview |
Abre el preview del YAML activo. |
Bitbucket: Sign out (borrar token) |
Borra las credenciales guardadas. |
Limitaciones conocidas
- La simulación no ejecuta comandos: siempre termina en Successful y sus duraciones son ficticias. Sirve para revisar orden de steps, comandos y variables.
- En ejecuciones reales, el log se separa en secciones buscando la línea
+ <comando> que imprime Bitbucket; la API no da duración por comando, solo por step.
- No hay pestañas Docker, Metrics ni Artifacts (la API pública no expone esos datos de la misma forma).
- Los pipelines de
tags y pull-requests se pueden ver y simular, pero no lanzar desde la extensión.
- La lista de ramas usa las ramas locales y remotas ya descargadas: ejecuta
git fetch para ver ramas nuevas.
- El historial de simulaciones guarda las últimas 50 por archivo y workspace.
Desarrollo
npm install
npm test # pruebas del parser (node test.js)
Para depurar, abre la carpeta en VS Code y pulsa F5 (Run Extension): abre una ventana con sample/bitbucket-pipelines.yml, un YAML de ejemplo ficticio.
| Archivo |
Contenido |
extension.js |
Registro de comandos, panel webview, git y API de Bitbucket. |
parse.js |
Parser del YAML y utilidades puras (probadas en test.js). |
media/preview.html |
La interfaz completa (HTML, CSS y JS del webview). |
| |