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.installDefaultSecrets | Mit diesem Parameter kann die Installation der Standard-Secrets in Cameleon deaktiviert werden | true |
| security.installIngressTls | Mit dieser Option wird ein TLS-Zertifikat im Ingress installiert | false |
| security.cameleonTlsSecret | Der Name des Secrets für das TLS-Zertifikat | cameleon-tls |
| security.tlsCert | Wenn security.installIngressTls aktiv ist, muss hier das TLS-Zertifikat Base64-Encoded hinterlegt werden | LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0… |
| security.tlsKey | Wenn security.installIngressTls aktiv ist, muss hier der Key des TLS-Zertifikats Base64-Encoded hinterlegt werden | LS0tLS1CRUdJTiBQUklWQVRFIEtF… |
| 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 |
| ingress.pathType | PathType Parameter im Ingress | Prefix |
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.8.0.tgz -f examplevalues.yamlDer 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 -AUpgrade
Bevor Sie das geplante Upgrade auf die neue Version unserer Software durchführen, möchten wir Sie dringend dazu anhalten, ein vollständiges Backup Ihrer aktuellen Cameleon-Datenbank und Volumes zu erstellen.
Obwohl wir bestmöglich auf Kompatibilität und Stabilität geachtet haben, können unvorhergesehene Probleme auftreten. Ein vollständiges Backup schützt Sie vor möglichen Datenverlusten und stellt sicher, dass Sie im Falle eines Problems jederzeit zu Ihrem aktuellen Stand zurückkehren können.
Folgende Helm-Chart-Parameter sind neu und müssen überprüft und je nach Bedarf werden.
| Parameter | Default |
| security.installDefaultSecrets | true |
| security.installIngressTls | false |
| security.cameleonTlsSecret | “cameleon-tls” |
| security.tlsCert | “” |
| security.tlsKey | “” |
| ingress.pathType | “Prefix” |
Eine bestehende Cameleon-Umgebung kann durch folgenden Befehl aktualisiert werden:
helm upgrade cameleon-purple cameleon-purple-1.8.0.tgz -f examplevalues.yamlLöschen Sie den lokalen Browser-Cache.
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.
- Öffnen Sie die Cameleon Cluster Administration
- Klicken Sie auf den Button “Upgrade Platform”
- Klicken Sie auf den Button “Start upgrade now”
Die Aktualisierung dauert wenige Minuten.