annotate docker/README @ 9790:75dc4ea60938 3.2.x

Drop using explicit container names Compose will generate names for the containers and containers can connect each other on the network via the service names. This avoids the unnecessary extra "name space" and prepares the application for usage with different project names.
author Tom Gottfried <tom@intevation.de>
date Thu, 20 Jul 2023 10:25:59 +0200
parents 3847836c60b5
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