From 212e6834891977cc29b8246ff39a5c080121d890 Mon Sep 17 00:00:00 2001 From: Randy <857271370@qq.com> Date: Wed, 4 Nov 2026 14:31:09 +0800 Subject: [PATCH 1/5] =?UTF-8?q?chore:=20=F0=9F=93=84=20license=20under=20M?= =?UTF-8?q?IT?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- LICENSE | 21 +++++++++++++++++++++ charts/weir/LICENSE | 21 +++++++++++++++++++++ 2 files changed, 42 insertions(+) create mode 100644 LICENSE create mode 100644 charts/weir/LICENSE diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..6e5a0e7 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Randy + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/charts/weir/LICENSE b/charts/weir/LICENSE new file mode 100644 index 0000000..6e5a0e7 --- /dev/null +++ b/charts/weir/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Randy + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. From 262faa3d9eaf48dc3e81cb841f4fef0ecd6676e4 Mon Sep 17 00:00:00 2001 From: Randy <857271370@qq.com> Date: Wed, 4 Nov 2026 14:31:09 +0800 Subject: [PATCH 2/5] =?UTF-8?q?docs:=20=F0=9F=93=9D=20add=20contribution?= =?UTF-8?q?=20and=20security=20guides=20with=20issue=20forms?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/bug_report.yml | 41 ++++++++++++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 11 ++++++ .github/ISSUE_TEMPLATE/feature_request.yml | 22 ++++++++++++ .github/pull_request_template.md | 4 +++ CONTRIBUTING.md | 35 ++++++++++++++++++ SECURITY.md | 21 +++++++++++ 6 files changed, 134 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml create mode 100644 .github/pull_request_template.md create mode 100644 CONTRIBUTING.md create mode 100644 SECURITY.md diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..f218907 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,41 @@ +name: Bug report +description: Report incorrect behavior with a reproducible example. +body: + - type: markdown + attributes: + value: | + For security vulnerabilities, use [private reporting](https://github.com/batchstream/weir-charts/security/advisories/new). + Remove credentials, private endpoints and document data from logs and configuration. + - type: input + id: version + attributes: + label: Chart version + description: Chart version from `helm list`, or commit SHA. + validations: + required: true + - type: textarea + id: environment + attributes: + label: Environment + description: Kubernetes and Helm versions, Weir image digest, backend and version, and relevant values. + validations: + required: true + - type: textarea + id: reproduction + attributes: + label: Steps to reproduce + description: Include the smallest request, script or test case that reproduces the problem. + validations: + required: true + - type: textarea + id: expected + attributes: + label: Expected and actual behavior + validations: + required: true + - type: textarea + id: diagnostics + attributes: + label: Logs and configuration + description: Relevant, redacted diagnostics. For performance issues, include the workload and resource limits. + render: text diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..5362aa2 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,11 @@ +blank_issues_enabled: true +contact_links: + - name: Documentation + url: https://github.com/batchstream/weir-charts#readme + about: Usage and development guide for this repository. + - name: Weir server issues + url: https://github.com/batchstream/weir/issues + about: Report problems specific to the Weir server. + - name: Security vulnerability + url: https://github.com/batchstream/weir-charts/security/advisories/new + about: Report a vulnerability privately. diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..1f04aab --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,22 @@ +name: Feature request +description: Propose an improvement to the Weir Helm chart. +body: + - type: textarea + id: problem + attributes: + label: Problem or use case + description: What are you trying to achieve, and what is difficult today? + validations: + required: true + - type: textarea + id: proposal + attributes: + label: Proposed behavior + description: Describe the desired API or user experience, with an example if possible. + validations: + required: true + - type: textarea + id: alternatives + attributes: + label: Alternatives and constraints + description: Existing workarounds, affected backends and operational constraints. diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..17c254e --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,4 @@ + + + diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..8a32e6a --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,35 @@ +# Contributing to the Weir Helm chart + +Focused bug fixes, documentation improvements, tests and feature proposals are +welcome. Open an [issue](https://github.com/batchstream/weir-charts/issues/new/choose) first for a change +that depends on new [server](https://github.com/batchstream/weir) behavior. + +## Report a problem + +Use the issue forms and include the chart version, the Weir image digest, the +Kubernetes and Helm versions, the relevant values, the expected result and a minimal +reproduction. Remove credentials and private data from logs and values. + +For vulnerabilities, follow [SECURITY.md](SECURITY.md). + +## Work locally + +Install Helm, Python 3 and the Go version the chart's workflows use, then follow +[Develop and release](README.md#develop-and-release): + +```sh +python3 -m venv .venv +.venv/bin/pip install -r requirements-dev.txt +GOBIN="$PWD/.bin" go install github.com/batchstream/weir/cmd/weir@SOURCE_REVISION +make test PYTHON=.venv/bin/python WEIR_BIN="$PWD/.bin/weir" +``` + +`SOURCE_REVISION` is the `weir.batchstream.io/source-revision` annotation in +`Chart.yaml`. `make test` also needs `promtool` on `PATH` or in `PROMTOOL`. + +## Prepare a pull request + +- Keep the change focused and explain the observed problem and resulting behavior. +- Add a regression test when fixing behavior. +- Update `values.schema.json`, the [examples](examples) and the README when values change. +- Change the source revision, the image digest and the README's references to them together. diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..721b173 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,21 @@ +# Security policy + +## Report a vulnerability + +Use GitHub's private +[Report a vulnerability](https://github.com/batchstream/weir-charts/security/advisories/new) +form. Include the affected chart version or commit, reproduction steps, impact, +and relevant deployment settings with credentials and private data removed. +Please keep exploit details out of public issues while a report is being +investigated. + +## Versions + +Check whether an issue is still present in the chart on `main`. Older chart +versions do not have a guaranteed security backport schedule. Report suspected +vulnerabilities even if you cannot reproduce them on `main`. + +## Deployment guidance + +Application traffic uses plaintext HTTP/2 inside a trusted, isolated network. See +[Network and operations](README.md#network-and-operations). From 79496c27b085faa2afb22b117c09530b51627ea2 Mon Sep 17 00:00:00 2001 From: Randy <857271370@qq.com> Date: Wed, 4 Nov 2026 14:31:09 +0800 Subject: [PATCH 3/5] =?UTF-8?q?docs:=20=F0=9F=93=9D=20open=20the=20README?= =?UTF-8?q?=20with=20a=20banner,=20badges=20and=20project=20links?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/assets/banner.svg | 63 +++++++++++++++++++++++++++++++++++++++ README.md | 22 ++++++++++++++ 2 files changed, 85 insertions(+) create mode 100644 .github/assets/banner.svg diff --git a/.github/assets/banner.svg b/.github/assets/banner.svg new file mode 100644 index 0000000..4ce8533 --- /dev/null +++ b/.github/assets/banner.svg @@ -0,0 +1,63 @@ + + weir-charts: Run Weir Store groups with Helm. + Many small packets converge on a weir and leave through its notch as larger, bounded batches. + + + + + + + + + + + + + + + + + + + + + + + + + KUBERNETES DEPLOYMENT + weir-charts + Run Weir Store groups with Helm. + Helm · Prometheus · Grafana · KEDA + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/README.md b/README.md index b765d81..4c9558e 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,19 @@ +

+ weir-charts: run Weir Store groups with Helm. +

+ +

+ Validate chart + Chart version + Kubernetes 1.30+ + Helm 3.17+ + MIT license +

+ +

+ Server  ·  Go SDK  ·  Protocol  ·  Helm chart  ·  System tests +

+ # Weir Helm charts Deploy [Weir](https://github.com/batchstream/weir), a synchronous MongoDB and Search data plane, on Kubernetes. Helm 3.17+ and Kubernetes 1.30+ are required. Chart `0.20.0-rc.1` targets server source [commit `5107986b882d`](https://github.com/batchstream/weir/commit/5107986b882da60751403c7e05bbbebdb12b3cdb). `Chart.yaml` records that source contract and `values.yaml` pins the immutable image `ghcr.io/batchstream/weir@sha256:b5d949cefb0ba01e18cff2b5210cef954bc387c20cffa87784466e793e0e088e`; both validation and release workflows install that exact source with `go install`. @@ -96,3 +112,9 @@ scripts/kind-upgrade.sh FROM_CHECKOUT . path/to/weir-soak [path/to/previous-weir ``` A reviewed `weir-VERSION` tag on `main` publishes the OCI Chart and a GitHub release with the archive and SHA256SUMS. The workflow refuses a version whose OCI Chart already exists and creates the release before pushing, so a rerun never overwrites a published Chart. If the push fails after the release exists, verify the release archive against its SHA256SUMS and `helm push` it by hand. Source annotation, image digest and CI source pins must identify the same server revision. + +## Contributing and license + +Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request, and report +vulnerabilities as described in [SECURITY.md](SECURITY.md). This repository is +released under the [MIT License](LICENSE). From 09d2d825210bf499d7ff974b69c0d769e48ecc95 Mon Sep 17 00:00:00 2001 From: Randy <857271370@qq.com> Date: Wed, 4 Nov 2026 14:38:49 +0800 Subject: [PATCH 4/5] =?UTF-8?q?docs:=20=F0=9F=93=9D=20keep=20the=20README?= =?UTF-8?q?=20plain=20with=20a=20single=20line=20of=20badges?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/assets/banner.svg | 63 --------------------------------------- README.md | 24 ++------------- 2 files changed, 2 insertions(+), 85 deletions(-) delete mode 100644 .github/assets/banner.svg diff --git a/.github/assets/banner.svg b/.github/assets/banner.svg deleted file mode 100644 index 4ce8533..0000000 --- a/.github/assets/banner.svg +++ /dev/null @@ -1,63 +0,0 @@ - - weir-charts: Run Weir Store groups with Helm. - Many small packets converge on a weir and leave through its notch as larger, bounded batches. - - - - - - - - - - - - - - - - - - - - - - - - - KUBERNETES DEPLOYMENT - weir-charts - Run Weir Store groups with Helm. - Helm · Prometheus · Grafana · KEDA - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/README.md b/README.md index 4c9558e..848d215 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,7 @@ -

- weir-charts: run Weir Store groups with Helm. -

- -

- Validate chart - Chart version - Kubernetes 1.30+ - Helm 3.17+ - MIT license -

- -

- Server  ·  Go SDK  ·  Protocol  ·  Helm chart  ·  System tests -

- # Weir Helm charts +[![CI](https://github.com/batchstream/weir-charts/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/batchstream/weir-charts/actions/workflows/ci.yaml) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) + Deploy [Weir](https://github.com/batchstream/weir), a synchronous MongoDB and Search data plane, on Kubernetes. Helm 3.17+ and Kubernetes 1.30+ are required. Chart `0.20.0-rc.1` targets server source [commit `5107986b882d`](https://github.com/batchstream/weir/commit/5107986b882da60751403c7e05bbbebdb12b3cdb). `Chart.yaml` records that source contract and `values.yaml` pins the immutable image `ghcr.io/batchstream/weir@sha256:b5d949cefb0ba01e18cff2b5210cef954bc387c20cffa87784466e793e0e088e`; both validation and release workflows install that exact source with `go install`. One Helm release is one Store group. Every replica hosts the same Store definitions; a group can host several Stores, and each group is released and scaled independently. Replicas share nothing with each other. Each Pod runs one Weir process with Lua inside that process. Backends, collections, indices, credentials and backups are provisioned separately. @@ -112,9 +98,3 @@ scripts/kind-upgrade.sh FROM_CHECKOUT . path/to/weir-soak [path/to/previous-weir ``` A reviewed `weir-VERSION` tag on `main` publishes the OCI Chart and a GitHub release with the archive and SHA256SUMS. The workflow refuses a version whose OCI Chart already exists and creates the release before pushing, so a rerun never overwrites a published Chart. If the push fails after the release exists, verify the release archive against its SHA256SUMS and `helm push` it by hand. Source annotation, image digest and CI source pins must identify the same server revision. - -## Contributing and license - -Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request, and report -vulnerabilities as described in [SECURITY.md](SECURITY.md). This repository is -released under the [MIT License](LICENSE). From 3dc315155fd200c7f8bb2a4086f36f42a13990c5 Mon Sep 17 00:00:00 2001 From: Randy <857271370@qq.com> Date: Wed, 4 Nov 2026 14:48:49 +0800 Subject: [PATCH 5/5] =?UTF-8?q?docs:=20=F0=9F=93=9D=20list=20every=20pin?= =?UTF-8?q?=20a=20server=20change=20touches=20and=20when=20promtool=20runs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8a32e6a..56dc8d5 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -25,11 +25,12 @@ make test PYTHON=.venv/bin/python WEIR_BIN="$PWD/.bin/weir" ``` `SOURCE_REVISION` is the `weir.batchstream.io/source-revision` annotation in -`Chart.yaml`. `make test` also needs `promtool` on `PATH` or in `PROMTOOL`. +`Chart.yaml`. With `promtool` on `PATH` or in `PROMTOOL`, `make test` also checks the +rendered alerts and the autoscaling query; without it, that test is skipped. ## Prepare a pull request - Keep the change focused and explain the observed problem and resulting behavior. - Add a regression test when fixing behavior. - Update `values.schema.json`, the [examples](examples) and the README when values change. -- Change the source revision, the image digest and the README's references to them together. +- When pinning a new server, pin it in [weir-tests](https://github.com/batchstream/weir-tests) first, then change the source annotation, `appVersion`, image digest, workflow pins, the README's references and the values in `tests/test_chart.py` together.