Mit Docker Compose kann Cameleon in einer Docker-Umgebung installiert werden. Die Installationspakete stehen im Download-Bereich zur Verfügung.
Compose-Installationspaket
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.yaml | Eine Compose-File zur Bereitstellung des gesamten Applikation-Stack. |
| 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 |
Installation
Hinweise
Das Docker-Compose File installiert standardmäßig eine Datenbank im Container.
Die Cameleon-KI ist in dieser Version nicht in dem Compose-File enthalten.
Führen Sie folgende Schritte aus, um Cameleon in einer Docker-Umgebung zu installieren.
Bereiten Sie ein Verzeichnis vor, in dem die Daten von Cameleon dauerhaft persistiert werden können und hinterlegen Sie den absoluten Pfad in dem Parameter CAMELEON_VOLUME. Beispiel:
CAMELEON_VOLUME=/var/nfs/cameleonErstellen Sie bei Bedarf ein Netzwerk für Cameleon und konfigurieren Sie die Parameter DOCKER_NETWORK_NAME, DOCKER_NETWORK_DRIVER und DOCKER_NETWORK_EXTERNAL entsprechend.
Beispiel:
DOCKER_NETWORK_NAME=cam_network
DOCKER_NETWORK_DRIVER=bridge
DOCKER_NETWORK_EXTERNAL=truePassen Sie weitere Umgebungsvariablen bei Bedarf an.
Um die Container-Images aus der Cameleon-Registry herunterladen zu können, melden Sie sich mit Ihren Zugangsdaten an.
docker login <Cameleon-Registry-URL>Die Installation kann mit folgenden Befehl gestartet werden.
docker compose --env-file <Umgebungsvariablen>.env up -dFolgende Verzeichnisse werden automatisch in dem Cameleon Volume erstellt:
| Verzeichnis | Beschreibung |
| db | Dieses Verzeichnis wird von der internen Postgresql-Datenbank verwendet. |
| files | Das Verzeichnis enthält Daten der Plattform, Log-Files und Anhänge, die in Cameleon hochgeladen werden. |
| proxy | Das Verzeichnis wird von dem Cameleon Proxy verwendet und enthält das Webserver-Zertifikat. |
SSL-Zertifikat einspielen
Der Cameleon Proxy verwendet ein SSL-Zertifikat und -Schlüssel, die nach der Installation in dem proxy-Verzeichnis im PEM-Format und folgenden Dateinamen hinterlegt werden müssen.
| Dateiname | Beispiel |
| cert.pem | —–BEGIN CERTIFICATE—– MII… —–END CERTIFICATE—– |
| key.pem | —–BEGIN PRIVATE KEY—– MIIEgA… —–END PRIVATE KEY—– |
Falls noch kein Zertifikat vorhanden ist, können Sie ein vorhandenes Beispiel kopieren:
cd <CAMELEON_VOLUME>
cp files/ssl/cert.pem proxy/
cp files/ssl/key.pem proxy/