refactor(helm): update deployment instructions and values for amazee.ai

- Modify Helm deployment commands to automatically create the namespace, simplifying the installation process.
- Update the values.yaml to include additional volume mounts for pgvector support in PostgreSQL.
- Enhance documentation with troubleshooting steps for namespace conflicts during installation.

Author: PhiRho

helm/HELM_DEPLOYMENT.md

@@ -34,12 +34,10 @@ helm repo update
 ### 2. Deploy the Complete Stack
 
 ```bash
-# Create a namespace
-kubectl create namespace amazee-ai
-
-# Deploy the complete application
-helm install amazee-ai oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
+# Deploy the complete application (Helm will create the namespace automatically)
+helm install amazee-ai-app oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
   --namespace amazee-ai \
+  --create-namespace \
   --version 0.0.1
 ```
 
@@ -49,20 +47,23 @@ helm install amazee-ai oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
 ```bash
 helm install frontend oci://ghcr.io/amazeeio/amazee.ai/frontend \
   --namespace amazee-ai \
+  --create-namespace \
   --version 0.0.1
 ```
 
 #### Backend Only
 ```bash
 helm install backend oci://ghcr.io/amazeeio/amazee.ai/backend \
   --namespace amazee-ai \
+  --create-namespace \
   --version 0.0.1
 ```
 
 #### PostgreSQL Only (using Bitnami)
 ```bash
 helm install postgresql bitnami/postgresql \
   --namespace amazee-ai \
+  --create-namespace \
   --set auth.postgresPassword="your-password" \
   --set auth.database="postgres_service"
 ```
@@ -106,17 +107,19 @@ backend:
 Deploy with custom values:
 
 ```bash
-helm install amazee-ai oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
+helm install amazee-ai-app oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
   --namespace amazee-ai \
+  --create-namespace \
   --version 0.0.1 \
   --values values.yaml
 ```
 
 ### Using Command Line Overrides
 
 ```bash
-helm install amazee-ai oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
+helm install amazee-ai-app oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
   --namespace amazee-ai \
+  --create-namespace \
   --version 0.0.1 \
   --set frontend.enabled=true \
   --set backend.enabled=true \
@@ -151,7 +154,7 @@ To upgrade to a newer version:
 helm search repo oci://ghcr.io/amazeeio/amazee.ai/amazee-ai --versions
 
 # Upgrade to a specific version
-helm upgrade amazee-ai oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
+helm upgrade amazee-ai-app oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
   --namespace amazee-ai \
   --version 0.0.2
 ```
@@ -160,7 +163,7 @@ helm upgrade amazee-ai oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
 
 ```bash
 # Uninstall the complete stack
-helm uninstall amazee-ai -n amazee-ai
+helm uninstall amazee-ai-app -n amazee-ai
 
 # Or uninstall individual components
 helm uninstall frontend -n amazee-ai
@@ -173,7 +176,7 @@ helm uninstall postgresql -n amazee-ai
 ### Check Chart Status
 ```bash
 helm list -n amazee-ai
-helm status amazee-ai -n amazee-ai
+helm status amazee-ai-app -n amazee-ai
 ```
 
 ### View Logs
@@ -191,12 +194,37 @@ kubectl logs -n amazee-ai deployment/postgresql
 ### Debug Installation
 ```bash
 # Dry run to see what would be installed
-helm install amazee-ai oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
+helm install amazee-ai-app oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
   --namespace amazee-ai \
+  --create-namespace \
   --version 0.0.1 \
   --dry-run --debug
 ```
 
+### Namespace Conflicts
+
+If you encounter namespace ownership errors like:
+```
+Error: INSTALLATION FAILED: Unable to continue with install: Namespace "amazee-ai" in namespace "" exists and cannot be imported into the current release: invalid ownership metadata
+```
+
+This happens when the namespace was created manually with `kubectl create namespace` instead of by Helm. To fix this:
+
+```bash
+# Option 1: Delete the existing namespace and let Helm recreate it
+kubectl delete namespace amazee-ai
+helm install amazee-ai-app oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
+  --namespace amazee-ai \
+  --create-namespace \
+  --version 0.0.1
+
+# Option 2: Use a different namespace name
+helm install amazee-ai-app oci://ghcr.io/amazeeio/amazee.ai/amazee-ai \
+  --namespace amazee-ai-new \
+  --create-namespace \
+  --version 0.0.1
+```
+
 ## Security Considerations
 
 1. **Secrets Management**: Use Kubernetes secrets or external secret managers for sensitive data

helm/values.yaml

@@ -27,16 +27,22 @@ postgresql:
     extraVolumes:
       - name: pgvector-extension
         emptyDir: {}
+      - name: pgvector-lib
+        emptyDir: {}
     extraVolumeMounts:
       - name: pgvector-extension
         mountPath: /docker-entrypoint-initdb.d
+      - name: pgvector-lib
+        mountPath: /usr/lib/postgresql/16/lib
     initContainers:
       - name: install-pgvector
         image: pgvector/pgvector:pg16
-        command: ['sh', '-c', 'cp /usr/share/postgresql/16/extension/pgvector* /docker-entrypoint-initdb.d/']
+        command: ['sh', '-c', 'cp /usr/share/postgresql/16/extension/vector* /docker-entrypoint-initdb.d/ && cp /usr/lib/postgresql/16/lib/vector.so /usr/lib/postgresql/16/lib/']
         volumeMounts:
           - name: pgvector-extension
             mountPath: /docker-entrypoint-initdb.d
+          - name: pgvector-lib
+            mountPath: /usr/lib/postgresql/16/lib
 
 # Backend subchart configuration
 backend: