PLTF-19: Automate updating OpenHands and runtime-api charts for enterprise release by aivong-openhands · Pull Request #262 · OpenHands/OpenHands-Cloud

aivong-openhands · 2026-01-22T17:28:52Z

Description

Adding a script that makes the relevant chart updates for an OpenHands enterprise release

Helm Chart Checklist

I have updated the version field in Chart.yaml for each modified chart
I have tested the chart upgrade path from the previous version
I have verified backwards compatibility with existing values.yaml configurations
I have updated the chart's README.md if there are any breaking changes or new required values

Additional Notes

Script run generated the following changes: #264

Co-authored-by: openhands <openhands@all-hands.dev>

…ates Co-authored-by: openhands <openhands@all-hands.dev>

Co-authored-by: openhands <openhands@all-hands.dev>

The script now only updates the chart files locally. Users can use external tools like gh CLI or peter-evans/create-pull-request action to handle git operations and PR creation. Co-authored-by: openhands <openhands@all-hands.dev>

Instead of fetching the latest semver tag from OpenHands/OpenHands repo, the script now: 1. Gets the OPENHANDS_SHA from the deploy config 2. Runs git tag --contains on the local OpenHands repo 3. Uses the latest semver tag containing that commit as appVersion This ensures the appVersion matches the actual deployed commit. Co-authored-by: openhands <openhands@all-hands.dev>

…updates Co-authored-by: openhands <openhands@all-hands.dev>

- Update runtime-api chart files first and use the bumped version for the openhands chart dependency instead of fetching from OCI registry - Remove get_latest_helm_chart_version function (no longer needed) - Simplify flow by removing conditional deploy_config check (already required earlier in the function) Co-authored-by: openhands <openhands@all-hands.dev>

Co-authored-by: openhands <openhands@all-hands.dev>

aivong-openhands · 2026-01-23T17:59:29Z

I'd be fine trying this method out to cut tomorrow's release, and merging if it works.
I'm tempted to separate this script as the file update from the commands to commit and make PR (potentially using, but I don't feel strongly enough to ask for change here, we can feel it out.
We have the github cli's gh pr create, and in GitHub actions there is peter-evans/create-pull-request.

I started the script with just the file update so I feel it would be easy enough to go back to that. Sounds good on feeling it out!

I wasn't aware of gh pr create but that's great to know. Perfect, if this script works out, we can migrate to github actions down the line if we'd like

To reduce scope of this script, the commit and create PR logic has been removed in 03b3542

- Rename update-openhands-chart.py to update_openhands_charts.py - Rename test_update_openhands_chart.py to test_update_openhands_charts.py - Update README.md references - Fix typo: update_openhand_chart -> update_openhands_chart Co-authored-by: openhands <openhands@all-hands.dev>

- Move update_openhands_charts.py, test_update_openhands_charts.py, and README.md to their own folder under scripts/ - Update REPO_ROOT path to account for new folder structure - Update README.md with correct paths Co-authored-by: openhands <openhands@all-hands.dev>

This reverts commit 38e0943.

aivong-openhands · 2026-01-23T22:15:33Z

            path: charts/openhands
-
+      # because openhands depends on runtime-api
+      max-parallel: 1


I believe this PR needs to be merged before #264 so that the runtime-api chart publish can happen before the openhands chart publish

Good thinking.

- Add runtime_api_sha parameter to update_runtime_api_values function - Update image.tag in runtime-api values.yaml with sha-SHORT_SHA format - Add test for image tag update Co-authored-by: openhands <openhands@all-hands.dev>

raymyers · 2026-01-23T23:10:02Z

One last thing. When I ran this before setting the env var, it didn't get output indicating the problem was that I needed to set the token.

Approving, you're welcome to merge when you believe this is addressed.

 ./scripts/update_openhands_charts/update_openhands_charts.py 
Installed 13 packages in 21ms
============================================================
Fetching latest versions...
============================================================
Error fetching tags from OpenHands/deploy: 404 {"message": "Not Found", "documentation_url": "https://docs.github.com/rest/repos/repos#get-a-repository", "status": "404"}
No deploy semantic version tag found

aivong-openhands · 2026-01-23T23:35:19Z

One last thing. When I ran this before setting the env var, it didn't get output indicating the problem was that I needed to set the token.

Approving, you're welcome to merge when you believe this is addressed.
 ./scripts/update_openhands_charts/update_openhands_charts.py 
Installed 13 packages in 21ms
============================================================
Fetching latest versions...
============================================================
Error fetching tags from OpenHands/deploy: 404 {"message": "Not Found", "documentation_url": "https://docs.github.com/rest/repos/repos#get-a-repository", "status": "404"}
No deploy semantic version tag found

Updated in 8d7cbc2

User sees the following error if they have not set their token env var:

% uv run update_openhands_charts.py          
Environment variable GITHUB_TOKEN is required. Try getting with: gh auth status --show-token

openhands-agent and others added 30 commits January 21, 2026 20:57

Add empty update-openhands-chart script

b0a3ae9

Co-authored-by: openhands <openhands@all-hands.dev>

rename to py

b744af0

Add PyGithub to fetch latest tag from OpenHands repo

58257e7

Co-authored-by: openhands <openhands@all-hands.dev>

Filter tags to match semantic version format (x.y.z)

4f98c72

Co-authored-by: openhands <openhands@all-hands.dev>

Add functionality to update Chart.yaml appVersion with latest tag

cd11761

Co-authored-by: openhands <openhands@all-hands.dev>

Replace ruamel.yaml with PyYAML

2978a17

Co-authored-by: openhands <openhands@all-hands.dev>

Change repo reference to OpenHands/OpenHands to prevent redirection

f55479b

Co-authored-by: openhands <openhands@all-hands.dev>

Use regex to update appVersion without reformatting YAML

ef5a4bd

Co-authored-by: openhands <openhands@all-hands.dev>

Use ruamel.yaml to preserve original YAML formatting

bf5ac44

Co-authored-by: openhands <openhands@all-hands.dev>

Add README with script usage instructions

8524dea

Co-authored-by: openhands <openhands@all-hands.dev>

remove note

ee17c9f

Add patch version bump for chart version field

3de9479

Co-authored-by: openhands <openhands@all-hands.dev>

Add runtime-api version update from OCI registry

463fe2c

Co-authored-by: openhands <openhands@all-hands.dev>

Add message when runtime-api version is already latest

8035e1a

Co-authored-by: openhands <openhands@all-hands.dev>

Add unit tests for update-openhands-chart script

3b90cd5

Co-authored-by: openhands <openhands@all-hands.dev>

Remove __pycache__ from version control

cfc66d2

Co-authored-by: openhands <openhands@all-hands.dev>

Add deploy repo tag fetching with GITHUB_TOKEN support

91ff6e7

Co-authored-by: openhands <openhands@all-hands.dev>

Fetch deploy config values from deploy.yaml workflow

13e13de

Co-authored-by: openhands <openhands@all-hands.dev>

Update enterprise-server image tag from deploy config

fcdad69

Co-authored-by: openhands <openhands@all-hands.dev>

Update runtime-api image tag from deploy config

2da7239

Co-authored-by: openhands <openhands@all-hands.dev>

Update runtime image tag from deploy config

94ad52b

Co-authored-by: openhands <openhands@all-hands.dev>

Add unit tests for DeployConfig and update_values

96b024f

Co-authored-by: openhands <openhands@all-hands.dev>

Remove __pycache__ from version control

6034e28

Co-authored-by: openhands <openhands@all-hands.dev>

Add get_short_sha helper function and unit tests

d4f67b6

Co-authored-by: openhands <openhands@all-hands.dev>

Add __pycache__ to .gitignore

52e739e

Co-authored-by: openhands <openhands@all-hands.dev>

Add console output separation between fetched and updated values

9d5e3cb

Co-authored-by: openhands <openhands@all-hands.dev>

Remove __pycache__ files

494ef14

Co-authored-by: openhands <openhands@all-hands.dev>

Fix .gitignore format

7fbd647

Co-authored-by: openhands <openhands@all-hands.dev>

Add console output distinction between Chart.yaml and values.yaml upd…

b8d6cc3

…ates Co-authored-by: openhands <openhands@all-hands.dev>

Add format_sha_tag helper function and unit tests

7fc496e

Co-authored-by: openhands <openhands@all-hands.dev>

aivong-openhands and others added 11 commits January 23, 2026 10:25

elaborate on help

3cf83e6

Merge branch 'main' into aivong/openhands-chart-script

07fcdc4

Remove commit and PR creation logic from update script

03b3542

The script now only updates the chart files locally. Users can use external tools like gh CLI or peter-evans/create-pull-request action to handle git operations and PR creation. Co-authored-by: openhands <openhands@all-hands.dev>

Improve console output to distinguish openhands vs runtime-api chart …

c57c2b0

…updates Co-authored-by: openhands <openhands@all-hands.dev>

add help command in readme

0d64d0b

rename openhands specific functions

7139d3d

specify var name instead of sha to reduce duplicated values

6efe680

Checkout main branch before getting semver tag containing commit

9acaa0a

Co-authored-by: openhands <openhands@all-hands.dev>

update readme

54cda22

aivong-openhands mentioned this pull request Jan 23, 2026

OpenHands Enterprise 1.2.1 release (chart 0.2.1) #264

Closed

4 tasks

aivong-openhands changed the title ~~PLTF-19: Automate updating OpenHands charts for release~~ PLTF-19: Automate updating OpenHands and runtime-api charts for enterprise release Jan 23, 2026

openhands-agent and others added 6 commits January 23, 2026 18:07

Merge branch 'main' into aivong/openhands-chart-script

832316f

run PR checks sequentially

38e0943

Revert "run PR checks sequentially"

f88ebab

This reverts commit 38e0943.

Merge branch 'main' into aivong/openhands-chart-script

d90f73d

aivong-openhands commented Jan 23, 2026

View reviewed changes

aivong-openhands requested a review from raymyers January 23, 2026 22:22

raymyers approved these changes Jan 23, 2026

View reviewed changes

exit when github token envvar is not set

8d7cbc2

aivong-openhands merged commit aa582e9 into main Jan 23, 2026

aivong-openhands deleted the aivong/openhands-chart-script branch January 23, 2026 23:36

jpshackelford mentioned this pull request Feb 12, 2026

GitHub Workflow to Publish Self-Hosted Images to S3 OpenHands/OpenHands#10886

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

PLTF-19: Automate updating OpenHands and runtime-api charts for enterprise release#262

PLTF-19: Automate updating OpenHands and runtime-api charts for enterprise release#262
aivong-openhands merged 66 commits into
mainfrom
aivong/openhands-chart-script

aivong-openhands commented Jan 22, 2026 •

edited

Loading

Uh oh!

aivong-openhands commented Jan 23, 2026

Uh oh!

aivong-openhands Jan 23, 2026

Uh oh!

raymyers Jan 23, 2026

Uh oh!

raymyers commented Jan 23, 2026 •

edited

Loading

Uh oh!

aivong-openhands commented Jan 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

aivong-openhands commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Helm Chart Checklist

Additional Notes

Uh oh!

aivong-openhands commented Jan 23, 2026

Uh oh!

aivong-openhands Jan 23, 2026

Choose a reason for hiding this comment

Uh oh!

raymyers Jan 23, 2026

Choose a reason for hiding this comment

Uh oh!

raymyers commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

aivong-openhands commented Jan 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

aivong-openhands commented Jan 22, 2026 •

edited

Loading

raymyers commented Jan 23, 2026 •

edited

Loading