Copier Template¶
The Copier template generates the consumer-facing workflow files that call the reusable workflows and actions from this repository.
Generated repositories always get:
Some workflows are conditional:
pr_bump.ymlis generated whenbump_script_pathis set.release_draft.ymlis generated whendo_releasesis enabled.site.ymlis generated whensite_generatorismkdocsorjekyll.
The template also writes .copier-answers.ci.yml. It writes
.github/ci-config.yml and, when releases are enabled,
.github/release_template.md only when those files do not already exist.
Token¶
Generated workflows use CI_BOT_TOKEN when an operation needs to write commits,
labels, PR comments, releases, workflow files, or repository variables. The
helper script tools/init_ci_repo.sh can set this secret with gh secret set.
Required repository permissions for the token:
Contents: Read and writePull requests: Read and writeIssues: Read and writeActions: Read and writeWorkflows: Read and writeVariables: Read and write