Skip to content

DOC-373: Fix broken Update Parity Docs pipeline - #854

Merged
HarshCasper merged 1 commit into
mainfrom
doc-373-fix-broken-update-parity-docs-pipeline
Aug 10, 2026
Merged

DOC-373: Fix broken Update Parity Docs pipeline#854
HarshCasper merged 1 commit into
mainfrom
doc-373-fix-broken-update-parity-docs-pipeline

Conversation

@HarshCasper

Copy link
Copy Markdown
Member

Motivation

Fixes DOC-373.

The Update Parity Docs pipeline has been failing since mid-June (e.g. this run), so the implementation/parity coverage on service pages stopped updating.

Root cause is the CI restructure in localstack-pro (PR #7263, merged June 2, 2026):

  1. Parity metrics are now only produced by nightly runs. AWS / Build, Test, Push runs the full integration suite (which uploads the parity-metric-pro-raw-amd64-* / parity-metric-raw-amd64-* artifacts) only on schedule events — push-triggered runs only execute acceptance tests. The fetch script (get_latest_github_metrics.sh from localstack/meta) scans only the last 20 successful runs of the workflow, and with ~12 push runs/day that window no longer reaches any nightly run. The pipeline kept working until mid-June only while pre-restructure runs remained inside the 20-run window.
  2. The AWS / Community K8S tests workflow was deleted from localstack-pro in the same restructure, so the parity-metric-community-k8s-integration-raw-* artifacts can never be found again.

Changes

  • Set LIMIT: 200 (env already supported by the fetch script) on the two parity-metric download steps so the artifact search window reaches the latest successful nightly run (currently at index ~26 of the successful-run window; 200 gives ~3 weeks of margin). The success-only filter is deliberately kept: failed nightlies upload incomplete parity artifacts (e.g. missing matrix groups), which would silently understate coverage.
  • Removed the download step for the Free Plan K8s pipeline (AWS / Community K8S tests), since the upstream workflow no longer exists. create_data_coverage.py picks up test sources by CSV filename prefix, so the absence of these files is harmless.

The other steps need no changes: capture-notimplemented* artifacts are still uploaded on every main-branch run, and AWS / Pro K8S tests runs nightly with regular successes.

Testing

Ran get_latest_github_metrics.sh locally with LIMIT=200 for both previously-failing steps — both located the latest successful nightly run (Aug 5) and downloaded all 8 test-group CSVs each, producing the expected pro-integration-test-* / community-integration-test-* files in target/metrics-raw.

After merging, the fix can be verified by manually dispatching the Update Parity Docs workflow.

Since the localstack-pro CI restructure (PR #7263, June 2026), the
parity-metric-* artifacts are only uploaded by scheduled nightly runs
of the 'AWS / Build, Test, Push' workflow, while push-triggered runs
(the vast majority) only execute acceptance tests. The artifact search
window of 20 runs therefore no longer contained any run with parity
metrics. Raise the search window (LIMIT) to 200 runs so the latest
successful nightly run is found.

Also remove the download step for the Free Plan K8s pipeline: the
'AWS / Community K8S tests' workflow was deleted from localstack-pro
in the same restructure, so its artifacts no longer exist.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 421c895
Status: ✅  Deploy successful!
Preview URL: https://62470887.localstack-docs.pages.dev
Branch Preview URL: https://doc-373-fix-broken-update-pa.localstack-docs.pages.dev

View logs

@HarshCasper
HarshCasper merged commit 1b860ed into main Aug 10, 2026
1 of 2 checks passed
@HarshCasper
HarshCasper deleted the doc-373-fix-broken-update-parity-docs-pipeline branch August 10, 2026 13:01
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