Skip to content

Connect private Cloud Run services to Restate Cloud with workload identity federation - #378

Draft
pcholakov wants to merge 1 commit into
mainfrom
cloud-gcr-wif
Draft

Connect private Cloud Run services to Restate Cloud with workload identity federation#378
pcholakov wants to merge 1 commit into
mainfrom
cloud-gcr-wif

Conversation

@pcholakov

Copy link
Copy Markdown
Contributor

Documents connecting private Google Cloud Run services to Restate Cloud via AWS→GCP workload identity federation (restatedev/restate#5207, restatedev/restate-cloud#1188).

Draft until the feature ships: the runtime PRs (restatedev/restate#5154 → #5207 → #5229) and the Cloud broker infrastructure (restate-cloud#1400) are unmerged; the identifiers here (RestateCloudGcpFederation, account 654654156625) are the reserved production values, not yet live.

What's here

  • cloud/connecting-services: new "Google Cloud Run services" section — the identity model (one fixed federated subject per environment, derived from the environment ID), the three IAM grants (provider with a pinned attribute condition, serviceAccountOpenIdTokenCreator on the customer's invoker SA for the exact subject, run.invoker), and registration. All enforcement lives in the customer's own project IAM; the section says so explicitly since unilateral revocability is the selling point. Commands mirror the E2E-verified sequences.
  • services/deploy/cloud-run: the "not supported on Restate Cloud" Note becomes a pointer to the new section; adds an "AWS-hosted Restate: workload identity federation" subsection documenting --gcp-workload-identity-provider (new in restate#5207, always paired with impersonation); rewrites "Token caching and rotation" to match the credential-registry behavior that replaced the old token-string cache (proactive background refresh, 1h idle eviction, shared across discovery and invocations — the 60-second early-eviction margin no longer exists).

Review notes

  • The <ENVIRONMENT_NAMESPACE> derivation (env_env-) matches the control plane's namespace derivation; the companion Cloud UI change shows these commands prefilled per environment, and the section links there.
  • The attribute condition is presented as required, not optional — it is the tenant-isolation pin.
  • A per-deployment-target split of connecting-services was considered and deferred; the page is still navigable with the new section, and the split would churn every anchor.

Adds a Google Cloud Run section to the Cloud connecting-services page:
workload identity federation trust setup (pool/provider pinned to the
Restate Cloud federation role, per-environment subject grants) and
registration. Updates the Cloud Run deploy page: Restate Cloud is now a
supported path rather than a roadmap item, documents
--gcp-workload-identity-provider, and refreshes the token-caching
description to match the credential registry behavior.
@mintlify

mintlify Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
restatedev 🟢 Ready View Preview Aug 26, 2026, 12:42 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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