fix and update kube manifests for v7#215
Open
ghost wants to merge 5 commits intohcengineering:mainfrom
Open
Conversation
|
Connected to Huly®: SELFH-213 |
aonnikov
reviewed
Oct 6, 2025
Member
aonnikov
left a comment
There was a problem hiding this comment.
Looks good to me except the section about services. Will you be able to fix it?
Member
|
Hey @crocinsocks ! Sorry for delay, I was busy with something else and it took me some time to pull the code and test it. From what I see, it works fine, so I'm about to merge it. |
aonnikov
approved these changes
Oct 9, 2025
Contributor
|
@aonnikov, when will this be merged? |
dnplkndll
added a commit
to ledoent/huly-selfhost
that referenced
this pull request
Mar 9, 2026
Replace the existing flat kube/ manifests (broken for v7, see hcengineering#181) with a battle-tested Kustomize-based deployment structure. Structure: kube/base/ - config, infra, app, ingress layers kube/overlays/ - example overlay users copy & customize kube/deploy.sh - one-liner deploy script Key design decisions: - Path-based routing (/_accounts, /_transactor, etc.) matching compose.yml - Elasticsearch 7.14.2 (not OpenSearch) - Huly's elasticsearch-js rejects non-ES backends - Explicit env vars on backend services (no bulk envFrom leaking external URLs) - Init containers for startup ordering (busybox wait loops) - Readiness probes on all services (TCP for WS/POST-only, HTTP for REST) - Imperative secret creation (no secret YAML in repo) - huly.example placeholder domain - users must customize via overlay Tested on K3s with v0.7.382. Renders 34 resources: 12 Deployments, 11 Services, 6 Ingresses, 4 PVCs, 1 ConfigMap. Closes hcengineering#181 Addresses hcengineering#20 Supersedes hcengineering#215 Co-Authored-By: Claude Opus 4.6 <[email protected]>
6 tasks
dnplkndll
added a commit
to ledoent/huly-selfhost
that referenced
this pull request
Mar 22, 2026
Replace the existing flat kube/ manifests (broken for v7, see hcengineering#181) with a battle-tested Kustomize-based deployment structure. Structure: kube/base/ - config, infra, app, ingress layers kube/overlays/ - example overlay users copy & customize kube/deploy.sh - one-liner deploy script Key design decisions: - Path-based routing (/_accounts, /_transactor, etc.) matching compose.yml - Elasticsearch 7.14.2 (not OpenSearch) - Huly's elasticsearch-js rejects non-ES backends - Explicit env vars on backend services (no bulk envFrom leaking external URLs) - Init containers for startup ordering (busybox wait loops) - Readiness probes on all services (TCP for WS/POST-only, HTTP for REST) - Imperative secret creation (no secret YAML in repo) - huly.example placeholder domain - users must customize via overlay Tested on K3s with v0.7.382. Renders 34 resources: 12 Deployments, 11 Services, 6 Ingresses, 4 PVCs, 1 ConfigMap. Closes hcengineering#181 Addresses hcengineering#20 Supersedes hcengineering#215 Co-Authored-By: Claude Opus 4.6 <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🧩 Summary
The Kubernetes manifests in this repository were significantly out of date, lacked structure, and offered little guidance for deployment. This pull request modernizes and reorganizes them to make self-hosting Huly easier and more maintainable.
💡 Motivation
I recently discovered this project and wanted to self-host it. While doing so, I realized that the existing Kubernetes setup required a lot of reverse-engineering and manual trial and error — much of which could be avoided with clearer manifests and documentation.
This PR aims to:
kube/.🛠️ Changes
kube/README.mdexplaining prerequisites, service architecture, and routingHTTPRoutedefinition for Gateway API routing🧾 Notes
These changes are based on a recent successful self-hosted deployment.
I’ve included comments and sensible defaults that should make local and test deployments much easier to bootstrap.
🧩 Related Issues
Fixes #181
🙏 Acknowledgment
I really appreciate the effort the team has put into building this project.
This PR is intended as a contribution back to the community — to help others understand the platform internals and deploy it more easily.