Pipeline build failed with Currently no online runner available that matches the required labels error

Summary

Platform: Bitbucket Pipeline Self-hosted Runners - All

Solution

Possible causes:

During the setup process, the runner can utilize both custom labels and default labels. The default labels provided to the Runner are determined by the platform being used:

• Linux Shell - self.hosted linux.shell

• Windows Shell - self.hosted windows

• MacOs Shell - self.hosted macos

• Linux Docker - self.hosted linux

When a Pipeline step is executed, the parameters specified in the runs-on section are matched with the labels assigned to the Runner. It is important to understand the following points regarding the parameters configured for a step:

• For a step to execute on a Self-hosted runner, it must include the self.hosted parameter.

• The step should also include one of the platform-specific parameters listed below. If none of these parameters are specified, the linux parameter will be applied by default:

  • linux.shell

  • windows

  • macos

  • linux

• Additionally, the step can incorporate custom parameters.

Errors may arise if there is no Runner available that possesses all the labels specified as parameters in the runs-on section of the Pipeline step.

Troubleshooting Steps:

Examine the labels assigned to the Runner and the parameters included in the runs-on section of the Pipeline step. Ensure that there is a minimum of one Runner that possesses all the labels specified as parameters in the Pipeline step.