phpboyscout/cicd¶
A monorepo of reusable GitLab CI/CD components for the
phpboyscout toolchain — released together under one tag stream, run inside
the infra-tools / dev-tools images.
Consumers reference each component by URL and pin a tag:
Find what you need¶
This site follows Diátaxis — four kinds of documentation for four different 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? Task-oriented recipes for the things you actually need to do — pin a version, add change-detection, set up OIDC, cut a release.
- Reference — every component, every input, every job it produces. Look something up.
- Explanation — the why behind the design — 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 — the decision record behind a change, or a repo-internal developer guide? See Development — a deliberate, approved concession outside the four kinds above.
Components at a glance¶
| Track | Components |
|---|---|
| Terraform / OpenTofu | tofu-lint, tofu-security, tofu-validate, tofu-plan, tofu-apply, tofu-module-publish |
| Go | go-lint, go-test, go-security, goreleaser |
| Rust | rust-lint, rust-test, rust-security, rust-docs, release-plz |
| Svelte | svelte-build, svelte-lint, svelte-test, svelte-security |
| Static sites | zensical-pages, hugo-pages |
| Release / dependency automation | renovate-self, releaser-pleaser |
| AI skills & instruction files | skill-security |
The full table, with a one-line purpose for each, is the Reference index.
Related projects¶
phpboyscout/images/infra-tools— the container image the Tofu and static-site components run in.phpboyscout/images/dev-tools— the consolidated Go/Rust/Node toolchain image the Go, Rust, and Svelte components run in.phpboyscout/terraform-aws-bootstrap— the bootstrap module; consumes these components for its own CI.phpboyscout/terraform-aws-security-baseline— the security-baseline module; same.phpboyscout/infra— the first concrete user; OIDC plan-on-MR / apply-on-tag flow.