feat: PIPE-5084 Update job references to support serial groups

[liamclarkedev]

Jira

Description

Serial groups are groups of jobs that run in series, this is a new property that can be set for any job type.

For example, creating multiple pipelines at the same time with the below config will result in all pipelines running test and build but only a single pipeline will run deploy at a time.

version: 2.1

jobs:
  test:
    type: no-op

  build:
    type: no-op

  deploy:
    type: no-op

workflows:
  main-workflow:
    jobs:
      - test
      - build
      - deploy:
          serial-group: << pipeline.project.slug >>/deploy-group
          requires:
            - test
            - build

Implementation details

Serial group keys when compiled:

• Are optional and defined on the job invocation.
• Must be a non-empty string fewer than 512 characters.

Note: this is after compilation, limiting what we can validate here, this would be valid.

parameters:
  key-longer-than-512-chars:
    type: string
    default: "foo"

  ...
  serial-group: << pipeline.parameters.key-longer-than-512-chars >>

How to validate

• Unit tests pass.
• Paste the above config in any test project.
• Push a change and confirm it works.