automated-release-tasks.yml

name: automated-release-tasks
on:
  schedule:
    # Cron syntax is "minute[0-59] hour[0-23] date[1-31] month[1-12] day[0-6]". '*' is 'any value,' and multiple values
    # can be specified with comma-separated lists. All times are UTC.
    # So this expression means "run at 4:30 AM UTC (10:00 AM IST), every Friday".
    - cron: "30 4 * * 5"

jobs:
  # Depending on circumstances, we may want to exit early instead of running the workflow to completion.
  verify-should-run:
    runs-on: macos-latest
    outputs:
      should-run: ${{ steps.main.outputs.should_run }}
    steps:
      - id: main
        run: |
          # `date -u` returns UTC datetime, and `%u` formats the output to be the day of the week, with 1 being Monday,
          # 2 being Tuesday, etc.
          TODAY_DOW=$(date -u +%u)
          # This `date` expression returns the last Tuesday of the month, which is our Release Day. %d formats the output
          # as the day of the month (1-31).
          NEXT_RELEASE_DATE=$(date -u -v1d -v+1m -v-1d -v-tue +%d)
          # This `date` expression returns next Tuesday, and `%d` formats the output as the day of the month (1-31).
          NEXT_TUESDAY_DATE=$(date -u -v+tue +%d)
          # This workflow should only be allowed to run to completion on the Friday before Release Day.
          [[ $TODAY_DOW != 5 || $NEXT_RELEASE_DATE != $NEXT_TUESDAY_DATE ]] && echo "should_run=false" >> "$GITHUB_OUTPUT" || echo "should_run=true" >> "$GITHUB_OUTPUT"
  create-release-branch:
    needs: verify-should-run
    if: ${{ needs.verify-should-run.outputs.should-run == 'true' }}
    uses: ./.github/workflows/create-release-branch.yml
    secrets: inherit
    with:
      release-type: minor