1.7.1

Das Helm-Chart enthält eine examplevalues.yaml-Datei, die zur Installation und zum Upgrade von Cameleon verwendet werden kann.

Vorbereitung der examplevalues.yaml

In der folgenden Tabelle sind die Werte aufgelistet, die vor der Installation überprüft und je nach Installation verändert werden müssen.

Attribut	Beschreibung	Beispiel
fqdn	Der Full Qualified Domain Name Ihrer Cameleon Umgebung. Der FQDN wird automatisch als Hostname in den ingress eingetragen.	cameleon.local
global.registryUrl	Die URL zur Registry der Container-Images. Cameleon Solutions stellt eine zentrale Registry zur Verfügung.	FQDN:4000
global.registryUser	Der Benutzername zur Anmeldung an der Registry.	user
global.registryPassword	Das Passwort zur Anmeldung an der Registry.	password
global.useRegistrypullsecret	Gibt an, ob beim Image Pull das Registrypull-Secret verwendet werden soll.	yes
global.namespace	Der Namespace, in dem die Applikation installiert wird.	cam
global.userId	Benutzer-ID, unter der die Applikation ausgeführt wird.	6001
global.groupId	Gruppen-ID, unter der die Applikation ausgeführt wird.	6000
global.storageServer	Nur, wenn Default-NFS-PV und PVC mit installiert werden soll. Ansonsten nicht relevant. IP-Adresse oder FQDN des NFS-Servers für Persistent Volumes.	10.0.0.6
global.storageDirectory	Nur, wenn Default-NFS-PV und PVC mit installiert werden soll. Ansonsten nicht relevant. Verzeichnis der Daten für Cameleon auf dem NFS-Server.	/var/nfs/cameleon
global.storageClaimName	Name des PVC für Plattform-Container. Wenn der Default-NFS-PV und PVC mit installiert wird, nicht anpassen. Wenn der Name angepasst wird, muss der PVC manuell erstellt werden.	backend-platform-pv-claim
global.storageClaimNameInternalDb	Nur bei interner Datenbank-Installation relevant. Name des PVC für den interne Datenbank-Container. Wenn der Default-NFS-PV und PVC mit installiert wird, nicht anpassen. Wenn der Name angepasst wird, muss der PVC manuell erstellt werden.	postgres-pv-claim
global.storageAttachmentsCapacity	PVC Storage Request	10Gi
global.storageDbCapacity	Nur bei interner Datenbank-Installation relevant. PVC Storage Request für die interne Datenbank.	10Gi
security.clusterAdminPw	Initialpasswort für den Benutzer “cluster-admin” zur Anmeldung an der Cluster-Administration.	Password
security.loginToken	Das Token zur Verschlüsselung der Zugriffstoken auf Cameleon. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab.	Token
security.vaultToken	Das Token zur Verschlüsselung von Daten in Cameleon. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab.	Token
security.emailInboundToken	Das Token zur Verschlüsselung der Zugriffstoken für E-Mail-Inbound-Integrationen. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab.	Token
install-external-db.enabled	Wenn die Datenbank extern betrieben wird, ändern Sie bitte diesen Wert zu true ab.	false
containerized-db.enabled	Wenn die Datenbank extern betrieben wird, ändern Sie bitte diesen Wert zu false ab.	true
install-default-pv.enabled	Nur aktivieren, wenn Sie den Default-NFS-PV und PVC von Cameleon installieren möchten. Ansonsten können eigene PVC erstellt und über die Parameter global.storageClaimName und global.storageClaimNameInternalDb definiert werden, zum Beispiel bei Verwendung eigener Storage Classes wie CSI etc.	true
db.external	Mit diesem Parameter wird die Installationsvariante “externe Datenbank” aktiviert. Der Wert muss dann auf true gesetzt werden.	false
db.host	Nur ändern, wenn die Datenbank extern betrieben wird.	10.0.0.6
db.port	Nur ändern, wenn die Datenbank extern betrieben wird.	5432
db.dbName	Name der Cameleon-Datenbank. Nur bei Bedarf ändern, wenn die Datenbank extern betrieben wird.	cameleondb
db.dbUsername	Owner der Datenbank	cameleon
db.dbPassword	Passwort zur Anmeldung an der Datenbank	Password
db.ssl	Nur bei Bedarf ändern, wenn die Datenbank extern betrieben wird.	false
install-ai.enabled	Mit dieser Option wird der AI-Container installiert. Bitte beachten Sie, dass zur Verwendung der AI eine aktive Ollama-Anbindung in den Systemeinstellungen des Cameleon-Mandanten konfiguriert werden muss.	false
extensions.installCarlAi	Mit dieser Option wird die AI Erweiterung installiert. Bitte beachten Sie, dass zur Verwendung der AI eine aktive Ollama-Anbindung in den Systemeinstellungen des Cameleon-Mandanten konfiguriert werden muss.	false

Installation

Führen Sie folgenden Befehl im Kubernetes-Cluster aus, um das Cameleon Helm-Chart zu installieren. Weitere Informationen zur Installation mit Helm erhalten Sie hier.

helm install cameleon-purple cameleon-purple-1.7.1.tgz -f examplevalues.yaml

Der Namespace wird standardmäßig im Rahmen der Installation erstellt. Ist das nicht gewünscht, kann die Namespace-Installation durch den folgenden Parameter deaktiviert werden.

--set create-cameleon-namespace.enabled="false"

Wenn die Namensauflösung von Hostnamen durch DNS nicht zur Verfügung steht, kann die /etc/hosts auf Pod-Ebene durch HostAliases erweitert werden. Der Helm Install-Befehl kann in dem Fall durch folgenden Parameter erweitert werden. Beispiel:

--set network.hostAliases[0].host="servername.lokal" --set network.hostAliases[0].ip="192.168.178.24"

Die Installation der Container dauert je nach Systemressourcen wenige Minuten. Um den Status der Pods in Kubernetes während der Installation zu überwachen, können Sie zum Beispiel folgenden Befehl ausführen.

kubectl get pods -A

Upgrade

Ältere Cameleon-Versionen können mit diesem Helm-Chart aktualisiert werden.

helm upgrade cameleon-purple cameleon-purple-1.7.1.tgz -f examplevalues.yaml

Führen Sie nach dem Helm-Upgrade ein Upgrade der Plattform in der Cameleon Cluster Administration durch.

Nachdem die Container erfolgreich ausgetauscht wurden, ist die Aktualisierung der Cameleon-Clients erforderlich. Führen Sie folgende Schritte aus, um das Upgrade abzuschließen.

1. Öffnen Sie die Cameleon Cluster Administration
2. Klicken Sie auf den Button “Upgrade Platform”
3. Klicken Sie auf den Button “Start upgrade now”

Die Aktualisierung dauert wenige Minuten.