phpboyscout/cicd¶
A monorepo of reusable GitLab CI/CD components for the
phpboyscout toolchain. They are released together under one tag stream,
and most run inside a per-track image from phpboyscout/images
(go-tools, rust-tools, tofu-tools and so on).
Consumers reference each component by URL and pin a tag:
Find what you need¶
This site follows Diátaxis, which splits documentation four ways by what the reader needs:
- Tutorials: new here? A guided, hands-on walkthrough that takes you from nothing to a green pipeline.
- How-To Guides: already using the components? Recipes for the things you actually need to do, like pinning a version, adding change-detection, setting up OIDC or cutting a release.
- Reference: every component, every input, every job it produces. Look something up.
- Explanation: the why behind change-detection, the token-input convention, security-always-on, and the rest of the decisions baked into every component.
Adding or changing a component yourself? See Contributing. Working on this repo's own internals, such as the decision record behind a change or a repo-internal developer guide? See Development. It sits outside the four kinds above, deliberately and by approved concession.
Components at a glance¶
| Track | Components |
|---|---|
| Terraform / OpenTofu | tofu-lint, tofu-security, tofu-validate, tofu-plan, tofu-apply, tofu-stop, tofu-deploy-generate, tofu-module-publish |
| Go | go-lint, go-test, go-security, go-singleuse, go-core-currency, goreleaser |
| Rust | rust-lint, rust-test, rust-security, rust-docs, rust-release, release-plz (deprecated) |
| Svelte | svelte-build, svelte-lint, svelte-test, svelte-security |
| Static sites | zensical-pages, hugo-pages |
| Container images | image-release, image-retag, image-scan |
| Cross-track quality | docs-verify |
| Release / dependency automation | colophon, releaser-pleaser, release-train, release-stamp, renovate-self, renovate-group, renovate-merge, verify-release-binaries |
| AI skills & instruction files | skill-security |
That is all 39 components. The full table, with a one-line purpose for each, is the Reference index; which pipeline types each one actually fires on is the trigger matrix, and what they deliberately do not do is Limitations.
Related projects¶
phpboyscout/images: the per-track images the components run in, one project per image. Limitations says which component runs on which, and which of them you can swap.phpboyscout/iac/terraform-aws-bootstrap: the bootstrap module; consumes these components for its own CI.phpboyscout/iac/terraform-aws-security-baseline: the security-baseline module; same.phpboyscout/infra: the first concrete user; OIDC plan-on-MR / apply-on-tag flow.
Further reading¶
The blog carries a curated route through this subject: CI/CD, and getting things released collects everything written about it, ordered so you can start at the beginning rather than newest-first.
Ask phpbotscout

He answers questions about the projects over on the Discord, citing the docs where they already cover it, and offering to raise an issue where they don't. Bring a bug, an idea, or a questionable engineering decision.