Mercurial > gemma
annotate docker/README.md @ 4606:dfe9cde6a20c geoserver_sql_views
Reflect database model changes for SQL views in backend
In principle, we could use many datasources with different database
schemas, but this would imply changing GeoServer initialization,
service filtering, endpoints and eventually more. Since we do not need
it, just hard-code the schema name as a constant.
author | Tom Gottfried <tom@intevation.de> |
---|---|
date | Thu, 05 Sep 2019 12:23:31 +0200 |
parents | 8dd59e2c9d3d |
children |
rev | line source |
---|---|
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
1 # Build and run your dev environment using Docker |
524
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
2 |
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
3 - [Build and run your dev environment using Docker](#build-and-run-your-dev-environment-using-docker) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
4 - [Build and run your gemma application with Docker Compose in one step](#build-and-run-your-gemma-application-with-docker-compose-in-one-step) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
5 - [Hints and tricks](#hints-and-tricks) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
6 - [Build and run the gemma application with Docker manually](#build-and-run-the-gemma-application-with-docker-manually) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
7 - [Network setup](#network-setup) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
8 - [Database setup](#database-setup) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
9 - [Create ER diagrams](#create-er-diagrams) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
10 - [GeoServer setup](#geoserver-setup) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
11 - [Gemma backend setup](#gemma-backend-setup) |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
12 - [SPA setup](#spa-setup) |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
13 |
524
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
14 Run the `build` commands from the root of your checkout, because it is |
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
15 assumed as the context! |
36 | 16 |
524
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
17 Other example commands, too, assume they are run from the root of your |
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
18 checkout. |
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
19 |
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
20 ## Build and run your gemma application with Docker Compose in one step |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
21 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
22 Requires at least Docker Engine release 17.12.0+. Because of Compose file |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
23 format 3.5 for named networks. |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
24 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
25 If you fiddle around with the following error message: `Version in |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
26 "./docker-compose.yml" is unsupported` take a look at the comments in the |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
27 head of the `docker-compose.yml` file. |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
28 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
29 From your docker directory, start up your gemma application by running |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
30 `docker-compose up`. Here an example for build and running the gemma |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
31 application: |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
32 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
33 ```shell |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
34 cd docker |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
35 docker-compose -p gemma up |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
36 ``` |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
37 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
38 Note: The `-p` flag specifies an alternate project name (default: directory |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
39 name). |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
40 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
41 Now you should be able to use the application in your browser by going to |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
42 `http://HOSTNAME:8290`, with `HOSTNAME` being the hostname of your docker |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
43 host. |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
44 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
45 Stop the application, either by running `docker-compose down` from within your |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
46 docker directory in the second terminal, or by hitting `CTRL+C` in the |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
47 original terminal where you started the gemma application. |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
48 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
49 ### Hints and tricks |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
50 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
51 If you want to run your services in the background, you can pass the `-d` flag |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
52 (for `detached` mode) to `docker-compose up` and use `docker-compose ps` to see |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
53 what is currently running. Take a look at the following example. |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
54 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
55 ```shell |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
56 docker-compose up -d |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
57 Starting gemma_db ... |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
58 Starting gemma_db ... done |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
59 Starting gemma_geoserver ... |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
60 Starting gemma_geoserver ... done |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
61 Starting gemma_backend ... |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
62 Starting gemma_backend ... done |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
63 Starting gemma_spa ... |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
64 Starting gemma_spa ... done |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
65 ``` |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
66 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
67 ```shell |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
68 docker-compose ps |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
69 Name Command State Ports |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
70 ---------------------------------------------------------------------------------- |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
71 gemma_backend /usr/local/bin/gemma -c /o ... Up 0.0.0.0:8200->8000/tcp |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
72 gemma_db /usr/lib/postgresql/11/bin ... Up 0.0.0.0:54321->5432/tcp |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
73 gemma_geoserver /usr/share/tomcat8/bin/cat ... Up 0.0.0.0:8280->8080/tcp |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
74 gemma_spa /bin/sh -c make -f Makefil ... Up 0.0.0.0:8290->8080/tcp |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
75 ``` |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
76 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
77 For more infos about Docker Compose take a look at: |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
78 https://docs.docker.com/compose/ |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
79 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
80 ## Build and run the gemma application with Docker manually |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
81 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
82 Or build and run your dev enviroment manually by the following steps. |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
83 |
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
84 ### Network setup |
712
86725b39b2d2
Improve reproducability of documented docker commands
Tom Gottfried <tom@intevation.de>
parents:
596
diff
changeset
|
85 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
86 Create a network to connect containers: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
87 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
88 ```shell |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
89 docker network create gemma |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
90 ``` |
712
86725b39b2d2
Improve reproducability of documented docker commands
Tom Gottfried <tom@intevation.de>
parents:
596
diff
changeset
|
91 |
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
92 ### Database setup |
36 | 93 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
94 Build `gemma_db` docker image with e.g.: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
95 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
96 ```shell |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
97 docker build -t gemma_db -f docker/Dockerfile.db . |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
98 ``` |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
99 |
4165
8dd59e2c9d3d
Add Dockerfile for testing with upstream PostgreSQL/PostGIS
Tom Gottfried <tom@intevation.de>
parents:
2778
diff
changeset
|
100 In order to test the latest upstream PostgreSQL 11 and PostGIS 2.5, |
8dd59e2c9d3d
Add Dockerfile for testing with upstream PostgreSQL/PostGIS
Tom Gottfried <tom@intevation.de>
parents:
2778
diff
changeset
|
101 use Dockerile.pg instead. |
8dd59e2c9d3d
Add Dockerfile for testing with upstream PostgreSQL/PostGIS
Tom Gottfried <tom@intevation.de>
parents:
2778
diff
changeset
|
102 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
103 Get a running instance with e.g.: |
101 | 104 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
105 ```shell |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
106 docker run --name gemma-db -d -p 54321:5432 -v $PWD/schema:/opt/gemma \ |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
107 --network gemma gemma_db |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
108 ``` |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
109 |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
110 Use `--network-alias gemma-db` if your container has a different name |
524
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
111 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
112 Run tests for [Row-Level Security](https://www.postgresql.org/docs/11/ddl-rowsecurity.html) (RLS) |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
113 policies: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
114 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
115 ```shell |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
116 docker exec gemma-db ./run_tests.sh |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
117 ``` |
524
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
118 |
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
119 ### Create ER diagrams |
83 | 120 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
121 Assuming you have installed `postgresql-autodoc` and |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
122 [graphviz](http://graphviz.org/) on a machine from which you can reach your |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
123 docker host, you can use the following: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
124 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
125 ER diagram with waterway related tables: |
83 | 126 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
127 ```shell |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
128 postgresql_autodoc -p 54321 -h $dockerhost \ |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
129 -d gemma -U sophie --password=so2Phie4 \ |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
130 -t dot -l . -s 'waterway' |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
131 dot -Tpdf gemma.dot > gemma_waterway.pdf |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
132 ``` |
524
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
133 |
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
134 Omit the `-s` option to get a diagram with all tables or use any other |
156a805941b5
Move docker stuff from schema to dedicated docker directory
Tom Gottfried <tom@intevation.de>
parents:
174
diff
changeset
|
135 schema name to see other parts of the whole picture. |
561
8f075ae6cf33
Improve docker usage and related docs
Tom Gottfried <tom@intevation.de>
parents:
524
diff
changeset
|
136 |
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
137 ### GeoServer setup |
561
8f075ae6cf33
Improve docker usage and related docs
Tom Gottfried <tom@intevation.de>
parents:
524
diff
changeset
|
138 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
139 Build `gemma_geoserver` docker image with e.g.: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
140 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
141 ```shell |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
142 docker build -t gemma_geoserver -f docker/Dockerfile.geoserv . |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
143 ``` |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
144 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
145 Get a running instance with e.g.: |
561
8f075ae6cf33
Improve docker usage and related docs
Tom Gottfried <tom@intevation.de>
parents:
524
diff
changeset
|
146 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
147 ```shell |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
148 docker run --name gemma-geoserver -d -p 8280:8080 --network gemma \ |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
149 gemma_geoserver |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
150 ``` |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
151 |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
152 Use `--network-alias gemma-geoserver` if you give your container |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
153 a different name. |
561
8f075ae6cf33
Improve docker usage and related docs
Tom Gottfried <tom@intevation.de>
parents:
524
diff
changeset
|
154 |
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
155 ### Gemma backend setup |
561
8f075ae6cf33
Improve docker usage and related docs
Tom Gottfried <tom@intevation.de>
parents:
524
diff
changeset
|
156 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
157 Build `gemma_backend` docker image with e.g.: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
158 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
159 ```shell |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
160 docker build -t gemma_backend -f docker/Dockerfile.backend . |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
161 ``` |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
162 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
163 Get a running instance with e.g.: |
561
8f075ae6cf33
Improve docker usage and related docs
Tom Gottfried <tom@intevation.de>
parents:
524
diff
changeset
|
164 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
165 ```shell |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
166 docker run --name gemma-backend -v $PWD:/opt/gemma -d -p 8200:8000 \ |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
167 --network gemma gemma_backend |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
168 ``` |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
169 |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
170 Use `--network-alias gemma-backend` if you give your container |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
171 a different name. |
596
6d7c0dbf9d21
Fix running client container with clean checkout in volume
Tom Gottfried <tom@intevation.de>
parents:
561
diff
changeset
|
172 |
2163
b6b699385302
Added docker compose support.
Bjoern Schilberg <bjoern@intevation.de>
parents:
2142
diff
changeset
|
173 ### SPA setup |
596
6d7c0dbf9d21
Fix running client container with clean checkout in volume
Tom Gottfried <tom@intevation.de>
parents:
561
diff
changeset
|
174 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
175 Build `gemma_spa` docker image with e.g.: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
176 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
177 ```shell |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
178 docker build -t gemma_spa -f docker/Dockerfile.spa . |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
179 ``` |
596
6d7c0dbf9d21
Fix running client container with clean checkout in volume
Tom Gottfried <tom@intevation.de>
parents:
561
diff
changeset
|
180 |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
181 Get a running instance with e.g.: |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
182 |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
183 ```shell |
2778
7ebd4154894e
Adopt container names to fix GeoServer startup
Tom Gottfried <tom@intevation.de>
parents:
2163
diff
changeset
|
184 docker run --name gemma-spa -v $PWD/client:/opt/gemma/client -d -p 8290:8080 \ |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
185 --network gemma gemma_spa |
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
186 ``` |
596
6d7c0dbf9d21
Fix running client container with clean checkout in volume
Tom Gottfried <tom@intevation.de>
parents:
561
diff
changeset
|
187 |
6d7c0dbf9d21
Fix running client container with clean checkout in volume
Tom Gottfried <tom@intevation.de>
parents:
561
diff
changeset
|
188 Now you should be able to use the application in your browser by going to |
2142
70471052f6b0
docker/README.md: Formatting, typos and concretizations.
Bjoern Schilberg <bjoern@intevation.de>
parents:
1982
diff
changeset
|
189 `http://HOSTNAME:8290`, with `HOSTNAME` being the hostname of your docker host. |