Skip to content

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:

include:
  - component: gitlab.com/phpboyscout/cicd/<name>@vX.Y.Z

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.

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

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.

Join the Discord