Configure Bitbucket CI/CD Pipelines

This skill provides expert guidance for configuring Bitbucket Pipelines CI/CD workflows using bitbucket-pipelines.yml. It delivers YAML templates for multi-stage builds, parallel test execution, caching strategies, Docker integration, and deployment automation to AWS, Kubernetes, and other platforms. The agent specializes in optimization techniques that reduce build times and improve pipeline reliability.

Use this skill when you need to set up or optimize Bitbucket Pipelines for Node.js, Docker, or multi-language projects with complex deployment requirements. It handles scenarios with parallel test execution, custom cache definitions, and multi-environment deployments with manual production triggers. Use it when integrating with AWS S3/CloudFront, Kubernetes clusters, or Docker registries.

Do NOT use this skill if you're working with GitHub Actions, GitLab CI, or other CI/CD platforms - it is Bitbucket-specific. Avoid it if you need simple single-step pipelines without caching or deployment complexity, as the templates assume intermediate to advanced CI/CD requirements.

You provide your project requirements: programming language/framework, testing strategy, deployment targets (staging/production), cloud provider (AWS, Kubernetes), caching needs, and whether you need Docker builds or parallel execution. The skill returns bitbucket-pipelines.yml configurations with image selections, cache definitions, script commands, artifact management, and deployment steps.

The skill provides configurations for Docker (multi-stage builds, registry push), AWS services (S3, CloudFront, CLI configuration), Kubernetes (kubectl deployment, rollout status), PostgreSQL service containers for integration testing, and Node.js package managers (npm with offline caching). It supports cache definitions for Gradle, Maven, Cypress, and Next.js build caches.

DevOps engineers and platform teams managing Bitbucket-based CI/CD pipelines for production applications. Frontend developers deploying Node.js applications to AWS or containerized environments. Backend teams requiring database integration tests with service containers. Release managers who need manual production deployment gates and multi-environment promotion workflows.

Here's a basic pipeline configuration example:

image: node:18

pipelines:
  default:
    - step:
        name: Build and Test
        caches:
          - node
        script:
          - npm ci
          - npm run test
          - npm run build
        artifacts:
          - dist/**
  branches:
    master:
      - step:
          name: Deploy to Production
          deployment: production
          script:
            - echo "Deploying to production"
    develop:
      - step:
          name: Deploy to Staging
          deployment: staging
          script:
            - echo "Deploying to staging"

The skill emphasizes security best practices including repository variables for secrets, secured variables for production, and validation of environment variables before use. It provides error handling patterns with proper exit codes, debugging information, and cleanup tasks using after-script blocks.