feat: Add values.schema.json validation. (#296)

Author: pantierra

.github/workflows/ci.yml

@@ -17,21 +17,23 @@ jobs:
     steps:
       - uses: actions/checkout@v5
 
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-node@v4
         with:
-          python-version: '3.13'
+          node-version: '18'
 
-      - name: Install uv
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> "$GITHUB_PATH"
+      - name: Install ajv-cli
+        run: npm install -g ajv-cli ajv-formats
 
       - name: Install Helm
         uses: azure/setup-helm@v4
         with:
           version: ${{ env.HELM_VERSION }}
 
+      - name: Setup Helm dependencies
+        run: ./scripts/deploy.sh setup
+
       - name: Run linters
-        run: |
-          export PATH="$HOME/.cargo/bin:$PATH"
-          make lint
+        run: make lint
+
+      - name: Validate Helm values schema
+        run: make validate-schema

.pre-commit-config.yaml

@@ -53,6 +53,13 @@ repos:
         files: ^charts/.+\.(yaml|yml)$
         pass_filenames: false
 
+      - id: helm-schema-validation
+        name: Helm Schema Validation
+        entry: make validate-schema
+        language: system
+        files: ^charts/.+\.(json|yaml|yml)$
+        pass_filenames: false
+
 # Exclude directories
 exclude: |
   (?x)^(

CHANGELOG.md

@@ -11,11 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Enforcement of `CHANGELOG.md` entries for PRs and Conventional Commits for PR titles [#288](https://github.com/developmentseed/eoapi-k8s/pull/288)
 - Added code formatting and linting with pre-commit hooks [#283](https://github.com/developmentseed/eoapi-k8s/pull/283)
-- Adjusted Renovate Configuration to fit conventional commits [#295](https://github.com/developmentseed/eoapi-k8s/pull/295)
-
-### Changed
-
-- Excluded renovate.json from CHANGELOG.md edits [#301](https://github.com/developmentseed/eoapi-k8s/pull/301)
+- Added values.schema.json validation [#296](https://github.com/developmentseed/eoapi-k8s/pull/296)
 
 ## [0.7.8] - 2025-09-10
 

Makefile

@@ -5,7 +5,7 @@ HELM_REPO_URL=https://devseed.com/eoapi-k8s/
 HELM_CHART_NAME=eoapi/eoapi
 PGO_CHART_VERSION=5.7.4
 
-.PHONY: all deploy minikube ingest tests integration lint help
+.PHONY: all deploy minikube ingest tests integration lint validate-schema help
 
 # Default target
 all: deploy
@@ -50,12 +50,38 @@ lint:
 	fi
 	@pre-commit run --all-files
 
+validate-schema:
+	@echo "Validating Helm values schemas..."
+	@command -v helm >/dev/null 2>&1 || { echo "❌ helm is required but not installed"; exit 1; }
+	@command -v ajv >/dev/null 2>&1 || { echo "❌ ajv-cli is required but not installed. Run: npm install -g ajv-cli ajv-formats"; exit 1; }
+	@for chart_dir in charts/*/; do \
+		chart_name=$$(basename "$$chart_dir"); \
+		if [ -f "$${chart_dir}values.schema.json" ]; then \
+			echo "🔍 Validating schema for $$chart_name..."; \
+			if helm lint "$$chart_dir" --strict && \
+			   helm template test "$$chart_dir" >/dev/null && \
+			   ajv compile -s "$${chart_dir}values.schema.json" --spec=draft7 --strict=false && \
+			   python3 -c "import yaml,json; json.dump(yaml.safe_load(open('$${chart_dir}values.yaml')), open('/tmp/values-$${chart_name}.json','w'))" && \
+			   ajv validate -s "$${chart_dir}values.schema.json" -d "/tmp/values-$${chart_name}.json" --spec=draft7; then \
+				rm -f "/tmp/values-$${chart_name}.json"; \
+				echo "✅ $$chart_name validation passed"; \
+			else \
+				rm -f "/tmp/values-$${chart_name}.json"; \
+				echo "❌ $$chart_name validation failed"; \
+				exit 1; \
+			fi; \
+		else \
+			echo "⚠️ $$chart_name: no values.schema.json found, skipping"; \
+		fi; \
+	done
+
 help:
 	@echo "Makefile commands:"
 	@echo "  make deploy         -  Deploy eoAPI to the configured Kubernetes cluster."
 	@echo "  make minikube       -  Install eoAPI on minikube."
 	@echo "  make ingest         -  Ingest STAC collections and items into the database."
 	@echo "  make integration    -  Run integration tests on connected Kubernetes cluster."
-	@echo "  make tests          -  Run lint + unit tests."
+	@echo "  make tests          -  Run unit tests."
 	@echo "  make lint           -  Run linting and code quality checks."
+	@echo "  make validate-schema -  Validate Helm values schemas."
 	@echo "  make help           -  Show this help message."