BitBucket Pipelines for Customer Projects

This guide is intended for partners and customers who want to use their own BitBucket as their Git repository and CI/CD tool instead of GitLab.

Before you start, make sure you have sufficient rights in BitBucket.

  1. Select the right Git repository.

  2. Navigate to Repository settings > Pipelines > Repository variables.

  3. Click Variables and create variables PFX_USER and PFX_PASS:

    • Add the variable PFX_USER and set its value to pfx.deploy and click OK.

    • Add the variable PFX_PASS and set its value to be a strong password (at least 14 characters, at least 1 digit, at least 1 capital letter). Select Keep this value secret and click OK.

  4. Navigate to Repository settings > Pipelines > Deployments.

    1. Create required environments

    2. For each environments create variable for URL with partition url.

  5. Navigate to Repository settings > Pipelines > Settings.

    1. Enable Pipeline

    2. Click on “Configure bitbucket-pipelines.yml”

    3. Commit the yml file.

    4. Create a feature branch for Pipeline and fetch the yml file in intellij.

    5. Replace the existing code with following:

      image: maven:3.6-jdk-11 pipelines: branches: dev: - step: name: dev script: - mvn clean test -e --batch-mode - step: name: Deploy DEV deployment: DEV image: pricefx/pfxpackage script: - pfxpackage -import -timeout 120 -url $URL -user $PFX_USER -password $PFX_PASS -partition {partition-name} -from . $OPTIONS
    6. Replace the {partition-name} with dev partition name.

    7. Create the similar pipeline for other partitions if required.

    8. Add Pom.xml to the project

    9. Add the project as Maven project

    10. Commit the file and create the Pull request.

  6. Create a user account pfx.deploy in the target partitions (QA, PROD) and assign this user the General Admin privileges in each of the partitions where you want to enable deployment and set the password to be identical to the PFX_PASS variable.

  7. After merging the pull request for Pipeline branch with dev branch, Pipeline should start

Notes:

  • You should set name to correspond to your partition, eg. Deploy QA or Deploy PROD.

  • You must set the PARTITION and URL variables to the right values of your environment.

See also: https://support.atlassian.com/bitbucket-cloud/docs/bitbucket-pipelines-configuration-reference/

Found an issue in documentation? Write to us.