Skip to content

Model DONs unique versions upgrade from RANE SOT data source#2471

Open
skudasov wants to merge 6 commits intomainfrom
sot-staircase-upgrade
Open

Model DONs unique versions upgrade from RANE SOT data source#2471
skudasov wants to merge 6 commits intomainfrom
sot-staircase-upgrade

Conversation

@skudasov
Copy link
Contributor

@skudasov skudasov commented Mar 11, 2026

This PR models multiple product DONs as one having all unique versions. Read comments for more info


Below is a summarization created by an LLM (gpt-4-0125-preview). Be mindful of hallucinations and verify accuracy.

Why

The changes enhance compatibility testing tools, documentation clarity, and the development experience. They include improvements to test commands, environment setup, and compatibility checks for Chainlink node operators (DONs).

What

  • book/src/framework/compat.md
    • Added a blank line for better readability in the Prerequisites section.
    • Improved the --envcmd command to include additional TOML configuration files for more precise environment setup.
    • Changed the --nodes flag to --upgrade-nodes for clarity in specifying the number of nodes to upgrade during compatibility testing.
    • Added a --strip-image-suffix flag and modified --versions-back for more accurate version testing.
    • Updated the section title to include "WIP" (Work In Progress), indicating ongoing developments.
    • Expanded compatibility testing instructions with additional flags (--no-git-rollback, --don_nodes, etc.) for more comprehensive and flexible testing approaches.
    • Included new instructions to specifically test product data feeds with the --product flag.
  • framework/cmd/main.go
    • Introduced the --no-git-rollback flag within the compat backward command to allow running the current version of environment and command without rolling back Git changes.
    • Modified --nodes flag to --upgrade-nodes and added new flags (--don_nodes, --rane-add-git-tag-prefix, etc.) to enhance the flexibility and specificity of compatibility tests.
    • Adjusted log messages for better clarity and to reflect the purpose of changes accurately.
  • framework/compat.go
    • Added constants, structs, and functions (UpgradeNRollingSummaryTemplate, WriteRollingNUpgradeSummary, UpgradeSOTDONSummary, etc.) to support detailed and structured summaries for compatibility tests.
    • Developed new logic (UpgradeNProductUniqueVersionsRolling, UpgradeNRolling) to facilitate sophisticated testing strategies, including rolling upgrades and testing sequences based on real-world DON configurations.
    • Improved error handling and logging for better feedback during testing processes.
  • framework/rpc/rpc.go
    • Minor adjustments in imports and sleep durations for consistency and reliability in RPC client operations.

@skudasov skudasov requested a review from a team as a code owner March 11, 2026 22:28
@github-actions
Copy link

👋 skudasov, thanks for creating this pull request!

To help reviewers, please consider creating future PRs as drafts first. This allows you to self-review and make any final changes before notifying the team.

Once you're ready, you can mark it as "Ready for review" to request feedback. Thanks!

@skudasov skudasov force-pushed the sot-staircase-upgrade branch from e48f6fc to 271342d Compare March 11, 2026 22:30
@skudasov skudasov force-pushed the sot-staircase-upgrade branch from 91137d9 to 54052d2 Compare March 11, 2026 22:37
@skudasov skudasov force-pushed the sot-staircase-upgrade branch from 2b8ec14 to 6e33731 Compare March 11, 2026 22:46
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