Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The scheduled workflow will need following input parameters to successfully run all the checks and generate desired reports

    • ORG_NAMES: Space separated list of organization names to parse repositories i.e. 'openedx edx . . .'

    • EDX_REPO_HEALTH_BRANCH: Branch of the openedx/edx-repo-health repo to check out. This can be used to run custom checks against repositories if needed.

    • ONLY_CHECK_THIS_REPOSITORY: If you only want to run repo health on one repository, set this to org/name of the desired repository.

    • REPORT_DATE: The date for which repo health data is required. (format: YYYY-MM-DD). Pass this argument if you want to parse the repositories data for any specific date.

    • REPO_HEALTH_OWNERSHIP_SPREADSHEET_URL: URL for the google spreadsheet to populate the data.

    • REPO_HEALTH_REPOS_WORKSHEET_ID: ID for the google spreadsheet to populate the data.

    • TARGET_REPO_TO_STORE_REPORTS: Target repo to store the csv reports & results i.e. org/repo-name

    • REPOS_TO_IGNORE: Space separated list of repositories to be ignored i.e. 'repo1 repo2 . . .'

How to test script changes with a custom branch?

edx_repo_health_branch parameter can be used to test custom changes of the script on the repositories. This can be helpful when you

  • don’t want to run the job on all the repositories together

  • need to add any additional step in the script for your needs

  • Skip any of the default checks not needed for your organization

By default, the build run triggered against a custom branch other than master doesn’t commits changes to the repository. If you want your changes to be committed to the target repo after running against the custom branch, you’ll need to update the branch comparison condition from master to custom-branch.