documentation
  • Introduction
    • Overview
      • Scandium Features & Concepts
  • Setting up your account
  • Create a test case
  • Supported Actions
  • File uploads
  • Assertions
  • Groups
  • Step settings
  • Variables
  • System Functions
  • Email Testing
  • Data-driven Testing
  • Test Suites
  • Results
    • Test results
    • Suite results
  • Why did my test fail?
  • API Testing
    • Getting Started
    • API Suites
    • Scheduling and Monitoring
  • Mobile Application Testing
    • Create a mobile project
    • Uploading Apps
      • Android
      • iOS
    • Testing mobile app
  • Common Testing Scenarios
  • Test Management
    • Tests and Folders
    • Tags
  • INTEGRATIONS
    • Continuous Integration (CI/CD)
    • Azure Devops
    • Bamboo CI
    • Bitbucket Pipelines
    • Circle CI
    • Github Actions
  • GitLab CI
  • Jenkins
  • Travis CI
Powered by GitBook
On this page
  • What You’ll Achieve
  • Prerequisites
  • Step 1: Set Your Bitbucket Repository Variables
  • Step 2: Create or Update Your bitbucket-pipelines.yml
  • Step 3: Push to Trigger
  • Troubleshooting Tips
  1. INTEGRATIONS

Bitbucket Pipelines

This guide will help you integrate Scandium into your Bitbucket Pipelines workflow. With just a few steps, you’ll be able to run automated tests from your Scandium test suite on every push or PR

PreviousBamboo CINextCircle CI

Last updated 23 days ago

What You’ll Achieve

By the end of this guide, your Bitbucket pipeline will:

  • Automatically run tests from a Scandium suite on every push or PR.

  • Display test results directly in the Bitbucket Pipelines logs.

Prerequisites

Before you begin, make sure you have:

  • A account with:

    • Your API_TOKEN

    • A PROJECT_ID and SUITE_ID

  • A Bitbucket repository with Pipelines enabled

  • A bitbucket-pipelines.yml file in your repository

Step 1: Set Your Bitbucket Repository Variables

  1. Go to your Bitbucket repository.

  2. Click Repository settings > Repository variables (under Pipelines).

  3. Add the following variables:

Variable Name

Description

API_TOKEN

Your Scandium API token

PROJECT_ID

Your Scandium project ID

SUITE_ID

Your Scandium test suite ID

HUB_URL

(Optional) Selenium Grid URL, if running on your infrastructure

STARTING_URL

(Optional) The URL your tests should start from. This will override all tests within the suite you are executing.

Step 2: Create or Update Your bitbucket-pipelines.yml

Create or update your bitbucket-pipelines.yml file with the following:

image: ubuntu:latest

pipelines:
  default:
    - step:
        name: Run Scandium Tests
        caches:
          - apt
        script:
          - apt-get update && apt-get install -y curl jq
          - SCRIPT_URL="https://raw.githubusercontent.com/GetScandium/files/refs/heads/main/scandium_script.sh"
          - curl -o scandium_script.sh $SCRIPT_URL
          - chmod +x scandium_script.sh
          - ./scandium_script.sh
        services:
          - docker
        deployment: Test
        artifacts:
          - test-results/**

definitions:
  variables:
    BROWSER: "chrome"
    SCREENSHOT: "true"
    VARIABLES: "{}"
    RETRY: "0"
    MAX_ATTEMPTS: "30"
    WAIT_PERIOD: "120"

Step 3: Push to Trigger

Once you’ve committed and pushed your pipeline file, Bitbucket will automatically run the pipeline and execute your Scandium test suite.


Troubleshooting Tips

Problem

Solution

❌ Missing required variable

Double-check that API_TOKEN, PROJECT_ID, and SUITE_ID are set in your repo variables

❌ Script not found or not executable

Ensure the SCRIPT_URL is valid and script has execution permission (chmod +x)

🕒 Stuck waiting

Adjust WAIT_PERIOD and MAX_ATTEMPTS in the variable section

Scandium