Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Bitbucket Pipelines PreviewNew to Visual Studio Code? Get it now.
Bitbucket Pipelines Preview

Bitbucket Pipelines Preview

lucqa-it

|
1 install
| (0) | Free
Previsualiza bitbucket-pipelines.yml con una vista similar a Bitbucket Pipelines
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

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).

Lista de ejecuciones

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
Diálogo Run Pipeline Simulación
Ejecución real con log en vivo Configuración del pipeline
Log de una ejecución real Configuración

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

  1. Abre un archivo bitbucket-pipelines.yml (o cualquier bitbucket-pipelines*.yml).
  2. Pulsa el ícono de preview en la barra del editor, o ejecuta Bitbucket: Open Pipeline Preview desde la paleta de comandos.
  3. 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.

Sin ejecuciones

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:

  1. 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).

  2. 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).
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft