With version 5.8.0 translate5 is able to run completely in docker containers - making installation and scaling much more easier.
Therefore the all services were migrated into docker containers or already existing docker containers are used.
Note |
---|
An existing translate5 installation may remain as it is, only users of the non public VisualReview Plug-In has to setup and configure the following needed services as docker containers. Since the VisualReview Plug-In is not public, the pdfconverter container is also not public. In order to use it, we have to provide you an access token to docker hub. Please ask for that! See also translate5 docker installation manual for additional information. |
The translate5 docker installation manual contains a docker-compose configuration file for all services and more advanced information.
Docker containers and local DNS configuration
Code Block | ||
---|---|---|
| ||
# with the execution (and download) of the following docker containers you agree the licenses of the software in the containers! docker run -d --restart unless-stopped --name visualbrowser -p 127.0.0.2:3000:3000/tcp -e CONNECTION_TIMEOUT=600000 -e DEFAULT_IGNORE_HTTPS_ERRORS=true -e MAX_PAYLOAD_SIZE=50mb browserless/chrome docker run -d --restart unless-stopped --name pdfconverter -p 127.0.0.2:8086:8086/tcp translate5/pdfconverter # https://stackoverflow.com/questions/27937185/assign-static-ip-to-docker-container echo 172.17.0.3 visualbrowser get the docker internal IP address of the above started visualbrowser container: docker inspect visualbrowser | grep -i IPAddress echo "127.0.0.2 pdfconverter" >> /etc/hosts echo "IP_ADDRESS_GREPPED_ABOVE visualbrowser" >> /etc/hosts |
Warning |
---|
The IP address of visualbrowser must be updated in /etc/hosts after a renew/restart of the visualbrowser container! This is an open todo to make it static: https://stackoverflow.com/questions/27937185/assign-static-ip-to-docker-container |
Apache config
The following code block must be added to the apache vhost section serving translate5 - replace ABSOLUTE_PATH_TO_TRANSLATE5 with your local translate5 directory path:
Restart apache after that.
Code Block | ||
---|---|---|
| ||
Alias /visual "/ABSOLUTE_PATH_TO_TRANSLATE5/data/visual" <Directory "/ABSOLUTE_PATH_TO_TRANSLATE5/data/visual"> AllowOverride All Options Indexes FollowSymLinks # Options Indexes FollowSymLinks SymLinksIfOwnerMatch Order allow,deny Allow from all </Directory> |
- docker pdfconverter & browserless/chrome
- configuration of them!
- apache change needed for browserless/chrome
TO BE DOCUMENTED:
Config
Translate5 config
The following configurations contains the URLs pointing to the services in the docker containers. They are set correctly by default if you add the above entries to /etc/hosts.
- runtimeOptions.plugins.VisualReview.pdfconverterUrl
- runtimeOptions.plugins.VisualReview.dockerizedHeadlessChromeUrl
The old The "runtimeOptions.plugins.VisualReview.shellCommandGoogleChrome" is removed and the docker-url must be set in "runtimeOptions.plugins.VisualReview.dockerizedHeadlessChromeUrl" to continue converting PDFsin favour of the above URL based configuration.