Helm deployment

.github/workflows/publish-chart.yml

@@ -0,0 +1,51 @@
+name: Publish Helm Chart to GHCR
+
+on:
+  push:
+    tags:
+      - 'chart-v*'
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  CHART_NAME: aconext
+  CHART_PATH: charts/aconext
+  HELM_VERSION: 'v4.0.1'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Helm
+        uses: azure/setup-helm@v4
+        with:
+          version: ${{ env.HELM_VERSION }}
+
+      - name: Package Helm chart
+        run: |
+          helm dependency update ${{ env.CHART_PATH }}
+
+      - name: Publish new helm chart for aconext
+        run: |
+          echo ${{ secrets.GITHUB_TOKEN }} | helm registry login ghcr.io --username ${{ github.actor }} --password-stdin
+
+          ACONEXT_CHART_VERSION_TAG=$(cat ${{ env.CHART_PATH }}/Chart.yaml | grep version: | cut -d " " -f 2)
+
+          echo "ACONEXT_CHART_VERSION_TAG=${ACONEXT_CHART_VERSION_TAG}" >> $GITHUB_ENV
+
+          helm package ${{ env.CHART_PATH }}/ --version="${ACONEXT_CHART_VERSION_TAG}"
+
+          helm push ${{ env.CHART_NAME }}-"${ACONEXT_CHART_VERSION_TAG}".tgz oci://ghcr.io/${{ github.repository_owner }}/helm-charts
+
+      - name: Output chart location
+        run: |
+          echo "Chart published to: ${{ env.REGISTRY }}/${{ github.repository_owner }}/helm-charts/${{ env.CHART_NAME }}:${ACONEXT_CHART_VERSION_TAG}"
+          echo "Install with: helm install my-release oci://${{ env.REGISTRY }}/${{ github.repository_owner }}/helm-charts/${{ env.CHART_NAME }} --version ${ACONEXT_CHART_VERSION_TAG}"
+

charts/aconext/.gitignore

@@ -0,0 +1 @@
+test-values.yaml

charts/aconext/.helmignore

@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/

charts/aconext/Chart.lock

@@ -0,0 +1,12 @@
+dependencies:
+- name: postgresql
+  repository: https://charts.bitnami.com/bitnami
+  version: 18.1.13
+- name: redis
+  repository: https://charts.bitnami.com/bitnami
+  version: 24.0.0
+- name: rabbitmq
+  repository: https://charts.bitnami.com/bitnami
+  version: 16.0.14
+digest: sha256:a6dacb3ae4b421677920042468a45a83db2632a5dc4e2ff8fce26738c28ace94
+generated: "2025-12-02T21:17:35.634297+02:00"

charts/aconext/Chart.yaml

@@ -0,0 +1,22 @@
+apiVersion: v2
+name: aconext
+description: A Helm chart for Acontext deployment on Kubernetes
+
+type: application
+
+version: 0.0.1
+appVersion: "0.0.1"
+
+dependencies:
+  - name: postgresql
+    repository: https://charts.bitnami.com/bitnami
+    version: 18.1.13
+    condition: postgresql.enabled
+  - name: redis
+    repository: https://charts.bitnami.com/bitnami
+    version: 24.0.0
+    condition: redis.enabled
+  - name: rabbitmq
+    repository: https://charts.bitnami.com/bitnami
+    version: 16.0.14
+    condition: rabbitmq.enabled

charts/aconext/templates/NOTES.txt

@@ -0,0 +1,62 @@
+1. Get the application URL by running these commands:
+{{- if contains "NodePort" .Values.api.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "aconext.api.name" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo "API URL: http://$NODE_IP:$NODE_PORT"
+{{- else if contains "LoadBalancer" .Values.api.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch its status by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "aconext.api.name" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "aconext.api.name" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo "API URL: http://$SERVICE_IP:{{ .Values.api.service.port }}"
+{{- else if contains "ClusterIP" .Values.api.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "aconext.name" . }}-api,app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  export CONTAINER_PORT=$(kubectl get pod --namespace {{ .Release.Namespace }} $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:$CONTAINER_PORT
+{{- end }}
+
+2. Check service status:
+  kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/instance={{ .Release.Name }}"
+  kubectl get svc --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/instance={{ .Release.Name }}"
+
+3. View logs:
+  kubectl logs --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "aconext.name" . }}-api" --tail=100
+  kubectl logs --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "aconext.name" . }}-core" --tail=100
+
+4. Service endpoints:
+{{- if .Values.core.enabled }}
+  Core Service: {{ include "aconext.core.name" . }}:{{ .Values.core.service.port }}
+{{- end }}
+{{- if .Values.api.enabled }}
+  API Service: {{ include "aconext.api.name" . }}:{{ .Values.api.service.port }}
+{{- end }}
+
+5. Dependencies status:
+{{- if .Values.postgresql.enabled }}
+  PostgreSQL: Enabled (internal)
+{{- else }}
+  PostgreSQL: External ({{ .Values.external.postgresql.host }}:{{ .Values.external.postgresql.port }})
+{{- end }}
+{{- if .Values.redis.enabled }}
+  Redis: Enabled (internal)
+{{- else }}
+  Redis: External ({{ .Values.external.redis.host }}:{{ .Values.external.redis.port }})
+{{- end }}
+{{- if .Values.rabbitmq.enabled }}
+  RabbitMQ: Enabled (internal)
+{{- else }}
+  RabbitMQ: External ({{ .Values.external.rabbitmq.host }}:{{ .Values.external.rabbitmq.port }})
+{{- end }}
+
+{{- if and .Values.httpRoute.enabled .Values.httpRoute.gateway.name }}
+{{- if .Values.httpRoute.hostnames }}
+6. API Health Check:
+{{- range .Values.httpRoute.hostnames }}
+  Health Check: http://{{ . }}/health
+{{- end }}
+{{- else }}
+6. API Health Check:
+  Health Check: http://<GATEWAY_IP>/health
+  (Note: Configure httpRoute.hostnames to get the full URL)
+{{- end }}
+{{- end }}