Manual - OTOBO Installation/Installation Manual OTOBO 11 — German @ OTOBO Translation: Customizing the OTOBO Docker image

Zen

	English	German	Actions
	Skip startup of specific services	Startvorgang gewisser Dienste überspringen
	The current Docker compose setup start five, six when HTTPS is activated, services. But there are valid use cases where one or more of these services are not needed. The prime example is when the database should not run as a Docker service, but as an external database. Unfortunately there is no dedicated Docker compose option for skipping specific services. But the option `--scale` can be abused for this purpose. So for an installation with an external database the following command can be used:	Das aktuelle Docker-Compose-Setup startet fünf, sechs wenn HTTPS aktiviert ist, Dienste. Aber es gibt gültige Anwendungsfälle, in denen einer oder mehrere dieser Dienste nicht benötigt werden. Das Hauptbeispiel ist, wenn die Datenbank nicht als Docker-Dienst, sondern als externe Datenbank laufen soll. Leider gibt es keine spezielle Docker-Compose-Option, um bestimmte Dienste zu überspringen. Aber die Option `--scale` kann für diesen Zweck missbraucht werden. Für eine Installation mit einer externen Datenbank könnte der folgende Befehl verwendet werden:
	Of course the same goal can also be achieved by editing the file docker-compose/otobo-base.yml and removing the relevant service definitions.	Selbstverständlich kann das selbe Ziel auch erreicht werden, indem man die Datei docker-compose/otobo-base.yml anpasst und die relevanten Service-Definitionen entfernt.
	Prepare offline installation	Native Installation vorbereiten
	Please download `the latest version of otobo-docker <https://doc.otobo.org/manual/installation/11.0/en/content/installation-docker.html#clone-the-otobo-docker-repo>`__ on a system that has internet access and where docker is installed. Then navigate to the following folder otobo-docker/docker-compose.	Bitte lade `die neueste Version von otobo-docker <https://doc.otobo.org/manual/installation/10.1/de/content/installation-docker.html#clone-the-otobo-docker-repo>`__ auf einem System herunter, das Internetzugang hat und auf dem Docker installiert ist. Navigiere dann zu dem folgenden Ordner otobo-docker/docker-compose.
	Now you can run the following command to download all Docker images from a specific file, in my example I use the otobo-base.yml.	Jetzt kannst du den folgenden Befehl ausführen, um alle Docker-Images aus einer bestimmten Datei herunterzuladen, in meinem Beispiel verwende ich otobo-base.yml.
	After that, the images (.docker) are located in the docker-compose folder and can be uploaded to the target system via e.g `SCP <https://en.wikipedia.org/wiki/Secure_copy_protocol>`__.	Danach befinden sich die Images (.docker) im Docker-Compose-Ordner und können über z.B. `SCP <https://de.wikipedia.org/wiki/Secure_copy_protocol>`__ auf das Zielsystem hochgeladen werden.
	On the offline target system, go to the folder where the docker images are stored. And enter the following command to import them one by one.	Gehe auf dem Offline-Zielsystem in den Ordner, in dem die Docker-Images gespeichert sind. Und gib den folgenden Befehl ein, um sie nacheinander zu importieren.
	In the following example I import the mariadb image:	Im folgenden Beispiel importiere ich das mariadb-Image:
	Customizing OTOBO Docker Compose	Docker Image individualisieren
	Instead of editing the files under docker-compose/ and risking to overwrite your own options with the `next update <https://doc.otobo.org/manual/installation/11.0/en/content/updating-docker.html#updating-the-docker-compose-files>`_ of the otobo-docker folder, it is advisable to create an extra YAML file where the specific services are overwritten with additional options.	Statt die Dateien unter docker-compose/ zu bearbeiten und das Risiko einzugehen, deine eigenen Optionen mit dem `nächsten Update <https://doc.otobo.org/manual/installation/10.1/de/content/updating-docker.html#updating-the-docker-compose-files>`_ des otobo-docker-Ordners zu überschreiben, ist es ratsam, eine extra YAML-Datei zu erstellen, in der die spezifischen Dienste mit zusätzlichen Optionen überschrieben werden.
	A common example would be to make the database container accessible from the outside via port 3306. For this you could create an extra docker compose file thats look like:	Ein gängiges Beispiel wäre, den Datenbankcontainer von außen über den Port 3306 zugänglich zu machen. Dafür könntest du eine extra Docker-Compose-Datei erstellen, die so aussieht:
	Now we have to tell docker-compose to include our new file. For this you have to add your YAML file to the COMPOSE_FILE variable in the .env file, for example:	Jetzt müssen wir docker-compose sagen, dass unsere neue Datei einbezogen werden soll. Dafür musst du deine YAML-Datei zur COMPOSE_FILE-Variable in der .env-Datei hinzufügen, zum Beispiel:
	Now we can use docker-compose to recreate our container	Jetzt können wir docker-compose verwenden, um unseren Container neu zu erstellen
	With this procedure you can customize any service or volumes.	Mit diesem Verfahren kannst du jeden Service oder jedes Volume anpassen.
	Customizing the OTOBO Docker image	Docker Image individualisieren
	Many customizations can be done in the external volume otobo_opt_otobo which corresponds to the directory /opt/otobo in the Docker image. This works e.g. for local Perl modules which can be installed into /opt/otobo/local. Here is an example that installs the not very useful CPAN module `Acme::123`.	Viele Anpassungen können im externen Volume otobo_opt_otobo vorgenommen werden, das dem Verzeichnis /opt/otobo im Docker Image entspricht. So können Sie z. B. lokale Perl-Module in /opt/otobo/local installieren. Der Vorteil dieser Vorgehensweise besteht darin, dass das Image selbst dabei nicht verändert wird.
	The nice thing of this approach is that the Docker image itself does not have to be modified.	Das Schöne an diesem Ansatz ist, dass das Docker-Image selbst nicht modifiziert werden muss.
	Installing extra Debian packages is a little bit trickier. One approach is to create a custom Dockerfile and use the OTOBO image as the base image. Another approach is to create a modified image directly from a running container. This can be done with the command `docker commit`, https://docs.docker.com/engine/reference/commandline/commit/. A nice writeup of that process is available at https://phoenixnap.com/kb/how-to-commit-changes-to-docker-image.	Zusätzliche Debian-Pakete zu installieren ist etwas aufwändiger. Sie können dazu entweder ein individuelles Dockerfile auf Grundlage des OTOBO Image erzeugen. Oder Sie erstellen das angepasste Image direkt aus einem laufenden Container heraus. Nutzen Sie dazu den Befehl `docker commit` – mehr dazu unter https://docs.docker.com/engine/reference/commandline/commit/. Eine gute Anleitung mit Beispielen (auf Englisch) finden Sie auch unter https://phoenixnap.com/kb/how-to-commit-changes-to-docker-image.
	But for the latter approach there are two hurdles to overcome. First, the image otobo runs per default as the user otobo with the UID 1000. The problem is that the user otobo is not allowed to install system packages. Thus, the first part of the solution is to pass the option `--user root` when running the image. However the second hurdle is that the default entrypoint script /opt/otobo_install/entrypoint.sh exits immediately when it is called as root. The reasoning behind that design decision is that running inadvertently as root should be discouraged. So, the second part of the solution is to specify a different entrypoint script that does not care who the caller is. This leaves us with following example commands, where we add fortune cookies to otobo:	Die zweite Vorgehensweise birgt zwei Probleme: Erstens wird das Image otobo standardmäßig mit dem Benutzer otobo und der UID 1000 ausgeführt. Der User otobo ist aber nicht berechtigt, Systempakete zu installieren. Der erste Schritt zur Lösung besteht deshalb darin, beim Ausführen des Images die Option`--user root` zu übergeben. Zweitens bricht das Standard-Skript zur Definition des Einstiegspunktes /opt/otobo_install/entrypoint.sh sofort ab, wenn es als root aufgerufen wird. Das wurde so angelegt, um zu verhindern, dass der Vorgang unbeabsichtigt als root ausgeführt wird. Der zweite Schritt zur Lösung besteht deshalb darin, ein anderes Entrypoint-Skript anzugeben, dem egal ist, von wem es aufgerufen wird. Wir nutzen folgende Beispielbefehle, um Fortune Cookies für OTOBO zu setzen:
	Pull a tagged OTOBO image, if we don't have it yet, and check whether the image already provides fortune cookies:	Pullen Sie ein getaggtes OTOBO Image (sofern nicht bereits vorhanden), und prüfen Sie, ob im Image schon Fortune Cookies bereitgestellt werden:
	Add fortune cookies to a named container running the original OTOBO image. This is done in an interactive session as the user root:	Ergänzen Sie die Fortune Cookies in einem benannten Container im originalen OTOBO Image. Dazu nutzen wir eine interaktive Session und den User root:
	Create an image from the stopped container and give it a name. Take into account that the default user and entrypoint script must be restored:	Erzeugen Sie ein Image auf Basis des gestoppten Containers und vergeben Sie einen Namen. Beachten Sie, dass der Standardbenutzer und das Entrypoint-Skript wiederhergestellt werden müssen:
	Finally we can doublecheck:	Schließlich prüfen wir, ob alles funktioniert hat:
	The modified image can be specified in your .env file and then be used for fun and profit.	Das modifizierte Image kann in Ihrer .env-Datei angegeben und frei verwendet werden.
	Building local images	Lokale Images erstellen
	Building Docker images locally is usually only needed during development. Other use cases are when more current base images should be used for an installation or when extra functionality must be added to the images.	Lokale Docker Images werden in der Regel nur zur Entwicklung erstellt. Weitere Anwendungsfälle sind z.B. wenn aktuellere Basis Images benötigt werden oder wenn Images um zusätzliche Funktionalität erweitert werden sollen.
	The Docker files needed for creating Docker images locally are part of the the git repository https://github.com/RotherOSS/otobo:	Die zum Erstellen lokaler Docker Images benötigten Dateien finden Sie im Git Repository unter https://github.com/RotherOSS/otobo:
	otobo.web.dockerfile	otobo.web.dockerfile
	otobo.nginx.dockerfile	otobo.nginx.dockerfile
	otobo.elasticsearch.dockerfile	otobo.elasticsearch.dockerfile

Loading…

No matching activity found.

Browse all string changes

Things to check

Reused translation

Other source string: “Customizing OTOBO Docker Compose”

Reset

Glossary

English	German
No related strings found in the glossary.

String information

Source string location

../../content/installation-docker.rst:548

String age

7 months ago

Last updated

6 months ago

Source string age

7 months ago

Translation file

locale/de/LC_MESSAGES/content.po, string 323