Wie installiere oder update ich VIMP Enterprise über das Docker-Image?

Image herunterladen und importieren

Laden Sie den Docker-Image-Tarball von Ihrem persönlichen Konto herunter und importieren Sie ihn wie unten beschrieben.

Wenn Sie VIMP das erste Mal per Docker-Image installieren möchten, kontaktieren Sie uns bitte, damit wir Ihnen das Image in Ihrem Account bereitstellen.

BITTE BEACHTEN: Die nachfolgende Installationsanleitung ist nicht für den produktiven Betrieb gedacht! Bitte konsultieren Sie Ihren Systemadministrator, um VIMP in einer produktiven Docker-Umgebung aufzusetzen!

Erstinstallation

Bitte ersetzen Sie 5.x.x-rxxxxx im Folgenden durch die aktuelle Versionsnummer und Revision.

gunzip vimp-enterprise-docker-5.x.x-rxxxxx.tar.gz
docker load -i vimp-enterprise-docker-5.x.x-rxxxxx.tar

Als Erstes ermitteln wir nun das Repository und den korrekten Tag für unser VIMP Image:

docker images | grep vimp

Sie erhalten durch obigen Befehl eine Liste der vorhandenen Docker Images. Relevant ist dabei für uns nun nur das letzte VIMP-Image, das beispielsweise wie folgt in der Liste erscheint:

REPOSITORY                          TAG                    IMAGE ID            CREATED             SIZE
registry.vimp.dev/vimp/enterprise   5.8.2-47311            62fbad7db208        18 hours ago        1.93GB

Der Registry-Pfad und der Tag müssen in den folgenden Befehlen und im docker-compose.yml-File entsprechend ersetzt werden, notieren Sie sich beide daher (in unserem Beispiel wäre es zusammengesetzt registry.vimp.dev/vimp/enterprise:5.1.6-77).

Wir fahren nun mit dem Erstellen des Verzeichnisses, aus dem die Volumes gemountet werden, fort (bitte ersetzen Sie test-vimp durch den tatsächlichen Verzeichnisnamen, den Sie verwenden möchten):

mkdir -p test-vimp
cd test-vimp

Sowie mit dem Verzeichnis für die MySQL-Daten:

mkdir -p vimp_db

Nun kopieren wir die Inhalte der Verzeichnisse config, templates und userdata (ersetzen Sie hier den Registry-Pfad und den Tag entsprechend).

docker run -d --name tmp_vimp_enterprise registry.vimp.dev/vimp/enterprise:5.8.2-47311 \
&& docker cp tmp_vimp_enterprise:/var/www/html/config . \
&& docker cp tmp_vimp_enterprise:/var/www/html/templates . \
&& docker cp tmp_vimp_enterprise:/var/www/html/userdata . \
&& docker stop tmp_vimp_enterprise \
&& docker rm tmp_vimp_enterprise

Schauen wir mal, ob alle Verzeichnisse vorhanden sind:

ls

Stellen Sie sicher, dass Sie eine ordnungsgemäße docker-compose.yml-Datei im aktuellen Verzeichnis neben den Ordnern config, templates und userdata haben (ein Beispiel für die docker-compose.yml finden Sie am Ende dieses Artikels).

Dann führen Sie folgendes aus:

docker-compose up -d

Sie können mit docker-compose logs -f überprüfen, ob die Datenbank bereit ist, Verbindungen zu akzeptieren. Installieren Sie dann die VIMP-Anwendung und erstellen Sie alle erforderlichen Tabellen wie folgt.

Wenn Sie dazu aufgefordert werden, stellen Sie bitte sicher, dass die Datenbank-Anmeldeinformationen mit den Datenbank-Anmeldeinformationen der docker-compose.yml-Datei übereinstimmen.

Beachten Sie dabei bitte, als Datenbank-Host den Namen des Services, in diesem Fall also "db", einzutragen.

docker-compose exec httpd ./vimp framework:install -C --yes \
&& docker-compose exec httpd ./vimp framework:update --nothing --modules=yes \
&& docker-compose exec httpd ./vimp framework:update --nothing --database=yes \
&& docker-compose exec httpd ./vimp framework:update --nothing --rebuild=yes

WICHTIGE HINWEISE:

• framework:install löscht alle vorhandenen Daten! Führen Sie dies nicht auf einer bestehenden VIMP-Datenbank aus, wenn Sie nicht wissen, was Sie tun! Lesen Sie weiter unten, wie Sie das Docker-Image aktualisieren.
• In VIMP-Versionen kleiner 6.x benutzen Sie bitte statt ./vimp den Befehl ./symfony in obigem Code.

Das war's - Sie können nun über Ihren angegebenen Apache-Servernamen auf VIMP zugreifen, in unserem Beispiel http://localhost.

Docker-Image aktualisieren

Hier beschreiben wir, wie Sie VIMP Enterprise mit docker-compose aktualisieren, wenn eine neue Version des Images vorliegt.

Bitte ersetzen Sie 5.x.x-rxxxxx im Folgenden durch die aktuelle Versionsnummer und Revision.

gunzip vimp-enterprise-docker-5.x.x-rxxxxx.tar.gz
docker load -i vimp-enterprise-docker-5.x.x-rxxxxx.tar

Als erstes ermitteln wir wieder das Repository und den korrekten Tag für unser VIMP Image:

docker images | grep vimp

Sie erhalten durch obigen Befehl eine Liste der vorhandenen Docker Images. Relevant ist dabei für uns nun nur das letzte VIMP-Image, das beispielsweise wie folgt in der Liste erscheint:

REPOSITORY                          TAG                    IMAGE ID            CREATED             SIZE
registry.vimp.dev/vimp/enterprise   5.8.2-47311            62fbad7db208        18 hours ago        1.93GB

Der Registry-Pfad und der Tag müssen in den folgenden Befehlen und im docker-compose.yml-File entsprechend ersetzt werden, notieren Sie sich beide daher (in unserem Beispiel wäre es zusammengesetzt registry.vimp.dev/vimp/enterprise:5.8.2-47311).

Bitte ersetzen Sie im Folgenden das Verzeichnis test-vimp wieder durch den tatsächlichen Verzeichnisnamen, den Sie verwenden möchten und ersetzen Sie den Registry-Pfad wie oben beschrieben:

cd test-vimp \
&& mkdir -p tmp \
&& docker run -d --name tmp_vimp_enterprise registry.vimp.dev/vimp/enterprise:5.8.2-47311 \
&& docker cp tmp_vimp_enterprise:/var/www/html/config ./tmp/config \
&& docker cp tmp_vimp_enterprise:/var/www/html/templates ./tmp/templates \
&& docker cp tmp_vimp_enterprise:/var/www/html/userdata ./tmp/userdata \
&& docker stop tmp_vimp_enterprise \
&& docker rm tmp_vimp_enterprise \
&& rm ./tmp/config/databases.yml ./tmp/config/propel.ini

Mit den vorstehenden Befehlen haben Sie ein „tmp/“-Verzeichnis erstellt und aus der aktuellen VIMP-Version die Ordner config, templates und userdata dort hinein kopiert.

Als nächstes ist etwas Handarbeit gefragt. Ihre Anpassungen in den bisherigen Ordnern (sofern Sie welche vorgenommen haben) müssen mit den Dateien aus /tmp/{config,userdata,templates} zusammengeführt werden.

Im einfachsten Fall - wenn Sie keine individuellen Anpassungen vorgenommen haben - können Sie die Dateien einfach kopieren:

cp -ar tmp/* .

Wenn das erledigt ist, können Sie mit

docker-compose stop httpd && docker-compose rm httpd

die aktuelle VIMP-Version stoppen und löschen und mit

docker-compose up -d httpd

die neue Version starten. Passen Sie davor aber bitte die richtige Version in der docker-compose.yml an.

Als Letztes muss noch ein Datenbank-Update ausgeführt werden:

docker-compose exec httpd ./symfony framework:update --nothing --rebuild=yes --yes
docker-compose exec httpd ./symfony framework:update --yes

Und wir löschen das tmp Verzeichnis:

rm -Rf tmp

Beispiel docker-compose.yml

Bitte ersetzen Sie den Registry-Pfad wie weiter oben beschrieben!

version: '3.3'
services:
  httpd:
    image: registry.vimp.dev/vimp/enterprise:5.8.2-47311
    container_name: vimp_httpd_enterprise
    restart: always
    ports:
      - "80:80" # use a free port
    environment:
      - APACHE_SERVER_NAME=localhost
    volumes:
      - ./config:/var/www/html/config:cached
      - ./templates:/var/www/html/templates:cached
      - ./userdata:/var/www/html/userdata
    depends_on:
      - db
    networks:
      - vimp-network

  db:
    image: mariadb:latest
    container_name: mariadb
    restart: always
    expose:
      - 3306
    volumes:
      - "./vimp_db:/var/lib/mysql"
    environment:
      MYSQL_USER: vimp
      MYSQL_PASSWORD: secret
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: vimp
    command: --sql_mode="IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO"
    networks:
      - vimp-network

networks:
  vimp-network:  # Define a custom network
    driver: bridge