The Atlassian Community Forums are currently in read-only mode. We will be relaunching on a new platform on September 22 (read more here). We apologize for the extended downtime. For concerns or questions, please email communitymanagers@atlassian.com. See you on the other side, on the new Atlassian Community Forums! :)

×

Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

How to use parallel steps?

MennoVink
Contributor
March 25, 2026

Here's a subsection of my bitbucket-pipelines.yml:

pipelines:
branches:
release:
- parallel:
- step: *BuildWindows
- step: *BuildMacOS
- step: *BuildDocumentation
- step:
name: Upload
deployment: Develop

This setup is intended to have builds running on three machines/platforms simultaneously. (Documentation is built on linux)

The definitions for these steps each target a different self-hosted machine that is currently idle like so:

definitions:
steps:
- step: &BuildWindows
name: Build Windows
runs-on:
- 'self.hosted'
- 'windows'

 

This page states that free plan users can have up to 10 parallel steps: https://support.atlassian.com/bitbucket-cloud/docs/parallel-step-options/

 

In my experience, these steps execute sequentially. Any idea what i might be doing wrong? I have run out of build minutes (trying qodana), but since these steps run on self.hosted runners that should be fine, sequential builds to work.

2 answers

Comments for this post are closed

Community moderators have prevented the ability to post new answers.

0 votes
Mark C
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
March 27, 2026

Hi @MennoVink

Thank you for reaching out to the community.

Based on the YAML configuration, it seems you're missing the "steps" property in your parallel steps.

It should be like this:

Screenshot 2026-03-27 at 6.03.47 pm.png

Regards,
Mark C

MennoVink
Contributor
April 11, 2026

Hi @Mark C @Aron Gombas _Midori_ , thanks for your suggestions.

Unfortunately neither of them work. I've waited for build minutes to reset. All runners are online ready to accept steps. I have added the steps indirection to the parallel section.

I see BuildWindows starting right away, Build macOS and Build Documentation stay queued until their previous step is done.

 

Here is my full bitbucket-pipelines.yml: https://pastebin.com/8h5hHHqT

I'm trying to execute the branches -> release pipeline

 

Any other ideas as to what i could be doing wrong? The bitbucket pipelines yaml validator sais it's valid.

Mark C
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
April 17, 2026

Hi @MennoVink

Were you getting some errors?

Regards,
Mark C

MennoVink
Contributor
April 23, 2026

No errors, the pipeline runs through to completion, just one step at a time. 

0 votes
Aron Gombas _Midori_
Community Champion
March 26, 2026

@MennoVink 

Two ideas:

  1. Check if all three self-hosted runners are online and in an idle state at the time the pipeline triggers. You can check runner status under Repository Settings > Runners.
  2. Wait for your build minutes to reset, and then test the parallel block again.
DEPLOYMENT TYPE
CLOUD
PERMISSIONS LEVEL
Product Admin Site Admin
TAGS
AUG Leaders

Atlassian Community Events