Conversation
Customers have recently wanted to be be able update each job label individually and it is not possible. The Buildkite-agent does the label update on a step level
|
Preview URL: https://2223--bk-docs-preview.netlify.app |
|
|
||
| <%= render 'agent/v3/help/step_update' %> | ||
|
|
||
| label update works on a step level and not on the job level, it would not be possible to update each job in a step |
There was a problem hiding this comment.
Could you explain a bit more about when someone might find themselves in this situation? For example, a correct version of something like:
Labels are applied to steps, not jobs, so you can't update a job label. When a step contains multiple jobs, all the jobs use the same label.
I also wonder if this might fit in better above the example where it's already talking about step labels.
There was a problem hiding this comment.
If there's a ticket in Helpscout or a post in the forum, it might help me understand the details a bit better 😊
|
This PR is no longer needed. The file it targeted (pages/agent/v3/cli_step.md) has moved to pages/agent/cli/reference/step.md and been rewritten. The current page now has a dedicated section called "Understanding step states vs job states" (line 68–70) that clarifies the distinction between step-level and job-level concepts. The note about label updates working at the step level (not the job level) is contextually covered by this section. Additionally, the one-line addition in the PR was informal and didn't follow docs style conventions. It can be safely closed |
4 participants
Customers have recently wanted to be be able update each job label individually and it is not possible. Because the Buildkite-agent does the label update on a step level