Jobs

apiVersion: automation.cloudbees.io/v1alpha1
kind: workflow
name: My workflow
on:
  push:
    branches:
      - '**'
jobs:
  my-job:                              #The job ID `my-job` uniquely identifies this job inside the `jobs` block.
    steps:
      - name: Print greeting           #This step runs a command inside an Alpine Linux container and prints "Hello world".
        uses: docker://alpine:3.18
        run: echo "Hello world"

  follow-up-job:                       #The job ID `follow-up-job` defines another job in the workflow.
    needs: [my-job]                    #The `needs` keyword specifies that `follow-up-job` depends on `my-job`. This ensures `follow-up-job` runs only after `my-job` completes successfully.
    steps:
      - name: Print follow-up message  #This step confirms that `follow-up-job` is executed after `my-job` and prints a follow-up message.
        uses: docker://alpine:3.18
        run: echo "my-job completed. Running next job."
▼

on:
  workflow_call:
    inputs:
      var-1:
        type: string
        required: false
      env-prod:
        type: string
        required: false

jobs:
  job-rw-1:
    steps:
      - name: Read inherited vars
        run: |
          if [ -n "${{ vars.var-A }}" ]; then echo "var-A available via inheritance"; fi
          if [ -n "${{ inputs.var-1 }}" ]; then echo "var-1 also provided via inputs"; fi

  job-rw-2:
    environment: ${{ inputs.env-prod }}                     #Sets the job’s environment from the input; environment-scoped vars are resolved for this job and can override inherited values with the same names.
    steps:
      - name: Environment-scoped vars may override
        run: |
          # If the selected environment defines var-A, it overrides the inherited value.
          if [ -n "${{ vars.var-A }}" ]; then echo "var-A resolved (environment may override)"; fi
▼

on:
  workflow_call:
    inputs:
      env-prod:
        type: string
        required: false

jobs:
  job-rw-1:
    steps:
      - name: Use inherited secrets
        run: |
          if [ -n "${{ secrets.secret-1 }}" ]; then echo "secret-1 available"; fi

  job-rw-2:
    environment: ${{ inputs.env-prod }}                       #Sets the job’s environment from the input; environment-scoped secrets are resolved for this job.
    steps:
      - name: Environment may override inherited values
        run: |
          # If the environment defines secret-1, it overrides the inherited value.
          if [ -n "${{ secrets.secret-1 }}" ]; then echo "secret-1 resolved (env may override)"; fi
▼

on:
  workflow_call:
    inputs:
      env-prod:
        type: string
        required: false

jobs:
  job-rw-1:
    steps:
      - name: Only mapped secrets are available
        run: |
          if [ -n "${{ secrets.secret-1 }}" ]; then echo "secret-1 available"; fi
          if [ -n "${{ secrets.secret-2 }}" ]; then echo "secret-2 available"; fi

  job-rw-2:
    environment: ${{ inputs.env-prod }}
    steps:
      - name: Environment may override mapped secrets
        run: |
          # If the environment defines secret-1/secret-2, those values override the mappings.
          if [ -n "${{ secrets.secret-1 }}" ]; then echo "secret-1 resolved (env may override)"; fi
          if [ -n "${{ secrets.secret-2 }}" ]; then echo "secret-2 resolved (env may override)"; fi
▼

jobs:
  my-job-1:
    outputs:
      output1: ${{ steps.step1.outputs.greeting }}
      output2: ${{ steps.step2.outputs.greeting }}
    steps:
      - name: My first step
        uses: docker://alpine:3.18
        id: step1
        run: echo "hello there" > "$CLOUDBEES_OUTPUTS/greeting"
      - name: My second step
        uses: docker://alpine:3.18
        id: step2
        run: echo "from the hive" > "$CLOUDBEES_OUTPUTS/greeting"
  my-job-2:
    needs: my-job-1
    steps:
      - env:
          OUTPUT1: ${{needs.my-job-1.outputs.output1}}
          OUTPUT2: ${{needs.my-job-1.outputs.output2}}
        uses: docker://alpine:3.18
        run: echo "$OUTPUT1 $OUTPUT2"
▼

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"
▼