Added helm chart.

Author: pantierra

.github/workflows/ci.yml

@@ -21,6 +21,9 @@ jobs:
       - name: Set up Python
         run: uv python install 3.12
 
+      - name: Set up Helm
+        uses: azure/setup-helm@v4
+
       - name: Cache pre-commit
         uses: actions/cache@v4
         with:

.github/workflows/docker-release.yml

@@ -0,0 +1,76 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+  CHART_NAME: eoapi-notifier
+
+jobs:
+  release:
+    name: Release Docker and Helm
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Set up Helm
+        uses: azure/setup-helm@v4
+
+      - name: Log in to registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=tag
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Update Chart.yaml
+        run: |
+          sed -i "s/^version:.*/version: ${{ steps.version.outputs.version }}/" helm-chart/${{ env.CHART_NAME }}/Chart.yaml
+          sed -i "s/^appVersion:.*/appVersion: \"${{ steps.version.outputs.version }}\"/" helm-chart/${{ env.CHART_NAME }}/Chart.yaml
+
+      - name: Lint and package Helm chart
+        run: |
+          helm lint helm-chart/${{ env.CHART_NAME }}
+          helm package helm-chart/${{ env.CHART_NAME }} --destination .
+
+      - name: Push Helm chart
+        run: |
+          echo ${{ secrets.GITHUB_TOKEN }} | helm registry login ${{ env.REGISTRY }} --username ${{ github.actor }} --password-stdin
+          helm push ${{ env.CHART_NAME }}-${{ steps.version.outputs.version }}.tgz oci://${{ env.REGISTRY }}/${{ github.repository_owner }}/charts

.github/workflows/docker-test.yml

@@ -0,0 +1,66 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    paths:
+      - 'Dockerfile'
+      - '.dockerignore'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'eoapi_notifier/**'
+      - 'helm-chart/**'
+      - 'tests/**'
+      - '.github/workflows/test.yml'
+
+env:
+  IMAGE_NAME: eoapi-notifier
+
+jobs:
+  test:
+    name: Test Docker and Helm
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Set up Helm
+        uses: azure/setup-helm@v4
+
+      - name: Build Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: false
+          load: true
+          tags: ${{ env.IMAGE_NAME }}:test
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Test Docker image
+        run: |
+          docker run --rm ${{ env.IMAGE_NAME }}:test --help
+          docker run --rm ${{ env.IMAGE_NAME }}:test --version
+          docker run --rm ${{ env.IMAGE_NAME }}:test /nonexistent/config.yaml || echo "Expected error handled"
+
+      - name: Test Helm chart
+        run: |
+          helm lint helm-chart/eoapi-notifier
+          helm template test helm-chart/eoapi-notifier --debug > /dev/null
+          echo "✅ Helm chart linting and templating passed"

.github/workflows/release.yml

@@ -23,8 +23,15 @@ repos:
     hooks:
       - id: pytest-coverage
         name: Tests with coverage
-        entry: uv run python -m pytest
+        entry: uv run python -m pytest --ignore=tests/test_helm.py
         language: system
         types: [python]
         pass_filenames: false
         always_run: true
+      - id: helm-lint
+        name: Helm lint
+        entry: helm lint helm-chart/eoapi-notifier
+        language: system
+        files: ^helm-chart/
+        pass_filenames: false
+

.github/workflows/test.yml

@@ -59,3 +59,5 @@ ignore: |
   *.min.yaml
   # Ignore GitHub Actions workflows (handled by actionlint)
   .github/workflows/
+  # Ignore Helm chart templates (contain Go templating syntax)
+  helm-chart/

.pre-commit-config.yaml

@@ -0,0 +1,56 @@
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/developmentseed/eoapi-notifier.git
+cd eoapi-notifier
+uv sync
+uv run pre-commit install
+```
+
+## Testing
+
+```bash
+# Run tests
+uv run pytest
+
+# Test Docker
+docker build -t eoapi-notifier:test .
+docker run --rm eoapi-notifier:test --help
+
+# Test Helm chart
+helm lint helm-chart/eoapi-notifier
+helm template test helm-chart/eoapi-notifier
+
+# Run Helm chart tests (requires running Kubernetes cluster)
+helm install test-release helm-chart/eoapi-notifier
+helm test test-release
+helm uninstall test-release
+```
+
+## Releases
+
+Create and push a tag to trigger automated release:
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+This automatically:
+- Builds and pushes Docker image to `ghcr.io/developmentseed/eoapi-notifier`
+- Publishes Helm chart to `oci://ghcr.io/developmentseed/charts/eoapi-notifier`
+
+## Code Style
+
+- Use `uv run ruff format` and `uv run ruff check --fix`
+- Add type hints for new code
+- Pre-commit hooks enforce style
+
+## Pull Requests
+
+1. Create feature branch
+2. Make changes with tests
+3. Ensure `uv run pytest` and pre-commit hooks pass
+4. Submit PR with clear description

.yamllint.yaml

@@ -69,6 +69,18 @@ outputs:
 
 See [examples/config.yaml](./examples/config.yaml) for a complete configuration example with all available options.
 
+## Kubernetes Deployment
+
+```bash
+# Install with Helm
+helm install eoapi-notifier oci://ghcr.io/developmentseed/charts/eoapi-notifier
+
+# With custom values
+helm install eoapi-notifier oci://ghcr.io/developmentseed/charts/eoapi-notifier -f values.yaml
+```
+
+See [Helm Chart README](helm-chart/eoapi-notifier/README.md) for configuration options.
+
 ### Available Plugins
 
 #### Sources