Skip to content

docs: add GCP Cloud Spanner scaler - #1786

Open
n0rm4l-me wants to merge 3 commits into
kedacore:mainfrom
n0rm4l-me:feat/gcp-spanner-scaler-docs
Open

docs: add GCP Cloud Spanner scaler#1786
n0rm4l-me wants to merge 3 commits into
kedacore:mainfrom
n0rm4l-me:feat/gcp-spanner-scaler-docs

Conversation

@n0rm4l-me

Copy link
Copy Markdown

Description

Adds documentation for the new gcp-spanner trigger introduced in kedacore/keda#7844.

Changes

  • content/docs/2.21/scalers/gcp-spanner.md — new scaler documentation page

Documentation covers

  • Trigger specification with all parameters, defaults and descriptions
  • Behaviour note: empty query result is treated as 0, not an error
  • Three authentication methods:
    • Inline service account JSON via credentialsFromEnv
    • JSON key file path via credentialsFromEnvFile
    • GCP Workload Identity via TriggerAuthentication with podIdentity.provider: gcp
  • Three ScaledObject examples (inline credentials, TriggerAuthentication with Secret, Workload Identity)
  • Auto-generated metric name format

Related

@n0rm4l-me
n0rm4l-me requested review from a team as code owners June 4, 2026 03:26
@netlify

netlify Bot commented Jun 4, 2026

Copy link
Copy Markdown

Deploy Preview for keda ready!

Name Link
🔨 Latest commit c637090
🔍 Latest deploy log https://app.netlify.com/projects/keda/deploys/6a73c99cd59b4e0008f28788
😎 Deploy Preview https://deploy-preview-1786--keda.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown

Thank you for your contribution! 🙏 We will review your PR as soon as possible.

While you are waiting, make sure to:

  • Add your contribution to all applicable KEDA versions
  • GitHub checks are passing
  • Is the DCO check failing? Here is how you can fix DCO issues

Learn more about:

Adds documentation for the new gcp-spanner trigger introduced in
kedacore/keda#7844.

Covers:
- All trigger parameters with defaults and descriptions
- Three authentication methods: inline JSON, env file path, Workload Identity
- Three ScaledObject examples (inline creds, TriggerAuthentication, pod identity)

Signed-off-by: Petr Petrenko | INPD <petr.petrenko@rakuten.com>
@n0rm4l-me
n0rm4l-me force-pushed the feat/gcp-spanner-scaler-docs branch from 5a93144 to 9704889 Compare August 5, 2026 04:18
@n0rm4l-me

Copy link
Copy Markdown
Author

@wozniakjan @rickbrouwer the main PR has been merged, could you take a look at the docs PR when you have a moment? Branch is now up to date. Thanks!

@rickbrouwer rickbrouwer self-assigned this Aug 5, 2026
Comment on lines +47 to +49
While `currentValue ≤ activationValue` the scaler is considered inactive and
the deployment is held at 0 replicas.
Learn more about activation [here](./../concepts/scaling-deployments.md#activating-and-scaling-thresholds).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Take a look at how this is described for other scalers. Because I think this information is redundant. It is also not entirely correct, because it is not kept at 0 if you do not have a minReplicaCount of 0.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Fixed, removed the redundant description.

Comment on lines +111 to +113
stringData:
creds.json: |
{ "type": "service_account", ... }

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Could you compare your documentation against the other GCP documentation to draw the line more closely?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Fixed, rewrote the entire doc to match gcp-storage style closely.

query: "SELECT COUNT(*) FROM jobs WHERE status = 'pending'" # Required
targetValue: "5" # Optional - default: 5
activationValue: "0" # Optional - default: 0
credentialsFromEnv: GOOGLE_APPLICATION_CREDENTIALS_JSON # Required*

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Required*

I believe the other GCP scalers handle this differently regarding documentation. Please verify this there so we maintain consistency.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Fixed, aligned with the gcp-storage pattern.

@rickbrouwer rickbrouwer removed their assignment Aug 5, 2026
- Remove redundant scale-to-zero description (not always accurate)
- Simplify parameter list format to match gcp-storage pattern
- Align Authentication Parameters section with other GCP scalers
- Add all three authentication examples (env, TriggerAuthentication, GCP Identity)

Signed-off-by: Petr Petrenko | INPD <petr.petrenko@rakuten.com>
Signed-off-by: Petr Petrenko | INPD <petr.petrenko@rakuten.com>
@n0rm4l-me
n0rm4l-me requested a review from rickbrouwer August 5, 2026 23:41
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.

2 participants