No agents meet this job's requirements

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Purpose

This page describes how to investigate why Bamboo may be showing a No agents meet this job's requirements message. It is an extension to Dedicating an agent and Configuring a job's requirements.

Issue

The message No agents meet this job's requirements in one of these sections of the Bamboo administrative interface:

  • under Plan configuration >> [Stage] >> [Job] >> Tasks tab you should be in this URL
    http://BAMBOO_BASE_URL/build/admin/edit/editBuildTasks.action?buildKey=PROJ-PLAN-JOB1
  • under Plan configuration >> [Stage] >> [Job] >> Requirements tab you should be in this URL 
    http://BAMBOO_BASE_URL/build/admin/edit/defaultBuildRequirement.action?buildKey=PROJ-PLAN-JOB1

Dedicated agent(s)

If an Agent is dedicated, it needs to be Online for the job to be executed. If a Dedicated Agent is offline, the Job will report the "No agents meet this job's requirements" message.

Before we dig into capabilities and requirements, we first need to make sure no Bamboo agent is dedicated to the particular PROJECT, PLAN, JOB, DEPLOYMENT and/or ENVIRONMENT you are experiencing the issue with. In order to do that, please run the following SQL statement against Bamboo's database:

select AGENT_TYPE, TITLE, ENABLED, ASSIGNED.*
  from AGENT_ASSIGNMENT as ASSIGNED
  join queue as AGENT
       on ASSIGNED.EXECUTOR_ID = AGENT.QUEUE_ID;

As a result, we have the following agent dedicated EXECUTOR_ID to EXECUTABLE_ID

AGENT_TYPETITLEENABLED

ASSIGNMENT_ID

EXECUTOR_ID

EXECUTOR_TYPE

EXECUTABLE_ID

EXECUTABLE_TYPE

REMOTERemote Agent Atrue

2621441

1179649

AGENT

360449

PROJECT

REMOTERemote Agent Atrue

2621442

1179649

AGENT

393217

PLAN

REMOTERemote Agent Atrue

2621443

1179649

AGENT

393218

JOB

REMOTERemote Agent Atrue

2621444

1179649

AGENT

819201

DEPLOYMENT_PROJECT

REMOTERemote Agent Atrue

2621445

1179649

AGENT

950273

ENVIRONMENT

The EXECUTOR_ID relates to the Bamboo server, Bamboo local agent, Bamboo remote agent, Bamboo elastic agent ID.

The EXECUTABLE_ID can be reviewed by running:


How do I get PROJECT?
select PROJECT_KEY, TITLE
  from PROJECT
 where PROJECT_ID = 360449;

Sample response:

PROJECT_KEY

TITLE

PROJ

Project

How do I get PLAN?
select PROJECT_KEY, PROJECT.TITLE, 
       BUILD_TYPE, FULL_KEY, BUILDKEY, BUILD.TITLE
  from BUILD
  join PROJECT on BUILD.PROJECT_ID = PROJECT.PROJECT_ID
 where BUILD_ID = 393217;

Sample response:

PROJECT_KEY

TITLE

BUILD_TYPE

FULL_KEY

BUILDKEY

TITLE

PROJ

Project

CHAIN

PROJ-PLAN

PLAN

Plan

How do I get JOB?
select PROJECT_KEY, PROJECT.TITLE, 
       BUILD_TYPE, FULL_KEY, BUILDKEY, BUILD.TITLE
  from BUILD
  join PROJECT on BUILD.PROJECT_ID = PROJECT.PROJECT_ID
 where BUILD_ID = 393218;

Sample response:

PROJECT_KEY

TITLE

BUILD_TYPE

FULL_KEY

BUILDKEY

TITLE

PROJ

Project

JOB

PROJ-PLAN-JOB1

JOB1

Default Job

How do I get DEPLOYMENT_PROJECT?
select NAME
  from DEPLOYMENT_PROJECT
 where BUILD_ID = 819201;

Sample response:

NAME

Deployment

How do I get ENVIRONMENT?
select ENV.NAME
  from DEPLOYMENT_ENVIRONMENT as ENV
  join DEPLOYMENT_PROJECT as DEP
        on ENV.PACKAGE_DEFINITION_ID = DEP.DEPLOYMENT_PROJECT_ID
 where ENV.ENVIRONMENT_ID = 950273;

Sample response:

NAME

Environment

Confirmed Dedicated Agent is not the problem, what next?

In order to investigate the message No agents meet this job's requirements, we will need to review how the JOB in question is set upespecially which requirements have been configured for the job. You can get this information by running the following SQL statement:

Get build definition
select *
  from BUILD as B
  join BUILD_DEFINITION as BD
        on B.build_id = BD.build_id
 where B.full_key = 'PROJ-PLAN-JOB1'
   and B.build_type = 'JOB'

The statement above will provide information on how tasks are set up and which capabilities they require as per the following:

BUILD_ID

BUILD_TYPE

CREATED_DATE

UPDATED_DATE

FULL_KEY

BUILD_KEY

...

REQUIREMENT_SET

STAGE_ID

...

360450

JOB

2015-12-21 11:59:31

2015-12-21 12:10:00

PROJ-PLAN-JOB1

JOB1

...

491521

458753

...


Now, it is time to get a list of all REQUIREMENT_SET to the PROJ-PLAN-JOB1 from above:

Get requirements
select *
  from REQUIREMENT_SET as RS
  join REQUIREMENT as R
        on RS.REQUIREMENT_SET_ID = R.REQUIREMENT_SET
 where R.REQUIREMENT_SET = 491521;

REQUIREMENT_SET_ID

REQUIREMENT_ID

KEY_IDENTIFIER

REGEX_MATCH

READONLY_REQ

MATCH_VALUE

PLUGIN_MODULE_KEY

UNIQUE_IDENTIFIER

REQUIREMENT_SET

491521

2588673

CUSTOM_CAPABILITY

false

false

CAPABILITY_VALUE

(null)

-1

491521

4915212588674system.builder.mvn3.Maven 3truefalse.*(null)-1491521

Finally, check whether the Bamboo agent (Local, Remote, Elastic) you are attempting on running the build against has the capabilities required. Get the Agent ID from 

 select QUEUE_ID, AGENT_TYPE, TITLE, ENABLED, C.*
  from QUEUE as AGENT
  join CAPABILITY as C
        on AGENT.CAPABILITY_SET = C.CAPABILITY_SET;
QUEUE_IDAGENT_TYPETITLEENABLED

CAPABILITY_ID

KEY_IDENTIFIER

VALUE

CAPABILITY_SET

1179649

REMOTERemote Agent Atrue

2523138

CUSTOM_CAPABILITY

CAPABILITY_VALUE

1212417

1179650REMOTERemote Agent Btrue2523140system.builder.mvn3.Maven 3/opt/apache-maven-3.3.91212417

Based on the above, we can notice:

  • Bamboo Remote Agent 1179649 does NOT have system.builder.mvn3.Maven 3 capability is required to run the build.
  • Bamboo Remote Agent 1179650 does NOT have CUSTOM_CAPABILITY capability required to run the build.

Either add CUSTOM_CAPABILITY to Bamboo Remote Agent 1179649 or system.builder.mvn3.Maven 3 to Bamboo Remote Agent 1179650.

What next?

You might be encountering this issue: BAM-15965 - Getting issue details... STATUS

Last modified on Mar 28, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.