docs(warn): include warning for production ready setup

Author: Frederic Spiers

README.md

@@ -35,7 +35,12 @@ Additionaly, a **shell** variant of the Docker image is available, this version
 The project can be deployed on Kubernetes-like infrastructure (k0s, k3s, Talos, EKS, GKE, AKS...). GGBridge leverages **Helm Chart Deployment** which is an industry standard method for production environements, offering enhanced configurability and scalability for Kubernetes setups.
 
 - If you already have a Kubernetes cluster, please follow the [below documentation](#helm-deployment). 
-- If you do not have a dedicated Kubernetes cluster, you can deploy GGBridge with a `k3d` cluster on a single VM. Please follow the [k3d installation documentation](./docs/k3d-install.md)
+- If you do not have access to a Kubernetes cluster, you can deploy GGBridge along with a `k3d` cluster on a single VM. Please follow the [k3d installation documentation](./docs/k3d-install.md).
+
+> [!WARNING]  
+> The [k3d installation method](./docs/k3d-install.md) is not recommended for production due to single point of failure and lack of high availability.
+>
+> **For production setup**, we recommend deploying on a multi-node Kubernetes cluster across multiple AZs with proper redundancy and monitoring.
 
 ### Helm deployment
 

docs/k3d-install.md

@@ -2,16 +2,26 @@
 
 This guide will help you deploy and manage local Kubernetes clusters using k3d for GGBridge deployment.
 
-## 📋 Prerequisites
+> [!WARNING]  
+> This setup is not recommended for production due to single point of failure and lack of high availability.
+>
+> **For production setup**, we recommend deploying on a multi-node Kubernetes cluster across multiple AZs with proper redundancy and monitoring.
+
+## 🔧 Prerequisites
 For this installation method, you will need a single server (VM, bare metal...) and install following components:
 
 - [Docker](https://docs.docker.com/get-docker/) installed and running
 - [K3d](https://k3d.io/v5.8.3/#installation) version 5.8.3 or superior
 - [helm](https://helm.sh/docs/intro/install/) to install GGBridge in the k3d cluster
 - [kubectl](https://kubernetes.io/docs/tasks/tools/) to interact with the cluster
 
-## Quick Start
-### Basic CLI installation
+## ⚡ Quick Start
+
+> [!IMPORTANT]  
+> There are two methods for installing GGBridge on k3d, the [Basic CLI installation](#-basic-cli-installation), and [using config files](#-config-file-installationn). While the basic CLI works, we recommend the second one for a long-term and maintainable lifecycle.
+
+
+### 💻 Basic CLI installation
 
 > [!NOTE]  
 > Single node cluster here is minimal installation and low footprint
@@ -27,7 +37,7 @@ k3d cluster create ggbridge --agents 0 \
                             --k3s-arg "--disable=servicelb@server:*" \
                             --k3s-node-label "project=ggbridge@server:*" \
                             --api-port 0.0.0.0:6445 \
-                            --image rancher/k3s:v1.34.1-k3s1 \
+                            --image rancher/k3s:v1.33.5-k3s1 \
                             --timeout 3m0s
 ```
 2. Create the GGBridge namespace
@@ -46,13 +56,12 @@ kubectl create secret generic ggbridge-client-crt -n ggbridge --from-file=tls.cr
 
 4. Install GGBridge client
 
-> [!IMPORTANT]  
-> Replace `$uid` here with the Bridge UID
+Replace `$uid` here with the Bridge UID
 
 ```bash
 helm -n ggbridge upgrade -i ggbridge oci://ghcr.io/gitguardian/ggbridge/helm/ggbridge \
-                         --set hostname="$uid.ggbridge.gitguardian.com" \
-                         --set tls.enable=true \
+                         --set hostname="$uid.ggbridge.gitguardian.tech" \
+                         --set tls.enabled=true \
                          --set tls.existingSecret="ggbridge-client-crt" \
                          --set tls.existingSecretKeys.caCrt="ca.crt" \
                          --set tls.existingSecretKeys.crt="tls.crt" \
@@ -75,10 +84,10 @@ ggbridge-client-1-75f69cdb75-5gpsv   2/2     Running   0          22s
 ggbridge-client-2-76b98c699b-bk2q5   2/2     Running   0          22s
 ```
 
-### Config file installation
+### 📝 Config file installation
 
 > [!NOTE]  
-> This installation is using declarative approach with explicit yaml files to describe cluster and Helm installation. It brings several advantages upon [basic CLI installation](#basic-cli-installation). We recommend using this method if you are familiar with Kubernetes.
+> This installation is using declarative approach with explicit yaml files to describe cluster and Helm installation. It brings several advantages upon [basic CLI installation](#-basic-cli-installation). We recommend using this method if you are familiar with Kubernetes.
 > 
 > | Advantage             | Config File installation           | Basic CLI installation             |
 > |-----------------------|------------------------------------|------------------------------------|

k3d/cluster.yaml

@@ -10,7 +10,7 @@ agents: 0
 kubeAPI:
   hostIP: "0.0.0.0"
   hostPort: "6445"
-image: rancher/k3s:v1.34.1-k3s1
+image: rancher/k3s:v1.33.5-k3s1
 files:
   - description: 'GGbridge namespace'
     source: |