FEATURE (helm): Add Helm chart installation

Author: RostislavDugin

README.md

@@ -157,6 +157,40 @@ Then run:
 docker compose up -d
 ```
 
+### Option 4: Kubernetes with Helm
+
+For Kubernetes deployments, use the official Helm chart:
+
+```bash
+helm install postgresus ./deploy/postgresus -n postgresus --create-namespace
+```
+
+To customize the installation, create a `values.yaml` file:
+
+```yaml
+ingress:
+  hosts:
+    - host: backup.yourdomain.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - secretName: backup-yourdomain-com-tls
+      hosts:
+        - backup.yourdomain.com
+
+persistence:
+  size: 20Gi
+```
+
+Then install with your custom values:
+
+```bash
+helm install postgresus ./deploy/postgresus -n postgresus --create-namespace -f values.yaml
+```
+
+See the [Helm chart README](deploy/postgresus/README.md) for all configuration options.
+
 ---
 
 ## 🚀 Usage

postgresus/.helmignore deploy/postgresus/.helmignorepostgresus/.helmignore renamed to deploy/postgresus/.helmignore

@@ -10,6 +10,3 @@ keywords:
   - database
   - restore
 home: https://github.com/RostislavDugin/postgresus
-maintainers:
-  - name: Alexander Gazal
-    email: [email protected]

postgresus/Chart.yaml deploy/postgresus/Chart.yamlpostgresus/Chart.yaml renamed to deploy/postgresus/Chart.yaml

@@ -0,0 +1,84 @@
+# Postgresus Helm Chart
+
+## Installation
+
+```bash
+helm install postgresus ./deploy/postgresus -n postgresus --create-namespace
+```
+
+## Configuration
+
+### Main Parameters
+
+| Parameter          | Description        | Default Value               |
+| ------------------ | ------------------ | --------------------------- |
+| `namespace.create` | Create namespace   | `true`                      |
+| `namespace.name`   | Namespace name     | `postgresus`                |
+| `image.repository` | Docker image       | `rostislavdugin/postgresus` |
+| `image.tag`        | Image tag          | `latest`                    |
+| `image.pullPolicy` | Image pull policy  | `Always`                    |
+| `replicaCount`     | Number of replicas | `1`                         |
+
+### Resources
+
+| Parameter                   | Description    | Default Value |
+| --------------------------- | -------------- | ------------- |
+| `resources.requests.memory` | Memory request | `1Gi`         |
+| `resources.requests.cpu`    | CPU request    | `500m`        |
+| `resources.limits.memory`   | Memory limit   | `1Gi`         |
+| `resources.limits.cpu`      | CPU limit      | `500m`        |
+
+### Storage
+
+| Parameter                      | Description               | Default Value          |
+| ------------------------------ | ------------------------- | ---------------------- |
+| `persistence.enabled`          | Enable persistent storage | `true`                 |
+| `persistence.storageClassName` | Storage class             | `""` (cluster default) |
+| `persistence.accessMode`       | Access mode               | `ReadWriteOnce`        |
+| `persistence.size`             | Storage size              | `10Gi`                 |
+| `persistence.mountPath`        | Mount path                | `/postgresus-data`     |
+
+### Service
+
+| Parameter                  | Description             | Default Value |
+| -------------------------- | ----------------------- | ------------- |
+| `service.type`             | Service type            | `ClusterIP`   |
+| `service.port`             | Service port            | `4005`        |
+| `service.targetPort`       | Target port             | `4005`        |
+| `service.headless.enabled` | Enable headless service | `true`        |
+
+### Ingress
+
+| Parameter               | Description       | Default Value            |
+| ----------------------- | ----------------- | ------------------------ |
+| `ingress.enabled`       | Enable Ingress    | `true`                   |
+| `ingress.className`     | Ingress class     | `nginx`                  |
+| `ingress.hosts[0].host` | Hostname          | `postgresus.example.com` |
+| `ingress.tls`           | TLS configuration | See values.yaml          |
+
+### Health Checks
+
+| Parameter                | Description            | Default Value |
+| ------------------------ | ---------------------- | ------------- |
+| `livenessProbe.enabled`  | Enable liveness probe  | `true`        |
+| `readinessProbe.enabled` | Enable readiness probe | `true`        |
+
+## Custom Ingress Example
+
+```yaml
+# custom-values.yaml
+ingress:
+  hosts:
+    - host: backup.example.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - secretName: backup-example-com-tls
+      hosts:
+        - backup.example.com
+```
+
+```bash
+helm install postgresus ./deploy/postgresus -n postgresus --create-namespace -f custom-values.yaml
+```

deploy/postgresus/README.md

@@ -71,7 +71,9 @@ spec:
       spec:
         accessModes:
           - {{ .Values.persistence.accessMode }}
+        {{- if .Values.persistence.storageClassName }}
         storageClassName: {{ .Values.persistence.storageClassName }}
+        {{- end }}
         resources:
           requests:
             storage: {{ .Values.persistence.size }}

postgresus/templates/_helpers.tpl deploy/postgresus/helm/_helpers.tplpostgresus/templates/_helpers.tpl renamed to deploy/postgresus/helm/_helpers.tpl

@@ -8,8 +8,8 @@ namespace:
 # Image configuration
 image:
   repository: rostislavdugin/postgresus
-  tag: v1.45.3
-  pullPolicy: IfNotPresent
+  tag: latest
+  pullPolicy: Always
 
 # StatefulSet configuration
 replicaCount: 1
@@ -26,16 +26,18 @@ service:
 # Resource limits and requests
 resources:
   requests:
-    memory: "512Mi"
-    cpu: "250m"
+    memory: "1Gi"
+    cpu: "500m"
   limits:
     memory: "1Gi"
     cpu: "500m"
 
 # Persistent storage configuration
 persistence:
   enabled: true
-  storageClassName: longhorn-pg
+  # Storage class name. Leave empty to use cluster default.
+  # Examples: "longhorn", "standard", "gp2", etc.
+  storageClassName: ""
   accessMode: ReadWriteOnce
   size: 10Gi
   # Mount path in container
@@ -71,23 +73,24 @@ ingress:
       hosts:
         - postgresus.example.com
 
-# Health checks configuration (commented out by default)
+# Health checks configuration
+# Note: The application only has /api/v1/system/health endpoint
 livenessProbe:
-  enabled: false
+  enabled: true
   httpGet:
-    path: /health
+    path: /api/v1/system/health
     port: 4005
   initialDelaySeconds: 30
   periodSeconds: 10
   timeoutSeconds: 5
   failureThreshold: 3
 
 readinessProbe:
-  enabled: false
+  enabled: true
   httpGet:
-    path: /ready
+    path: /api/v1/system/health
     port: 4005
-  initialDelaySeconds: 5
+  initialDelaySeconds: 10
   periodSeconds: 5
   timeoutSeconds: 3
   failureThreshold: 3