Bitbucket Pipelines YAML Examples

Production-ready bitbucket-pipelines.yml configurations covering build, test, and deploy workflows with branch-specific steps and Atlassian Marketplace pipes.

About Bitbucket Pipelines

Bitbucket Pipelines is the built-in CI/CD system for Bitbucket Cloud repositories. Pipelines are configured via a bitbucket-pipelines.yml file at the root of your repository. The file defines a global image (the Docker image used by all steps unless overridden), and a pipelines section that can include a default pipeline (runs on every push to any branch), branches pipelines (run on matching branches), pull-requests pipelines, and more.

Bitbucket Pipelines supports pipes — pre-built integrations published to the Atlassian Marketplace that wrap complex deployment tasks (like syncing to S3, deploying to Kubernetes, or sending Slack notifications) into a single YAML step. This makes it possible to set up a complete deploy pipeline without writing custom shell scripts. Caching is also built-in, with predefined cache definitions for common tools like Node.js, Python, Maven, and Gradle.

Examples

🔨

Basic Build

Default pipeline with npm install and test, plus a main-branch deploy step that pushes compiled assets to AWS S3 via an Atlassian pipe.

bitbucket-pipelines.yml

🛠 Paste this YAML into the validator to check it instantly.

Open Validator →

Browse all categories

GitHub Actions · GitLab CI · CircleCI · Bitbucket Pipelines · Docker Compose · Kubernetes · Helm · Ansible