require-google-cloud-build-timeout

Require an explicit root timeout in Google Cloud Build configuration.

Targeted pattern scope

Top-level timeout: in cloudbuild.yaml or cloudbuild.yml.

What this rule reports

This rule reports Cloud Build configs that do not declare a root timeout.

Why this rule exists

Explicit timeout budgets make build behavior predictable and prevent runaway builds from quietly consuming CI minutes until the platform default is hit.

❌ Incorrect

steps:
  - name: gcr.io/cloud-builders/npm
    args: ["test"]

✅ Correct

timeout: 1200s
steps:
  - name: gcr.io/cloud-builders/npm
    args: ["test"]

When not to use it

Disable this rule if timeout budgets are intentionally managed outside the repository.

Rule catalog ID: R067

Targeted pattern scope​

What this rule reports​

Why this rule exists​

❌ Incorrect​

✅ Correct​

When not to use it​

Further reading​