Claude Skill

cloud-run

Deploy Python services to Cloud Run with Artifact Registry and keyless CD.

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download fmind-dot-skills_cloud-run-3bbe830.zip · 11 KB

Install

skills CLI npx skills add https://github.com/fmind/dot/tree/main/skills/cloud-run
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fmind-dot@llmmart
Git git clone https://github.com/fmind/dot.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole fmind/dot collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Cloud Run Deployment

Deploy Python services to Cloud Run via immutable @sha256: digests, private IAM, keyless OIDC CD, and dedicated runtime service accounts. containerize owns images; gcloud owns account, project, and region selection.

Workflow

  1. Confirm target and authority: verify gcloud account, project, region, service, and Artifact Registry repo; pushes, signing, IAM edits, deploys, and traffic shifts each require target-specific authority.
  2. Bootstrap identities once: follow bootstrap.md for APIs, Artifact Registry, distinct runtime and deployer service accounts, and Workload Identity Federation.
  3. Validate locally: pin, lock, and install Trivy and Cosign before scanning or pushing, then build the non-root linux/amd64 image and pass mise run all and check:image (deployment.md steps 1–2, containerize).
  4. Publish and sign one digest: once push is authorized, follow deployment.md and run the cosign release sequence on that exact digest.
  5. Deploy privately: deploy the digest with --service-account and --invoker-iam-check --no-allow-unauthenticated (or service.yaml for multi-setting services), then run the private-IAM postcondition.
  6. Adopt IaC for fleets: manage multi-service IAM, registries, and infra via infra-as-code.
  7. Wire CD on request: install deploy.yml and verify-private.py per deployment.md steps 8–9.
  8. Record live state: report ready revision, @sha256: digest, pinned secret versions, runtime SA, IAM verification, health checks, traffic split, and rollback revision.

Gotchas

  • Bind every step to one @sha256: digest: build, scan, sign, attest, deploy, verify, and roll back the exact same digest.
  • Default to private access: grant roles/run.invoker narrowly, front with an authenticating LB, or pass gcloud run deploy --iap for browser users via IAP.
  • Promote named revisions, never LATEST: deploy no_traffic candidates, test the tag URL, then shift 100% traffic to the verified revision and drop the tag.
  • Cap DB pools against max_connections: keep max_instances × (pool_size + max_overflow) (SQLAlchemy defaults: 5 + 10 per worker) under max_connections minus admin headroom; add a pooler before raising limits.
  • Keep minScale: 0 unless cold starts justify idle spend: for hard ceilings, propose a Cloud Billing spend cap (requires billing authority, lags slightly, and halts Cloud Run when exceeded).
  • Co-locate service and Artifact Registry in the same project and region; WIF pools stay global.

Official Skills

Upstream google/skills (skills/cloud) installs via google-developer; gcloud covers CLI guardrails.

Documentation

Files (dot)
  • references
    • bootstrap.md 3.5 KB
      Loading…
    • deployment.md 5.3 KB
      Loading…
  • templates
    • deploy.yml 10.1 KB
      Loading…
    • service.yaml 2 KB
      Loading…
    • verify-private.py 2.6 KB
      Loading…
  • SKILL.md 4.2 KB
    ---
    name: cloud-run
    description: "Deploy Python services to Cloud Run with Artifact Registry and keyless CD."
    license: MIT
    metadata:
      kind: task
      author: Médéric HURIER (Fmind)
      source: github.com/fmind/dot/tree/main/skills/cloud-run
      created: "2026-09-16"
      updated: "2026-11-11"
    ---
    
    # Cloud Run Deployment
    
    Deploy Python services to Cloud Run via immutable `@sha256:` digests, private IAM, keyless OIDC CD, and dedicated runtime service accounts. [containerize](../docker/references/containerize/GUIDE.md) owns images; [gcloud](../gcloud/SKILL.md) owns account, project, and region selection.
    
    ## Workflow
    
    1. **Confirm target and authority**: verify gcloud account, project, region, service, and Artifact Registry repo; pushes, signing, IAM edits, deploys, and traffic shifts each require target-specific authority.
    1. **Bootstrap identities once**: follow [bootstrap.md](references/bootstrap.md) for APIs, Artifact Registry, distinct runtime and deployer service accounts, and Workload Identity Federation.
    1. **Validate locally**: pin, lock, and install Trivy and Cosign before scanning or pushing, then build the non-root `linux/amd64` image and pass `mise run all` and `check:image` ([deployment.md](references/deployment.md) steps 1–2, [containerize](../docker/references/containerize/GUIDE.md)).
    1. **Publish and sign one digest**: once push is authorized, follow [deployment.md](references/deployment.md) and run the [cosign release sequence](../docker/references/cosign.md#release-sequence) on that exact digest.
    1. **Deploy privately**: deploy the digest with `--service-account` and `--invoker-iam-check --no-allow-unauthenticated` (or [service.yaml](templates/service.yaml) for multi-setting services), then run the private-IAM postcondition.
    1. **Adopt IaC for fleets**: manage multi-service IAM, registries, and infra via [infra-as-code](../infra-as-code/SKILL.md).
    1. **Wire CD on request**: install [deploy.yml](templates/deploy.yml) and [verify-private.py](templates/verify-private.py) per [deployment.md](references/deployment.md) steps 8–9.
    1. **Record live state**: report ready revision, `@sha256:` digest, pinned secret versions, runtime SA, IAM verification, health checks, traffic split, and rollback revision.
    
    ## Gotchas
    
    - **Bind every step to one `@sha256:` digest**: build, scan, sign, attest, deploy, verify, and roll back the exact same digest.
    - **Default to private access**: grant `roles/run.invoker` narrowly, front with an authenticating LB, or pass `gcloud run deploy --iap` for browser users via [IAP](https://docs.cloud.google.com/run/docs/securing/identity-aware-proxy-cloud-run).
    - **Promote named revisions, never `LATEST`**: deploy `no_traffic` candidates, test the tag URL, then shift 100% traffic to the verified revision and drop the tag.
    - **Cap DB pools against `max_connections`**: keep `max_instances × (pool_size + max_overflow)` (SQLAlchemy defaults: `5 + 10` per worker) under `max_connections` minus admin headroom; add a pooler before raising limits.
    - **Keep `minScale: 0` unless cold starts justify idle spend**: for hard ceilings, propose a Cloud Billing [spend cap](https://docs.cloud.google.com/billing/docs/how-to/budgets-spend-caps) (requires billing authority, lags slightly, and halts Cloud Run when exceeded).
    - **Co-locate service and Artifact Registry** in the same project and region; WIF pools stay `global`.
    
    ## Official Skills
    
    Upstream `google/skills` (`skills/cloud`) installs via [google-developer](../gcloud/references/google-developer.md); [gcloud](../gcloud/SKILL.md) covers CLI guardrails.
    
    ## Documentation
    
    - [Cloud Run](https://docs.cloud.google.com/run/docs) · [Artifact Registry](https://docs.cloud.google.com/artifact-registry/docs) · [Workload Identity Federation](https://docs.cloud.google.com/iam/docs/workload-identity-federation) · [Cloud Run releases](https://docs.cloud.google.com/run/docs/release-notes) · [Artifact Registry releases](https://docs.cloud.google.com/artifact-registry/docs/release-notes)
    - Companions: [containerize](../docker/references/containerize/GUIDE.md), [github-actions](../github-actions/references/ci-cd/GUIDE.md), [gcloud](../gcloud/SKILL.md), [infra-as-code](../infra-as-code/SKILL.md), [code-security](../code-security/references/code-review/GUIDE.md).
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.