annotate docker/README @ 9719:f3aa7a12c86a 3.2.x

It's no longer necessary to install these artifacts from a file Oracle-JDBC drivers are fetched from Maven repository since rev. ee1b409af91c.
author Tom Gottfried <tom@intevation.de>
date Mon, 12 Jul 2021 14:39:58 +0200
parents c3afc0274bba
children 13e2d38ad314
rev   line source
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
1 Configure:
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
2 _ Change 'localhost' to 'd4eriver-db' in artifacts/doc/conf/backend-db.xml
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
3 and artifacts/doc/conf/seddb-db.xml
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
4 _ Change 'localhost' to '0.0.0.0' in artifacts/doc/conf/rest-server.xml
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
5 _ Change 'localhost' to 'd4eriver-artifacts' in the server-url parameter in
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
6 gwt-client/src/main/webapp/WEB-INF/web.xml
9687
25532d3c0af2 Avoid NPE when trying to print map to PDF
Tom Gottfried <tom@intevation.de>
parents: 9686
diff changeset
7 _ Set font path to /usr/share/fonts/gnu-free/FreeSans.ttf in
25532d3c0af2 Avoid NPE when trying to print map to PDF
Tom Gottfried <tom@intevation.de>
parents: 9686
diff changeset
8 gwt-client/src/main/webapp/WEB-INF/config.yaml
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
9
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
10
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
11 Build:
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
12
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
13 $ docker build -f docker/Dockerfile.db -t d4e/river_db .
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
14 $ docker build -f docker/Dockerfile.artifacts -t d4e/river_artifacts .
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
15 $ docker build -f docker/Dockerfile.gwt-client -t d4e/river_client .
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
16
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
17
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
18 Run:
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
19
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
20 $ docker network create d4e_river
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
21 $ docker run --name d4eriver-db --network d4e_river \
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
22 -dp 2345:5432 d4e/river_db:latest
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
23 $ docker run --name d4eriver-artifacts --network d4e_river \
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
24 -dp 8181:8181 d4e/river_artifacts
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
25 $ docker run --name d4eriver-client --network d4e_river \
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
26 -v $PWD:/opt/d4e/river -dp 8080:8080 d4e/river_client
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
27
9716
c3afc0274bba Improve Docker-based development setup
Tom Gottfried <tom@intevation.de>
parents: 9687
diff changeset
28 The application should now be accessible on your docker host under
c3afc0274bba Improve Docker-based development setup
Tom Gottfried <tom@intevation.de>
parents: 9687
diff changeset
29 port 8080 and path /d4e-river (e.g. http://your-host:8080/d4e-river).
9686
33303817ed37 Deploy webapp as d4e-river
Tom Gottfried <tom@intevation.de>
parents: 9684
diff changeset
30 See docker/flys_user_file for credentials.
33303817ed37 Deploy webapp as d4e-river
Tom Gottfried <tom@intevation.de>
parents: 9684
diff changeset
31
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
32
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
33 TODO:
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
34 _ Avoid having to change configuration manually
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
35 _ Allow running artifact server with `-v $PWD:/opt/d4e/river'
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
36 (currently this leads to missing h2 databases)
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
37 _ Let all components log to stdout to enable useful usage of `docker logs'
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
38 _ Something better than setting framework and http-client to a branch
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
39 explicitly in the Dockerfiles

http://dive4elements.wald.intevation.org