jobs.<job_id>.uses

Use jobs.<job_id>.uses to specify the path for a Reusable workflows job. Call a workflow by setting uses: to the repository path of the reusable workflow YAML file.

A single workflow job must contain only one of the following execution syntax:

jobs.<job_id>.delegates
jobs.<job_id>.uses
jobs.<job_id>.steps[*].uses

Reusable workflow job usage example

jobs:
  deploy:
    uses: <owner>/<repo>/.cloudbees/workflows/<reusable-workflow.yaml@v2>
    with:
      config-path: ./config/demo-app
    secrets:
      access-token: ${{ secrets.token }}

  pass:
    needs: [deploy]
    if: needs.deploy.outputs.deploy-result == 'pass'
    steps:
      - name: Pass
        uses: docker://alpine:3.21
        run: echo "Deploy success alert"

  fail:
    needs: [deploy]
    if: needs.deploy.outputs.deploy-result == 'fail'
    steps:
      - name: Handle deploy failure
        uses: docker://alpine:3.21
        run: echo "Deploy failure alert"▼