Skip to content

docs: google cloud installation guides - agent blockers - #69634

Draft
mmcallister wants to merge 10 commits into
masterfrom
gcloud_agent_improvements_batch2
Draft

docs: google cloud installation guides - agent blockers#69634
mmcallister wants to merge 10 commits into
masterfrom
gcloud_agent_improvements_batch2

Conversation

@mmcallister

Copy link
Copy Markdown
Contributor

Summary

Fixes for guide-following medium and high-level blockers surfaced by Beams agent testing of GCP installation and deployment documentation. Changes add gcloud CLI alternatives for Console-only
steps, <Checkpoint> verification blocks after critical operations, and decision guidance
for ambiguous configuration choices.

Changes

  • gcp.mdx (agents): Added blocks after token creation and service join with
    tctl/tsh verification commands, gcloud compute instances describe for service account
    discovery, and an on security best practices for scoping allow rules.

  • gcp.mdx (deployments): Added gcloud CLI commands for Firestore database creation, GCS
    bucket creation, service account key generation, and load balancer/DNS setup that were
    previously Console-only. Added blocks after backend resource creation and
    pre-install verification.

  • gcp.mdx (helm-deployments): Added gcloud CLI alternatives in for IAM role
    creation, service account creation with role binding, service account key generation,
    and DNS record creation. Added blocks after secret creation, cert-manager
    install, Helm install, DNS setup, and final cluster verification.

  • gcp-kms.mdx: Added gcloud kms locations list for discovering KMS locations,
    blocks after key ring creation, IAM policy binding, KMS access verification, and
    post-restart health check. Added decision guidance for protection level (SOFTWARE vs.
    HSM) and a tip about using attached service accounts over JSON keys.

@mmcallister mmcallister self-assigned this Aug 13, 2026
@mmcallister mmcallister added documentation no-changelog Indicates that a PR does not require a changelog entry backport/branch/v18 labels Aug 13, 2026
@mmcallister mmcallister changed the title docs: google cloud installation guides: agent blockers docs: google cloud installation guides - agent blockers Aug 13, 2026
@github-actions

github-actions Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Amplify deployment status

Branch Commit Job ID Status Preview Updated (UTC)
gcloud_agent_improvements_batch2 ed4ba11 10 ❌FAILED gcloud-agent-improvements-batch2 2026-08-17 01:34:12

…rd, rrdatas added to cspell as it is for 'resource record data' in gcloud reference docs
@mmcallister
mmcallister deployed to docs-amplify August 14, 2026 01:07 — with GitHub Actions Active
@mmcallister
mmcallister deployed to docs-amplify August 14, 2026 10:51 — with GitHub Actions Active
@mmcallister
mmcallister marked this pull request as ready for review August 15, 2026 20:53
@mmcallister
mmcallister deployed to docs-amplify August 15, 2026 20:56 — with GitHub Actions Active

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 920f30c2dc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
@mmcallister
mmcallister marked this pull request as draft August 15, 2026 21:00

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 65eb2f4576

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/private-keys/gcp-kms.mdx Outdated
@mmcallister
mmcallister deployed to docs-amplify August 15, 2026 21:49 — with GitHub Actions Active
@mmcallister
mmcallister deployed to docs-amplify August 15, 2026 22:02 — with GitHub Actions Active
@mmcallister
mmcallister deployed to docs-amplify August 15, 2026 22:10 — with GitHub Actions Active

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ca161e8018

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ca161e8018

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
@mmcallister
mmcallister deployed to docs-amplify August 15, 2026 22:35 — with GitHub Actions Active

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 81f148f282

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx
@mmcallister

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 81f148f282

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/pages/installation/self-hosted/private-keys/gcp-kms.mdx
Comment thread docs/pages/installation/self-hosted/helm-deployments/gcp.mdx
@mmcallister

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 342943680c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx Outdated
Comment thread docs/pages/installation/self-hosted/deployments/gcp.mdx
…se readyz for both load-balancer health checks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/branch/v18 documentation no-changelog Indicates that a PR does not require a changelog entry size/md

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant