| # build.yaml |
| |
| ## flutter-prep |
| |
| This job handles caching the flutter candidate, so that we don't need to keep downloading it and setting it up for each job. |
| |
| ### Clearing the cache |
| |
| To clear the Github Actions cache for a specific flutter candidate: |
| |
| - Navigate to [Devtool's Actions Caches](https://github.com/flutter/devtools/actions/caches) |
| - Filter for the candidate you would like to clear |
| - Delete all of the cache entries for your candidate |
| - There should be a Linux and a MacOS entry for each candidate |
| |
| # daily-dev-bump.yaml |
| |
| The Daily Dev Bump workflow is meant to facilitate `-dev.*` version bumps, on a daily cadence. |
| |
| Using a cron trigger, this workflow will: |
| - perform a dev version bump |
| - create a PR with an `autosubmit` label |
| |
| - The PR will then be automatically approved and merged by the processes from the [ Flutter Cocoon repo ](https://github.com/flutter/cocoon), |
| - The Flutter auto-submit bot automatically merges the PR. |
| |
| ## DartDevtoolWorkflowBot |
| In order to allow the automatic approval and submission of the version bump PRs, |
| [DartDevtoolWorkflowBot](https://github.com/DartDevtoolWorkflowBot) was created. |
| |
| DartDevtoolWorkflowBot is a Github account that is used to author the version bump PRs in `daily-dev-bump.yaml`. It has special permissions so that when the Cocoon bots see a PR authored by DartDevtoolWorkflowBot, they can be automatically approved. |
| |
| ### DartDevtoolWorkflowBot Token Cycling |
| |
| DartDevtoolWorkflowBot's Personal Access Token must be cycled every 90 days. |
| The instructions to rotate the token can be found in the email for the Dart DevTool Workflow Token rotation. |
| |
| ## Manually Performing a Dev Version Bump |
| |
| To manually trigger a Dev Version Bump: |
| - Navigate to the [Action entry for Dev Bumps](https://github.com/flutter/devtools/actions/workflows/daily-dev-bump.yaml) |
| - Select `Run workflow` |
| - Run the workflow from `master` |
