GitLab CI to Bitbucket Pipelines Converter

Convert .gitlab-ci.yml to bitbucket-pipelines.yml. Translates stages, jobs, rules, parallel matrix, cache, and artifacts to Bitbucket's pipelines/branches/tags model.

Migrating from GitLab CI to Bitbucket Pipelines

GitLab's flexible `rules:` system condenses into Bitbucket's simpler trigger taxonomy: `pipelines.default` (every push), `pipelines.branches.<pattern>`, `pipelines.tags.<pattern>`, `pipelines.pull-requests.<pattern>`, and `pipelines.custom.<name>` (manual). The converter routes each GitLab job to the most-specific Bitbucket section that fits its rules.

Syntax cheat sheet

ConceptGitLab CIBitbucket Pipelines
Triggerrules: - if: $CI_COMMIT_BRANCH == "main"pipelines: branches: main:
Stagestages: [test, deploy](implicit via step order)
Cachecache: paths: [node_modules]- step: caches: [node]
Artifactartifacts: paths: [dist]- step: artifacts: [dist/**]
Manual jobwhen: manual- step: trigger: manual

Gotchas to watch for

  • warning

    Stages collapse to step order

    Bitbucket has no notion of stages. The converter chains jobs sequentially or wraps siblings in `parallel:`.

  • warning

    Custom cache definitions

    When GitLab cache paths don't match a built-in Bitbucket cache, the converter recommends declaring a custom cache in `definitions.caches:` at the top of the file.

  • warning

    Schedules require UI configuration

    Schedule rules become a comment in the Bitbucket output, since schedules live in repository settings.

Worked examples

GitLab Node test → Bitbucket

Single stage, single step.

GitLab CI
stages:
  - test
test:
  stage: test
  image: node:20
  script:
    - npm ci
    - npm test
Bitbucket Pipelines
image: node:20
pipelines:
  default:
    - step:
        name: test
        script:
          - npm ci
          - npm test

Frequently asked questions

Does it convert GitLab Pages?expand_more

No. Bitbucket has no equivalent of GitLab Pages. The converter flags such jobs as unsupported.

How are GitLab services handled?expand_more

GitLab `services:` (e.g. postgres) become a recommendation to declare a Bitbucket `definitions.services:` block. Reference the service from your step's `services:` list.

Related Tools

data_object

YAML Formatter

Format and validate YAML. Convert YAML to JSON or JSON to YAML. Supports 2 and 4 space indentation.

timer

Cron Builder

Visual builder for cron-job schedules.

filter_list_off

Gitignore Generator

Generate .gitignore files for any language, framework, or IDE — 100+ templates, 100% client-side.

schema

JSON Schema Generator

Generate a JSON Schema from one or more sample JSONs — drafts 2020-12, 2019-09, 7, 6, 4. Detects formats (date-time, email, uuid, ipv4, uri), extracts $defs, validates with AJV, and exports to YAML, TypeScript, and Zod. 100% in your browser.

auto_awesome

AI Coding Rules

Curated rules-file library and generator for Cursor, Claude Code, GitHub Copilot, Windsurf, Cline, Aider, Continue, and Cody. Browse 20 hand-crafted .cursorrules / CLAUDE.md / copilot-instructions.md files for popular stacks, build a custom one with the wizard, or convert any rules file between AI-tool formats.