Skip to content

Commit 574a163

Browse files
browcodex
andcommitted
docs: clarify gateway chart retrieval
Signed-off-by: Tom Brow <[email protected]> Co-authored-by: Codex <[email protected]> Ai-assisted: true
1 parent a2aed2b commit 574a163

2 files changed

Lines changed: 13 additions & 1 deletion

File tree

‎deploy/charts/buzz-push-gateway/tests/release-contract.sh‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ set -euo pipefail
33
env -u GEM_HOME -u GEM_PATH -u RUBYLIB -u RUBYOPT ruby -ryaml <<'RUBY'
44
auto_text = File.read('.github/workflows/auto-tag-on-release-pr-merge.yml')
55
publish_text = File.read('.github/workflows/push-gateway-helm-chart.yml')
6+
deployment_text = File.read('docs/push-gateway-deployment.md')
67
chart = YAML.load_file('deploy/charts/buzz-push-gateway/Chart.yaml')
78
# Parse first, then pin the tag producer and consumer strings whose agreement
89
# makes this a reachable lane rather than an orphan publisher.
@@ -36,4 +37,14 @@ end
3637
].each do |needle|
3738
raise "missing gateway chart publisher contract: #{needle}" unless publish_text.include?(needle)
3839
end
40+
[
41+
'inspect and fetch the published chart version',
42+
'helm show chart oci://ghcr.io/block/buzz/charts/buzz-push-gateway --version X.Y.Z',
43+
'helm pull oci://ghcr.io/block/buzz/charts/buzz-push-gateway --version X.Y.Z',
44+
].each do |needle|
45+
raise "missing gateway chart retrieval guidance: #{needle}" unless deployment_text.include?(needle)
46+
end
47+
if deployment_text.include?('verify the immutable chart artifact')
48+
raise 'gateway chart retrieval guidance overstates authenticity verification'
49+
end
3950
RUBY

‎docs/push-gateway-deployment.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -263,7 +263,8 @@ version. The publisher verifies the checked-out commit is the tag target and the
263263
chart version equals `X.Y.Z` before pushing
264264
`oci://ghcr.io/block/buzz/charts/buzz-push-gateway`. A manually pushed
265265
`push-chart-vX.Y.Z` tag is the documented rescue path and runs the same checks.
266-
After the publisher succeeds, verify the immutable chart artifact before use:
266+
After the publisher succeeds, inspect and fetch the published chart version
267+
before use:
267268

268269
```bash
269270
helm show chart oci://ghcr.io/block/buzz/charts/buzz-push-gateway --version X.Y.Z

0 commit comments

Comments
 (0)