Skip to content

Agent Mesh

fix helm jobs

Antonio Ojea052ad44af650
diff --git a/charts/sam-mesh/README.md b/charts/sam-mesh/README.md
new file mode 100644
index 00000000..e271237b
--- /dev/null
+++ b/charts/sam-mesh/README.md
@@ -0,0 +1,67 @@
+# sam-mesh Helm chart
+
+Deploys a self-contained SAM mesh (control plane, router, console, and
+optionally an in-cluster Postgres + Dex) for local development, testing, or
+self-hosting your own hub.
+
+> For large-scale production deployments (GKE/EKS/AKS) using externally
+> managed Postgres/DNS/OIDC, see the
+> [Production Kubernetes Deployment guide](https://sam-mesh.dev/docs/user/kubernetes-deployment/),
+> which uses plain manifests instead of this chart.
+
+## Install
+
+```bash
+helm upgrade --install sam-mesh ./charts/sam-mesh --namespace sam --create-namespace
+```
+
+At the end of `helm install`/`helm upgrade`, the chart prints the exact
+`kubectl` command to retrieve your generated secrets (see below) — read the
+NOTES output before doing anything else.
+
+## Secrets: `controlPlane.adminToken` and `database.postgres.password`
+
+Both default to `""` in [values.yaml](values.yaml). When left blank, the chart
+**auto-generates** a random 32-character secret on first install and stores it
+in the `<release>-secrets` Kubernetes Secret; the same value is reused on
+`helm upgrade` (it is not rotated on every upgrade). Retrieve the admin token
+with:
+
+```bash
+kubectl get secret --namespace <namespace> <release>-secrets -o jsonpath='{.data.admin-token}' | base64 -d; echo
+```
+
+You can also pin either value explicitly instead of letting the chart
+generate one, e.g. for reproducible dev environments or to match an
+existing secret:
+
+```bash
+helm upgrade --install sam-mesh ./charts/sam-mesh \
+ --set controlPlane.adminToken="$(openssl rand -hex 32)" \
+ --set database.postgres.password="$(openssl rand -hex 32)"
+```
+
+## `controlPlane.insecureSkipTlsVerify`
+
+Defaults to `false`. Only set this to `true` when `controlPlane.oidcIssuer`
+points at an OIDC issuer served with a self-signed or otherwise untrusted
+certificate — for example the Kubernetes API server's own issuer
+(`https://kubernetes.default.svc.cluster.local`) used for ServiceAccount
+Workload Identity Federation in local `kind` clusters, or a local Dex/mock
+OIDC instance without a real cert. Leave it `false` for any real-world OIDC
+provider (Google, Okta, Dex behind a real TLS certificate, etc.).
+
+## `controlPlane.autoApproveEnrollment`
+
+Defaults to `true` (any node/router presenting a valid identity token is
+enrolled immediately, no manual step). Set to `false` if you want an
+administrator to approve each enrollment via `/admin/enrollments` before a
+node can join — see the
+[Control Plane Configuration guide](https://sam-mesh.dev/docs/user/control-plane-configuration/#6-headless-node-enrollment-bootstrap-token-flow).
+
+## Dex (`dex.enabled`)
+
+Disabled by default. The bundled Dex is only meant for local/dev OIDC login
+(username/password test users); real deployments should point
+`controlPlane.oidcIssuer` at your own identity provider instead of enabling
+this.
diff --git a/charts/sam-mesh/templates/NOTES.txt b/charts/sam-mesh/templates/NOTES.txt
new file mode 100644
index 00000000..62b01ef9
--- /dev/null
+++ b/charts/sam-mesh/templates/NOTES.txt
@@ -0,0 +1,35 @@
+SAM Mesh has been deployed as release "{{ .Release.Name }}" in namespace "{{ .Release.Namespace }}".
+
+{{- if not .Values.controlPlane.adminToken }}
+
+A random admin token was generated for you (nothing is set in values.yaml).
+Retrieve it before you try to call any /admin/* endpoint or log into the
+console as root admin:
+
+ kubectl get secret --namespace {{ .Release.Namespace }} {{ include "sam-mesh.fullname" . }}-secrets -o jsonpath='{.data.admin-token}' | base64 -d; echo
+{{- else }}
+
+Using the admin token you provided via values (controlPlane.adminToken).
+{{- end }}
+
+{{- if not .Values.database.postgres.password }}
+
+A random database password was also generated and stored in the same secret
+(key "db-password"); you shouldn't need it directly unless connecting to
+Postgres yourself.
+{{- end }}
+
+Control plane service: {{ include "sam-mesh.fullname" . }}-control-plane:{{ .Values.controlPlane.service.port }}
+{{- if .Values.console.enabled }}
+Console service: {{ include "sam-mesh.fullname" . }}-console:{{ .Values.console.service.port }}
+{{- end }}
+
+{{- if .Values.controlPlane.autoApproveEnrollment }}
+
+Note: controlPlane.autoApproveEnrollment=true - any node/router presenting a
+valid identity is enrolled automatically without manual admin approval. Set
+it to false for production deployments where you want to review enrollments.
+{{- end }}
+
+See charts/sam-mesh/README.md for more details on configuring OIDC, TLS, and
+production values.
diff --git a/development/kind/run.sh b/development/kind/run.sh
index d2b1243c..eee53562 100755
--- a/development/kind/run.sh
+++ b/development/kind/run.sh
@@ -169,7 +169,8 @@ echo "== Deploying SAM Mesh via Helm =="
--set router.externalAddrs[1]="/ip4/127.0.0.1/tcp/4001" \
--set console.service.type=NodePort \
--set console.service.nodePort=30081 \
- --set dex.enabled=true
+ --set dex.enabled=true \
+ --set controlPlane.insecureSkipTlsVerify=true # ISSUER is the kind cluster's own API server, served with a self-signed cert
echo "== Waiting for database to be ready =="
kubectl --context "${KCTX}" -n "${NAMESPACE}" wait --for=condition=ready --timeout=180s pod -l app=sam-mesh-db
diff --git a/tests/e2e/lib/container_mesh.bash b/tests/e2e/lib/container_mesh.bash
index 789d22bd..08f7aa01 100644
--- a/tests/e2e/lib/container_mesh.bash
+++ b/tests/e2e/lib/container_mesh.bash
@@ -278,6 +278,7 @@ if [[ -z "${MESH_HELPERS_LOADED:-}" ]]; then
--set controlPlane.oidcIssuer="${ISSUERS//,/\\,}" \
--set controlPlane.allowedAudiences="sam-mesh-audience\,sam-hub-audience" \
--set controlPlane.insecureSkipTlsVerify=true \
+ --set controlPlane.adminToken="super-secret-admin-token" \
--set controlPlane.replicaCount=2 \
--set controlPlane.hostPort=8080 \
--set router.useOidcToken=false \