Helm Chart

Si prega di seguire questa guida per distribuire LibreChat su Kubernetes utilizzando Helm, apportando le modifiche necessarie per il proprio caso d'uso specifico. Altri Helm chart forniti dalla community sono elencati di seguito nella sezione Community Helm Charts.

Prerequisiti

• Un cluster Kubernetes in esecuzione
• Installazioni locali di kubectl e Helm

Configurazione

1. Utilizza il Credentials Generator per generare valori sicuri per CREDS_KEY, JWT_SECRET, JWT_REFRESH_SECRET e MEILI_MASTER_KEY. Inseriscili in un Kubernetes Secret come questo (se modifichi il nome del secret, ricorda di aggiornare i tuoi valori Helm):

apiVersion: v1
kind: Secret
metadata:
  name: librechat-credentials-env
  namespace: <librechat-chart-namespace>
type: Opaque
stringData:
  CREDS_KEY: <generated value>
  JWT_SECRET: <generated value>
  JWT_REFRESH_SECRET: <generated value>
  MEILI_MASTER_KEY: <generated value>

2. Aggiungi a questo stesso secret tutte le API key necessarie per i provider LLM:

apiVersion: v1
kind: Secret
metadata:
  name: librechat-credentials-env
  namespace: <librechat-chart-namespace>
. . . .

  OPENAI_API_KEY: <your secret value>

3. Applica il Secret al Cluster:

Installa Helm Chart

Per installare l'helm chart esegui:

helm install <deployment-name> oci://ghcr.io/danny-avila/librechat-chart/librechat

Analogamente ad altri Helm chart, esiste un values file che delinea le impostazioni predefinite e indica quali opzioni di configurazione possono essere modificate.

Crea un file values.yaml popolato con i valori che desideri modificare rispetto a quelli predefiniti.

Installa il Helm chart: helm install librechat oci://ghcr.io/danny-avila/librechat-chart/librechat --values <values-override-filel>

Disinstallare l'Helm Chart

Per disinstallare l'Helm Chart: helm uninstall <deployment-name>

Esempio: helm uninstall librechat

Migrazione da 1.x a 2.x

Se hai utilizzato il chart prima della versione 2.x, potresti dover aggiornare la struttura value.

1. Sposta la configurazione in librechat.configEnv:

- env:
-     ALLOW_EMAIL_LOGIN: "true"
-     ALLOW_REGISTRATION: "true"
+ librechat:
+   configEnv:
+     ALLOW_REGISTRATION: "true"
+     ALLOW_EMAIL_LOGIN: "true"

2. Consolidare tutti i valori Secret in un unico Secret come descritto nel Passaggio di configurazione 1.
3. Per utilizzare un'istanza MongoDB esterna, fare riferimento al values file del Chart, disattivare i componenti di conseguenza e modificare l'FQDN dell'istanza MongoDB. Questa operazione è consigliata se i dati esistono già in questa istanza MongoDB gestita esternamente.

Helm Chart della community

• Blue Atlas Helm Charts # deprecato ora che LibreChat fornisce un chart ufficiale
• Inviato da @dimaby su GitHub: PR #2879