bitflicker64 opened a new pull request, #3218:
URL: https://github.com/apache/hugegraph/pull/3218
## Purpose of the PR
- close #3131
Add an official Helm installation path for the distributed HugeGraph HStore
topology on Kubernetes. The chart packages the PD, Store and Server startup
contract that otherwise has to be reconstructed by each operator, with
authentication on by default and an optional Hubble UI.
This PR succeeds #3132 (closed, history and earlier review threads preserved
there). Its head is the org branch `hugegraph:feat/hstore-helm-chart-3132`, the
same branch as hugegraph/hugegraph#221, so this PR and the org-side review stay
on one branch and cannot drift. Review happens on #221, where the GitHub review
apps can run; ASF repository settings block their permissions here.
## Main Changes
- `helm/hugegraph/`: chart 0.1.0 with PD and Store StatefulSets, a Server
Deployment, an optional Hubble Deployment, three values presets (`values.yaml`,
`values-single.yaml`, `values-cluster.yaml`), a full `values.schema.json`, and
66 helm-unittest cases.
- Encodes the distributed startup contract: Server skips `init-store` and
registers per-Pod with PD, the Store waits for a PD quorum on `/v1/ready`, PD
readiness is quorum-aware while startup and liveness stay on `/v1/health`, and
`HG_SERVER_STARTUP_TIMEOUT_S` is derived from the startup probe budget.
- One shared PD REST secret (`pd.auth`) consumed by PD, the Server storage
wait and Hubble; chart-managed admin and JWT Secrets with bring-your-own
`existingSecret` paths.
- `.github/workflows/helm-chart-ci.yml`: lint, renders on all presets,
fail-path guards, kubeconform, a legacy `--reuse-values` fixture render, and
packaging.
- README covering install, upgrade rolls, disaster recovery, troubleshooting
and Limitations.
## Verifying these changes
- [ ] Trivial rework / code cleanup without any test coverage. (No Need)
- [ ] Already covered by existing tests, such as *(please modify tests
here)*.
- [x] Need tests and can be verified as follows:
- Helm Chart CI: lint, preset renders, 15 fail-path guards, kubeconform
(1.23.0 and current), legacy-values render, packaging.
- Fault campaigns on Kind (2026-08-21 to 2026-09-10, summarized in [the
2026-09-10 campaign
comment](https://github.com/apache/hugegraph/pull/3132#issuecomment-5611399757)):
install, PD leader and follower loss, 2-of-3 PD loss, Store loss, PVC
reattach, rolling restart under load, secret rotation, image upgrade.
- Independent 8/8 fault battery on a three-node k3s by @SebastianGruza
([report](https://github.com/apache/hugegraph/pull/3132#issuecomment-5701778807),
scripts in SebastianGruza/hugegraph-validation).
Current work queue, from the [review on
#221](https://github.com/hugegraph/hugegraph/pull/221) (2026-09-17): fix the
inline findings, run the helm-unittest suites in CI, and one current-image
lifecycle run (managed PD/JWT rotation, Store replacement with a persisted
record, the documented recovery procedure). Image tags and `appVersion` stay
`latest` until a 1.8.x release exists; the pin is a follow-up commit.
## Does this PR potentially affect the following parts?
- [ ] Dependencies
- [ ] Modify configurations
- [ ] The public API
- [x] Other affects (adds a Helm chart under `helm/` and one CI workflow;
no Java changes)
- [ ] Nope
## Documentation Status
- [ ] `Doc - TODO`
- [x] `Doc - Done`
- [ ] `Doc - No Need`
Documentation files in this PR or paired hugegraph-doc PR:
`helm/hugegraph/README.md`. A Helm installation page for the hugegraph-doc
site follows once the chart merges, as agreed on #3132.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
