annotate docker/README @ 9779:3847836c60b5 3.2.x

Improve backend build for different database backends Use profiles instead of multiple almost identical POMs. Introduce build-time argument for Docker build.
author Tom Gottfried <tom@intevation.de>
date Tue, 07 Feb 2023 16:11:43 +0100
parents 9bbb29142ddb
children a00bb9d39c16
rev   line source
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
1 Configure:
9747
cfc0aab9947f Enable bind-mounting client configuration in docker container
Tom Gottfried <tom@intevation.de>
parents: 9746
diff changeset
2 _ Add to gwt-client/config/mapfish/config.yaml to enable map printing:
9743
d1dcb8d28b0d Consider map printing in Docker setup
Tom Gottfried <tom@intevation.de>
parents: 9739
diff changeset
3 - !dnsMatch
d1dcb8d28b0d Consider map printing in Docker setup
Tom Gottfried <tom@intevation.de>
parents: 9739
diff changeset
4 host: <your-host>
9755
0834c2591e14 Route MapServer through wiki container
Tom Gottfried <tom@intevation.de>
parents: 9754
diff changeset
5 port: 8080
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
6
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
7
9720
13e2d38ad314 Improve Docker based setup
Tom Gottfried <tom@intevation.de>
parents: 9716
diff changeset
8 Build and run:
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
9
9720
13e2d38ad314 Improve Docker based setup
Tom Gottfried <tom@intevation.de>
parents: 9716
diff changeset
10 $ cd docker
13e2d38ad314 Improve Docker based setup
Tom Gottfried <tom@intevation.de>
parents: 9716
diff changeset
11 $ docker-compose up
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
12
9716
c3afc0274bba Improve Docker-based development setup
Tom Gottfried <tom@intevation.de>
parents: 9687
diff changeset
13 The application should now be accessible on your docker host under
9754
cd07130ded8d Route GWT client through wiki container
Tom Gottfried <tom@intevation.de>
parents: 9753
diff changeset
14 port 8080 (e.g. http://your-host:8080).
9686
33303817ed37 Deploy webapp as d4e-river
Tom Gottfried <tom@intevation.de>
parents: 9684
diff changeset
15 See docker/flys_user_file for credentials.
33303817ed37 Deploy webapp as d4e-river
Tom Gottfried <tom@intevation.de>
parents: 9684
diff changeset
16
9779
3847836c60b5 Improve backend build for different database backends
Tom Gottfried <tom@intevation.de>
parents: 9760
diff changeset
17 In case an Oracle database should be used, the server service has to be
3847836c60b5 Improve backend build for different database backends
Tom Gottfried <tom@intevation.de>
parents: 9760
diff changeset
18 build with a build-time argument:
3847836c60b5 Improve backend build for different database backends
Tom Gottfried <tom@intevation.de>
parents: 9760
diff changeset
19
3847836c60b5 Improve backend build for different database backends
Tom Gottfried <tom@intevation.de>
parents: 9760
diff changeset
20 $ docker-compose build --build-arg ORACLE=true server
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
21
9760
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
22 Remote debugging:
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
23
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
24 To enable remote debugging of the artifact server, uncomment the respective
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
25 lines in docker-compose.yml, recreate the service and e.g. attach with JDB:
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
26 $ docker-compose up -d
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
27 $ jdb -attach <your-docker-host>:8787 -sourcepath<your-checkout>/artifacts/src/main/java
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
28
9bbb29142ddb Give hints for remote debugging artifact server
Tom Gottfried <tom@intevation.de>
parents: 9755
diff changeset
29
9684
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
30 TODO:
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
31 _ Avoid having to change configuration manually
537fe44f2792 Add basic Docker setup for development
Tom Gottfried <tom@intevation.de>
parents:
diff changeset
32 _ 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
33 explicitly in the Dockerfiles

http://dive4elements.wald.intevation.org