Skip to content

OpenHands Enterprise 1.2.1 release (chart 0.2.1)#264

Closed
aivong-openhands wants to merge 12 commits into
mainfrom
update-openhands-runtime-api-charts-01-23-2026
Closed

OpenHands Enterprise 1.2.1 release (chart 0.2.1)#264
aivong-openhands wants to merge 12 commits into
mainfrom
update-openhands-runtime-api-charts-01-23-2026

Conversation

@aivong-openhands

@aivong-openhands aivong-openhands commented Jan 23, 2026

Copy link
Copy Markdown
Contributor

Description

Jan 7 deploy repo release tag from https://www.notion.so/Release-Tracking-2767be798a178098a6faf5125721551c: 0.68.0

Automated chart updates from script created in #262

How the script was run:

Go to script directory: cd scripts/update_openhands_charts

Pass the deploy tag as an argument to the script:

% uv run update_openhands_charts.py --deploy-tag 0.68.0
============================================================
Fetching latest versions...
============================================================
Using specified deploy tag: 0.68.0
Deploy config (from 0.68.0):
  OPENHANDS_SHA: 20eb9bd3c59c374f014e51aecd920761877a5179
  OPENHANDS_RUNTIME_IMAGE_TAG: 20eb9bd3c59c374f014e51aecd920761877a5179-nikolaik
  RUNTIME_API_SHA: 5b8515e07b2d19798a38b9dda6083bc0d7e4fe44
OpenHands version (latest tag containing OPENHANDS_SHA): 1.2.1

============================================================
Updating runtime-api chart...
============================================================
Updating runtime-api Chart.yaml...
Updated runtime-api chart version: 0.1.20 -> 0.1.21

Updating runtime-api values.yaml...
Updated runtime-api image tag: sha-0c907c9 -> sha-5b8515e
Updated runtime-api warmRuntimes image tag: 4ea3e4b1fd850ae07e7b972feb36fca6e789d7eb-nikolaik -> 20eb9bd3c59c374f014e51aecd920761877a5179-nikolaik

============================================================
Updating openhands chart...
============================================================
Updating openhands Chart.yaml...
Updated appVersion: 0.62.0 -> 1.2.1
Updated version: 0.2.0 -> 0.2.1
Updated runtime-api version: 0.1.20 -> 0.1.21

Updating openhands values.yaml...
Updated enterprise-server image tag: sha-4ea3e4b -> sha-20eb9bd
Updated runtime-api image tag: sha-0c907c9 -> sha-5b8515e
Updated runtime image tag: 4ea3e4b1fd850ae07e7b972feb36fca6e789d7eb-nikolaik -> 20eb9bd3c59c374f014e51aecd920761877a5179-nikolaik
Updated warmRuntimes image tag: 4ea3e4b1fd850ae07e7b972feb36fca6e789d7eb-nikolaik -> 20eb9bd3c59c374f014e51aecd920761877a5179-nikolaik

The script makes changes to openhands and runtime-api chart files:

  • charts/openhands/Chart.yaml
  • charts/openhands/values.yaml
  • charts/runtime-api/Chart.yaml
  • charts/runtime-api/values.yaml

The changes were included as part of this PR.

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

@openhands-ai

openhands-ai Bot commented Jan 23, 2026

Copy link
Copy Markdown

Looks like there are a few issues preventing this PR from being merged!

  • GitHub Actions are failing:
    • Preview Helm Charts

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #264 at branch `update-openhands-runtime-api-charts-01-23-2026`

Feel free to include any additional details that might help me get this PR into a better state.

You can manage your notification settings

@aivong-openhands

Copy link
Copy Markdown
Contributor Author

@OpenHands please fix the failing actions on PR #264 at branch update-openhands-runtime-api-charts-01-23-2026

@openhands-ai

openhands-ai Bot commented Jan 23, 2026

Copy link
Copy Markdown

I'm on it! aivong-openhands can track my progress at all-hands.dev

When both openhands and runtime-api charts are modified in a PR, the
lint-and-test job needs to use the alpha version of runtime-api that was
published in the publish-charts job. Without this fix, the openhands chart
lint fails because it tries to download runtime-api version 0.1.21 which
doesn't exist yet (only the alpha version 0.1.21-alpha.264 was published).

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

openhands-ai Bot commented Jan 23, 2026

Copy link
Copy Markdown

I've fixed the failing GitHub Actions on PR #264. The issue was in the lint-and-test job of the preview-helm-charts.yml workflow.

Root Cause:
When both openhands and runtime-api charts are modified in a PR, the lint-and-test job was failing because:

  1. The publish-charts job publishes charts with alpha versions (e.g., runtime-api:0.1.21-alpha.264)
  2. The lint-and-test job then checks out fresh code and tries to run helm dependency update on the openhands chart
  3. The openhands chart's Chart.yaml still references runtime-api:0.1.21 (not the alpha version)
  4. Since runtime-api:0.1.21 doesn't exist in the registry yet (only the alpha version was published), the dependency update fails

Fix Applied:
Added a new step to the lint-and-test job that updates the runtime-api dependency version to the alpha version before running helm lint/template. This mirrors the same logic already present in the publish-charts job.

Changes:

  • Modified .github/workflows/preview-helm-charts.yml:
    • Added detect-changes to the needs array for lint-and-test job
    • Added a new step "Update runtime-api dependency version for openhands" that runs conditionally when testing the openhands chart and runtime-api has changes

The fix has been pushed to the update-openhands-runtime-api-charts-01-23-2026 branch and should trigger a new workflow run that passes.

View full conversation

Comment thread .github/workflows/preview-helm-charts.yml
@aivong-openhands aivong-openhands marked this pull request as ready for review January 23, 2026 20:35
Comment thread charts/openhands/Chart.yaml Outdated
Comment thread .github/workflows/pr-checks.yml Outdated
Comment thread .github/workflows/preview-helm-charts.yml Outdated
@aivong-openhands

Copy link
Copy Markdown
Contributor Author

How would I go about steps 2 and 3 in the helm chart checklist?

@aivong-openhands

Copy link
Copy Markdown
Contributor Author

How would I go about steps 2 and 3 in the helm chart checklist?

Checked 3 since fields have not changed for values.yaml configs

@raymyers

Copy link
Copy Markdown
Contributor

Checked 3 since fields have not changed for values.yaml configs

Yes I think it's fine as is. They don't all have to be checked, they might not apply.

Comment thread charts/runtime-api/values.yaml
@raymyers raymyers changed the title OpenHands Enterprise 1.2.1 release OpenHands Enterprise 1.2.1 release (chart 0.2.1) Jan 23, 2026
@jpshackelford

jpshackelford commented Jan 24, 2026

Copy link
Copy Markdown
Member

When @chuckbutkus and I have worked with the LiteLLM charts one of the things that has annoyed us both is that you can't tell from looking at the chart version what the LiteLLM version is and so you have to drill in to figure it out which just adds friction to troubleshooting. It seems like we do a similar thing -- all though we do helpfully provide the app version in the chart which provides a bit quicker answer. What do you all think about moving toward chart versioning scheme that aligns at least first two digits of sym version between and chart and OpenHands/OpenHands version? We could even align all three digits and add --patch0,-patch1 suffix for chart only changes.

WDYT?

@raymyers

Copy link
Copy Markdown
Contributor

@jpshackelford I'm on board with the need of easily being able to tell what's in the release. Litellm version is a new example to me but it makes sense.

I think there are other options besides a version convention we can consider for this so let's start with the goal. What information do you want to be able to easily pull from chart version? And if relevant, which of it is most important.

@mamoodi

mamoodi commented Jan 26, 2026

Copy link
Copy Markdown
Contributor

Honestly, I think it might be easier to just have a wiki page with information on what sha is in each release.

@aivong-openhands

Copy link
Copy Markdown
Contributor Author

@jpshackelford @mamoodi could I get a review on the chart changes in this PR?

@aivong-openhands

Copy link
Copy Markdown
Contributor Author

Closing as the changes in this chart release seem stale now and we have an automated script to cut a new chart version!

neubig pushed a commit that referenced this pull request Jun 26, 2026
OpenHands/integrations-hub#264 removed the legacy unprefixed env-var
fallbacks from the FastAPI backend, so the backend now reads only the
INTHUB_-prefixed names. Two chart env vars were still using the old
unprefixed names and would silently stop being read after #264 lands:

- APP_ADMIN_EMAILS -> INTHUB_APP_ADMIN_EMAILS
  The admin allowlist would have gone empty, locking out /api/admin/*
  access in Kubernetes deployments. The backend now accepts
  comma-separated syntax for the prefixed name (it also accepts JSON
  arrays), so the old "use unprefixed because the SDK parser expects
  JSON" workaround is obsolete.

- AUTH_REDIRECT_PROXY_URL -> INTHUB_OAUTH_REDIRECT_PROXY_URL
  Pre-existing mismatch: oauth_flow.py already read the prefixed name,
  so the proxy var was never wired through. Fixed here while aligning
  the rest of the chart with the INTHUB_*-only backend.

Updated the header doc block in templates/_env.yaml to drop the removed
fallback chain, and refreshed the matching comments in both the
subchart values.yaml and the parent chart values.yaml.

Bumped the openhands umbrella chart 0.7.76 -> 0.7.77 (required by the
validate-chart-versions check since charts/openhands/values.yaml
changed). The integrations-hub subchart itself is inert (version 0.0.0,
ships at whatever openhands version bundles it).

Co-authored-by: openhands <openhands@all-hands.dev>
neubig added a commit that referenced this pull request Jun 26, 2026
#756)

OpenHands/integrations-hub#264 removed the legacy unprefixed env-var
fallbacks from the FastAPI backend, so the backend now reads only the
INTHUB_-prefixed names. Two chart env vars were still using the old
unprefixed names and would silently stop being read after #264 lands:

- APP_ADMIN_EMAILS -> INTHUB_APP_ADMIN_EMAILS
  The admin allowlist would have gone empty, locking out /api/admin/*
  access in Kubernetes deployments. The backend now accepts
  comma-separated syntax for the prefixed name (it also accepts JSON
  arrays), so the old "use unprefixed because the SDK parser expects
  JSON" workaround is obsolete.

- AUTH_REDIRECT_PROXY_URL -> INTHUB_OAUTH_REDIRECT_PROXY_URL
  Pre-existing mismatch: oauth_flow.py already read the prefixed name,
  so the proxy var was never wired through. Fixed here while aligning
  the rest of the chart with the INTHUB_*-only backend.

Updated the header doc block in templates/_env.yaml to drop the removed
fallback chain, and refreshed the matching comments in both the
subchart values.yaml and the parent chart values.yaml.

Bumped the openhands umbrella chart 0.7.76 -> 0.7.77 (required by the
validate-chart-versions check since charts/openhands/values.yaml
changed). The integrations-hub subchart itself is inert (version 0.0.0,
ships at whatever openhands version bundles it).

Co-authored-by: openhands <openhands@all-hands.dev>
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.

5 participants