Bitbucket

Deploy Bitbucket as a CI/CD tool in your environment so that you can observe the test runs from the CI Dashboard view and view links to the CI Dashboard view in Slack and Jenkins. 

To help you get started and as a point of reference, we have made a sample project available here.

Important: This document includes references to a third-party product, Atlassian Bitbucket. The user interface and usage of third-party products are subject to change without notice. For the latest published information about Atlassian Bitbucket, see https://confluence.atlassian.com/alldoc/bitbucket-server-documentation-directory-278071997.html.

Step-by-step instructions

Click a step to view details.

To sign up and try Bitbucket for free, follow the steps at https://bitbucket.org/account/signup.

  1. Log in to Bitbucket.

  2. On your own work tab, click Create repository.

  3. In a terminal window, do the following:
    1. Switch to your repository's directory.

    2. Connect your existing repository to Bitbucket with the following git commands:

      Copy
          git init
          git remote add origin https://<username>@bitbucket.org/<username>/<repo name>.git
          git add .
          git commit -m "first commit"    git push -u origin master

      where <username> refers to your Bitbucket username and <repo name> refers to the name of your repo in Bitbucket.

  1. On the Pipelines tab, do one of the following:

    • Select your preferred sample pipeline and click Commit file to automatically start the pipeline. For more information, see this Bitbucket article.

    • If you plan to reuse the bitbucket-pipelines.yml file or if you already have a pipeline in your project, click Enable.

  2. Validate your pipeline.yml file. You can use this validator.

  3. On the Settings tab, under Repository variables, use the Name and Value fields to provide the following information. Make sure to select the Secured checkbox for each name/value pair to securely store the values from the console.

    • The username for your Perfecto cloud

      You may want to skip securing the name of your Perfecto cloud. If you do secure it, the name will not show up in the Single Test Report URL that appears in the console.

    • Your Perfecto security token

      1. In the Perfecto UI at <YourCloud>.app.perfectomobile.com (where YourCloud is your actual cloud name, such as mobilecloud), click your user name and select My security token. 

      2. In the My security token form, click Generate Security Token.

      3. Click Copy to clipboard. Then paste it into any scripts that you want to run with Perfecto. 

      4. Click Close.
    • The slack_hook to store the Incoming Webhook URL of your Slack app. For more information on integrating with Slack, see this Slack article.
  4. Optionally, manually trigger the pipeline as follows:
    1. On the Pipeline tab, click Run pipeline.

    2. Select the branch and pipeline and click Run.

  5. To schedule jobs in Bitbucket, see this Bitbucket article.

  6. Review the results of the pipeline execution in the CI Dashboard view of the Perfecto UI.

    With Slack integration, you receive a link to the CI Dashboard in a Slack notification.

    To view the pipeline execution in our sample project, click here.

  1. To integrate with Jenkins:
    1. See the Jenkins with Maven article.

    2. Under source code management, set the Git repository to your Bitbucket repo URL and select your Bitbucket credentials.

  2. To integrate with Slack, see the Slack integration article.