Skip to content

docs(skills): add GCP Cloud Armor provider reference - #268

Merged
gfargo merged 1 commit into
mainfrom
docs/gcp-cloud-armor-reference
Aug 24, 2026
Merged

docs(skills): add GCP Cloud Armor provider reference#268
gfargo merged 1 commit into
mainfrom
docs/gcp-cloud-armor-reference

Conversation

@gfargo

@gfargo gfargo commented Aug 24, 2026

Copy link
Copy Markdown
Owner

Summary

No GCP setup doc existed anywhere in the repo — skills/doorman/references/cloudflare.md and fastly.md both exist, gcp.md didn't. Noticed while doing #187's real e2e verification (#264).

Adds skills/doorman/references/gcp.md covering:

  • Env vars, one-time project setup (enable Compute Engine API, IAM, auth), config shape
  • CEL field/action mapping — verified directly against CelExpressionBuilder.ts/translator.ts, not guessed
  • The priority-as-id model, the mandatory default rule, no-dedicated-IP-resource, rate limiting, Operation polling
  • A manual end-to-end verification runbook (disposable policy creation, the real command sequence, cost, teardown) — the main new content, capturing fix(gcp): three bugs found running the Cloud Armor provider against real GCP for the first time #264's actual process so a future verification pass doesn't start from zero

Also links the new page from SKILL.md's reference table and condition-fields line, matching the existing pattern.

Test plan

  • Every field/action mapping cross-checked against the actual translator source, not pattern-matched from the other providers' docs
  • Command usage examples verified against each command's actual builder flags (validate has no --provider flag, matching fastly.md's existing precedent — confirmed by reading validate.ts, not assumed)
  • Documentation-only change — no code, no test/lint/build impact beyond the pre-commit hook's own repo-wide checks

Fills a gap noted while doing #187's real e2e verification (PR #264): no
GCP setup doc existed anywhere in the repo, unlike references/cloudflare.md
and references/fastly.md. Covers env vars, one-time project/IAM/auth setup,
config shape, CEL field/action mapping (verified directly against
CelExpressionBuilder.ts and translator.ts rather than guessed), the
priority-as-id model, the mandatory default rule, and — the main new
content — a manual end-to-end verification runbook (disposable policy
creation, the real command sequence, cost, teardown) so a future
verification pass doesn't start from zero.

Also links the new page from SKILL.md's reference table and condition-
fields line, matching the existing cloudflare.md/fastly.md pattern.
@gfargo
gfargo merged commit e20cb91 into main Aug 24, 2026
2 checks passed
@gfargo
gfargo deleted the docs/gcp-cloud-armor-reference branch August 24, 2026 15:34
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 3.14.2 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant