Mit Docker Compose kann Cameleon in einer Docker-Umgebung installiert werden. Die Installationspakete stehen im Download-Bereich zur Verfügung.
Verfügbare Dateien
Das Installationspaket cameleon-d-<Version>.tgz besteht aus folgenden Dateien. Zur Installation muss die Datei entpackt werden.
tar -xvzf cameleon-d-<Version>.tgz| Dateiname | Beschreibung |
| compose_containerized_db.yaml | Eine Compose-File zur Bereitstellung des gesamten Applikation-Stack mit interner Datenbank. |
| compose_external_db.yaml | Eine Compose-File zur Bereitstellung des gesamten Applikation-Stack mit externer Datenbank. |
| cameleon.env | Eine Datei mit Umgebungsvariablen für Cameleon. |
| examplevalues.env | Ein Beispiel als Vorlage zur Erstellung einer eigenen Installationsdatei. |
Vorbereitung der examplevalues.env
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. | cameleon.local |
| REGISTRY_URL | Die URL zur Registry der Container-Images. Cameleon Solutions stellt eine zentrale Registry zur Verfügung. | FQDN:4000 |
| DBHOST | Nur ändern, wenn die Datenbank extern betrieben wird. | pg-db |
| DBPORT | Nur ändern, wenn die Datenbank extern betrieben wird. | 5432 |
| DBNAME | Name der Cameleon-Datenbank. Nur bei Bedarf ändern, wenn die Datenbank extern betrieben wird. | data |
| DBUSER | Owner der Datenbank. Wenn postgres nicht verwendet wird, muss der Benutzer manuell erstellt und berechtigt werden. | postgres |
| CLUSTERADMINPW | Initialpasswort für den Benutzer “cluster-admin” zur Anmeldung an der Cluster-Administration. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab. | Passwort |
| DBPASSWORD | Passwort zur Anmeldung an der Datenbank. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab. | Passwort |
| LOGINTOKEN | Das Token zur Verschlüsselung der Zugriffstoken auf Cameleon. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab. | Token |
| VAULTTOKEN | Das Token zur Verschlüsselung von Daten in Cameleon. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab. | Token |
| EMAILINTEGRATIONTOKEN | Das Token zur Verschlüsselung der Zugriffstoken für E-Mail-Inbound-Integrationen. Bitte ändern Sie diesen Wert aus Sicherheitsgründen ab. | Token |
| DOCKER_NETWORK_NAME | Docker Netzwerk, in dem die Applikation betrieben wird. Das Netzwerk kann vor der Installation erstellt werden bzw. vorhanden sein. | cam_network |
| DOCKER_NETWORK_DRIVER | Wird ignoriert, wenn DOCKER_NETWORK_EXTERNAL true ist. Standardmäßig bridge für eine einzelne Docker-Installation. Bei mehreren Docker Hosts (Swarm Mode) ist overlay erforderlich. | bridge oder overlay |
| DOCKER_NETWORK_EXTERNAL | Standardmäßig true. Das bedeutet, dass das Netzwerk extern erstellt und verwaltet wird. Es wird davon ausgegangen, dass das Netzwerk bereits vor der Installation existiert. Wenn der Wert false ist, wird das Netzwerk durch das Compose-File erstellt. | true |
| CAMELEON_VOLUME | Persistenter Speicher für Cameleon. Absoluter Pfad zu einem Verzeichnis. | /var/nfs/cameleon |
| USER_ID | Benutzer-ID, unter der die Applikation ausgeführt wird. | 6001 |
| GROUP_ID | Gruppen-ID, unter der die Applikation ausgeführt wird. | 6000 |
| EXTRA_HOST | Eigenes Hostname-Mapping zur Auflösung eines Hostnames in Docker | cameleon.local:127.0.0.1 |
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.
Der Parameter EXTRA_HOST muss übergeben werden, auch wenn dieser nicht verwendet wird, da Docker Compose keine Bedingungslogik in der YAML-Datei unterstützt.
Stellen Sie sicher, dass die angegebene Benutzer-ID Owner des db-Verzeichnisses ist und das db-Verzeichnis 0700 oder 0750 Berechtigung besitzt.
Stellen Sie sicher, dass die angegebene Benutzer-ID Lese- und Schreibberechtigung auf den angegebenen Cameleon-Volumes “files” und “proxy” besitzt.
Benennen Sie die gewünschte Compose-File in “compose.yaml” um.
Eine bestehende Cameleon-Umgebung kann durch folgenden Befehl aktualisiert werden:
docker compose --env-file <Umgebungsvariablen>.env up -d --remove-orphansLöschen Sie den lokalen Browser-Cache.
Führen Sie nach dem 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.