05-Workflow-Defaults.md

Job Defaults

Default options exist for jobs and steps within a workflow. Currently you can define the shell and working-directory.

In this exercise, you will see how to control at both the top-level (for all jobs) workflow, as well as for jobs individually.

Current shell compatiblity

OS	Shell	Default
Windows, Linux	pwsh	Windows
Windows, Linux	python
Windows, Linux	bash	Linux
Linux, macOS	sh	macOS
Windows	cmd
Windows	PowerShell

Step 1: Manually assign shell & working directory to different steps

1. From the default branch of your repository, create a new branch of code called feature/defaults
2. Create a new file named .github/workflows/defaults.yaml
3. Copy the contents below to the newly created file:

name: Using Defaults
on:
  push:
    branches: feature/defaults
jobs:
  first-job:
    name: A Job
    runs-on: ubuntu-latest
    steps:
      - name: Create Source Directory
        run: mkdir src
        shell: bash
      - name: Use Python
        run: print("I'm running python! Hissssss!")
        shell: python
        working-directory: src
      - name: Use Bash
        run: echo "I'm running hum-drum bash. Booo."
        shell: bash
        working-directory: src
      - name: Use Bash Also
        run: echo "I'm running bash also. Booo."
        shell: bash
        working-directory: src
  second-job:
    name: Another Job
    runs-on: ubuntu-latest
    steps:
      - name: Create Source Directory
        run: mkdir src
        shell: bash
      - name: Use Bash
        run: echo "I'm running bash. So sad."
        shell: bash
        working-directory: src

4. Add & commit your changes, then publish your branch.
5. Go to your repository, and view the Actions tab to see the execution against your published branch.

The result will be an execution which utilizes bash for most of the steps within the jobs.

Step 2 - Utilizing defaults at the job level

1. Replace the contents of the workflow file from the previous step:

name: Using Defaults
on:
  push:
    branches: feature/defaults
jobs:
  first-job:
    name: A Job
    runs-on: ubuntu-latest
    defaults:
      run:
        shell: bash
        working-directory: src
    steps:
      - name: Create Source Directory
        run: mkdir src
        working-directory: .
      - name: Use Python
        run: print("I'm running python! Hissssss!")
        shell: python
      - name: Use Bash
        run: echo "I'm running hum-drum bash. Booo."
      - name: Use Bash Also
        run: echo "I'm running bash also. Booo."
  second-job:
    name: A Job
    runs-on: ubuntu-latest
    steps:
      - name: Create Source Directory
        run: mkdir src
        shell: bash
        working-directory: .
      - name: Use Bash
        run: echo "I'm running bash. So sad."
        shell: bash
        working-directory: src

4. Add & commit your changes, then push your branch.
5. Go to your repository, and view the Actions tab to see the execution.

The result will be less code in your workflow, while the execution still performed the same. It used bash as the default shell and provided a default working directory of src

Step 3 - Utilizing defaults at the workflow level

1. Follow the same process as step 2, but use this content:

name: Job Default
on:
  push:
    branches: feature/defaults
defaults:
  run:
    shell: bash
    working-directory: src
jobs:
  first-job:
    name: A Job
    runs-on: ubuntu-latest
    steps:
      - name: Create Source Directory
        run: mkdir src
        working-directory: .
      - name: Use Python
        run: print("I'm running python! Hissssss!")
        shell: python
      - name: Use Bash
        run: echo "I'm running hum-drum bash. Booo."
      - name: Use Bash Also
        run: echo "I'm running bash also. Booo."
  second-job:
    name: A Job
    runs-on: ubuntu-latest
    steps:
      - name: Create Source Directory
        run: mkdir src
        working-directory: .
      - name: Use Bash
        run: echo "I'm running bash. So sad."

The result will be even less code, making bash the default shell and src the working-directory for all job steps.