Skip to content

docs(deploy): correct config parameter names in deploy README - #1521

Merged
rdimitrov merged 1 commit into
mainfrom
docs/deploy-config-table
Aug 10, 2026
Merged

docs(deploy): correct config parameter names in deploy README#1521
rdimitrov merged 1 commit into
mainfrom
docs/deploy-config-table

Conversation

@rdimitrov

Copy link
Copy Markdown
Member

The deploy configuration table named two parameters that no code reads, and omitted two that a deploy cannot succeed without.

Wrong names

Documented Actual Evidence
gcpProjectId gcp:project provider.go:30 — its error text literally says Set gcp:project
gcpRegion gcp:region provider.go:36, default us-central1

gcpProjectId and gcpRegion appear nowhere in deploy/ outside this table. All three stack files (Pulumi.gcpProd.yaml, Pulumi.gcpStaging.yaml, Pulumi.local.yaml) already use gcp:project.

Missing required secrets

Both are RequireSecret, so a deploy fails outright without them — yet neither was in the table:

Also

  • Documents gcp:credentials (read at provider.go:42, set in the staging and prod stacks)
  • Marks which values are secrets
  • Adds the namespace prefixes. The table listed bare names, which is part of why the two wrong ones survived: gcpProjectId reads as plausible right up until you notice the real key lives in a different config namespace altogether.

Verification

Checked both directions:

  • every key now in the table is read by code in deploy/ (reference counts confirmed per key)
  • every conf.*("...") key found anywhere in deploy/ now appears in the table

🤖 Generated with Claude Code

The configuration table named two parameters that no code reads and omitted two
that a deploy cannot succeed without.

Wrong names:

- `gcpProjectId` and `gcpRegion` appear nowhere in deploy/ outside this table.
  The real keys are in the `gcp` provider namespace: `gcp:project`
  (deploy/pkg/providers/gcp/provider.go:30, whose error text says "Set
  gcp:project") and `gcp:region` (:36, default us-central1). All three stack
  files already use `gcp:project`.

Missing required secrets, both RequireSecret so the deploy fails without them:

- `mcp-registry:jwtPrivateKey` (deploy/pkg/k8s/registry.go:56)
- `mcp-registry:googleOauthClientSecret` (deploy/pkg/k8s/monitoring.go:463)

Also documents `gcp:credentials`, which is read at provider.go:42 and set in the
staging and prod stacks, and adds the namespace prefixes. The table previously
listed bare names, which is part of why the two wrong ones went unnoticed --
`gcpProjectId` looks plausible until you notice the real key lives under a
different namespace entirely.

Verified in both directions: every key in the table is read by deploy code, and
every `conf.*("...")` key in deploy/ now appears in the table.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@rdimitrov
rdimitrov merged commit 988b078 into main Aug 10, 2026
7 checks passed
@rdimitrov
rdimitrov deleted the docs/deploy-config-table branch August 10, 2026 13:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant