steve
/
geoserver
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Double check readme headings

pull/7/head
Jody Garnett 2022-08-15 10:39:01 -07:00
parent c9a32f39c6
commit 0c7af98f0b
1 changed files with 46 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

73
README.md
View File

@ -22,6 +22,12 @@ docker pull docker.osgeo.org/geoserver:2.21.1
docker run -it -p 80:8080 docker.osgeo.org/geoserver:2.21.1
```
or if you want to start the container daemonized:
```
docker run -d -p 80:8080 docker.osgeo.org/geoserver:2.21.1
```
Check http://localhost/geoserver to see the geoserver page,
and login with geoserver default `admin:geoserver` credentials.
@ -29,21 +35,6 @@ and login with geoserver default `admin:geoserver` credentials.
For more information see the user-guide [docker installation instructions](https://docs.geoserver.org/latest/en/user/installation/docker).
### How to run local build?
After building run using local tag:
```
docker run -it -p 80:8080 {YOUR_TAG}
```
or if you want to start the container daemonized:
```
docker run -d -p 80:8080 {YOUR_TAG}
```
## How to download and install additional extensions on startup?
The ``startup.sh`` script allows some customization on startup:
@ -86,7 +77,7 @@ docker run -it -p 80:8080 \
### How to watch geoserver.log from host?
To watch ``geoserver.log`` of a running container:`
To watch ``geoserver.log`` of a running container:
```
docker exec -it {CONTAINER_ID} tail -f /opt/geoserver_data/logs/geoserver.log
@ -104,32 +95,60 @@ Run ``docker-compose``:
docker-compose -f docker-compose-demo.yml up --build
```
## How to Build?
`docker build -t {YOUR_TAG} .`
## How to build a specific GeoServer version?
### How to build a local image?
`docker build --build-arg GS_VERSION={YOUR_VERSION} -t {YOUR_TAG} .`
```
docker build -t {YOUR_TAG} .
```
## How to build with custom geoserver data?
### How to run local build?
`docker build --build-arg GS_DATA_PATH={RELATIVE_PATH_TO_YOUR_GS_DATA} .`
After building run using local tag:
```
docker run -it -p 80:8080 {YOUR_TAG}
```
### How to build a specific GeoServer version?
```
docker build \
--build-arg GS_VERSION={YOUR_VERSION} \
-t {YOUR_TAG} .
```
### How to build with custom geoserver data directory?
```
docker build \
--build-arg GS_DATA_PATH={RELATIVE_PATH_TO_YOUR_GS_DATA} \
-t {YOUR_TAG} .
```
**Note:** The passed path **must not** be absolute! Instead, the path should be within the build context (e.g. next to the Dockerfile) and should be passed as a relative path, e.g. `GS_DATA_PATH=./my_data/`
## Can I build a specific GS version with custom data?
### Can a build use a specific GeoServer version AND custom data?
Yes! Just pass the `--build-arg` param twice, e.g.
`... --build-arg GS_VERSION={VERSION} --build-arg GS_DATA_PATH={PATH} ...`
```
docker build \
--build-arg GS_VERSION={VERSION} \
--build-arg GS_DATA_PATH={PATH} \
-t {YOUR_TAG} .
```
## How to build with additional libs/extensions/plugins?
### How to build with additional libs/extensions/plugins?
Put your `*.jar` files (e.g. the WPS extension) in the `additional_libs` folder and build with one of the commands from above! (They will be copied to the GeoServer `WEB-INF/lib` folder during the build.)
**Note:** Similar to the GeoServer data path from above, you can also configure the path to the additional libraries by passing the `ADDITIONAL_LIBS_PATH` argument when building:
`--build-arg ADDITIONAL_LIBS_PATH={RELATIVE_PATH_TO_YOUR_LIBS}`
```
docker build \
--build-arg ADDITIONAL_LIBS_PATH={RELATIVE_PATH_TO_YOUR_LIBS}
-t {YOUR_TAG} .
```