1e2736ff6SVladimir Kotal[](https://microbadger.com/images/opengrok/docker "Get your own image badge on microbadger.com") 2e2736ff6SVladimir Kotal[](https://microbadger.com/images/opengrok/docker "Get your own version badge on microbadger.com") 3e2736ff6SVladimir Kotal 41106ade6SVladimir Kotal# A Docker container for OpenGrok 51106ade6SVladimir Kotal 61106ade6SVladimir Kotal## OpenGrok from official source 71106ade6SVladimir Kotal 81106ade6SVladimir KotalBuilt from official source: https://github.com/oracle/opengrok/releases/ 91106ade6SVladimir Kotal 101106ade6SVladimir KotalYou can learn more about OpenGrok at http://oracle.github.io/opengrok/ 111106ade6SVladimir Kotal 121106ade6SVladimir KotalThe container is available from DockerHub at https://hub.docker.com/r/opengrok/docker/ 131106ade6SVladimir Kotal 141106ade6SVladimir Kotal## When not to use it 151106ade6SVladimir Kotal 16*bc2f6de0SVladimir KotalThis image is simple wrapper around OpenGrok environment. It is basicallyt a small appliance. The indexer and the web container are **not** tuned for large workloads. 17*bc2f6de0SVladimir Kotal 181106ade6SVladimir KotalIf you happen to have one of the following: 191106ade6SVladimir Kotal - large source data (e.g. [AOSP](https://en.wikipedia.org/wiki/Android_Open_Source_Project) or the like) 201106ade6SVladimir Kotal - stable service 211106ade6SVladimir Kotal - Source Code Management systems not supported in the image (e.g. Perforce, 221106ade6SVladimir Kotal Clearcase, etc.) 23*bc2f6de0SVladimir Kotal - need for authentication/authorization 24*bc2f6de0SVladimir Kotalthen it is advisable to run OpenGrok standalone or construct your own Docker 251106ade6SVladimir Kotalimage based on the official one. 261106ade6SVladimir Kotal 27f70822c2SVladimir Kotal## Additional info about the image 281106ade6SVladimir Kotal 291106ade6SVladimir Kotal* Tomcat 9 301106ade6SVladimir Kotal* JRE 8 (Required for Opengrok 1.0+) 311106ade6SVladimir Kotal* Configurable mirroring/reindexing (default every 10 min) 321106ade6SVladimir Kotal 331106ade6SVladimir KotalThe mirroring step works by going through all projects and attempting to 341106ade6SVladimir Kotalsynchronize all its repositories (e.g. it will do `git pull` for Git 351106ade6SVladimir Kotalrepositories). 361106ade6SVladimir Kotal 37ab135123SVladimir Kotal### Indexer logs 38ab135123SVladimir Kotal 391106ade6SVladimir KotalThe indexer/mirroring is set so that it does not log into files. 401106ade6SVladimir KotalRather, everything goes to standard (error) output. To see how the indexer 411106ade6SVladimir Kotalis doing, use the `docker logs` command. 421106ade6SVladimir Kotal 4384ed967bSVladimir Kotal### Source Code Management systems supported 4484ed967bSVladimir Kotal 4584ed967bSVladimir Kotal- Mercurial 4684ed967bSVladimir Kotal- Git 4784ed967bSVladimir Kotal- Subversion 4884ed967bSVladimir Kotal 49f70822c2SVladimir Kotal### Tags and versioning 50f70822c2SVladimir Kotal 51eea6103dSVladimir KotalEach OpenGrok release triggers creation of new Docker image. 52eea6103dSVladimir Kotal 53eea6103dSVladimir Kotal| Tag | Note | 54eea6103dSVladimir Kotal| -------- |:--------------------------------------------------------| 55eea6103dSVladimir Kotal| `latest` | tracks the latest version | 56eea6103dSVladimir Kotal| `x.y.z` | if you want to pin against a specific version | 57eea6103dSVladimir Kotal| `x.y` | stay on micro versions to avoid reindexing from scratch | 58f70822c2SVladimir Kotal 591106ade6SVladimir Kotal## How to run 601106ade6SVladimir Kotal 611106ade6SVladimir Kotal### From DockerHub 621106ade6SVladimir Kotal 631106ade6SVladimir Kotal docker run -d -v <path/to/your/src>:/opengrok/src -p 8080:8080 opengrok/docker:latest 641106ade6SVladimir Kotal 651106ade6SVladimir KotalThe container exports ports 8080 for OpenGrok. 661106ade6SVladimir Kotal 671106ade6SVladimir KotalThe volume mounted to `/opengrok/src` should contain the projects you want to make searchable (in sub directories). You can use common revision control checkouts (git, svn, etc...) and OpenGrok will make history and blame information available. 681106ade6SVladimir Kotal 691106ade6SVladimir KotalBy default, the index will be rebuild every ten minutes. You can adjust this 701106ade6SVladimir Kotaltime (in minutes) by passing the `REINDEX` environment variable: 711106ade6SVladimir Kotal 721106ade6SVladimir Kotal docker run -d -e REINDEX=30 -v <path/to/your/src>:/opengrok/src -p 8080:8080 opengrok/docker:latest 731106ade6SVladimir Kotal 741106ade6SVladimir KotalSetting `REINDEX` to `0` will disable automatic indexing. You can manually trigger an reindex using docker exec: 751106ade6SVladimir Kotal 761106ade6SVladimir Kotal docker exec <container> /scripts/index.sh 771106ade6SVladimir Kotal 781106ade6SVladimir KotalSetting `INDEXER_OPT` could pass extra options to opengrok-indexer. For example, you can run with: 791106ade6SVladimir Kotal 801106ade6SVladimir Kotal docker run -d -e INDEXER_OPT="-i d:vendor" -v <path/to/your/src>:/opengrok/src -p 8080:8080 opengrok/docker:latest 811106ade6SVladimir Kotal 821106ade6SVladimir KotalTo remove all the `*/vendor/*` files from the index. You can check the indexer options on 831106ade6SVladimir Kotal 841106ade6SVladimir Kotalhttps://github.com/oracle/opengrok/wiki/Python-scripts-transition-guide 851106ade6SVladimir Kotal 861106ade6SVladimir KotalTo avoid the mirroring step, set the `NOMIRROR` variable to non-empty value. 871106ade6SVladimir Kotal 881106ade6SVladimir Kotal## OpenGrok Web-Interface 891106ade6SVladimir Kotal 901106ade6SVladimir KotalThe container has OpenGrok as default web app installed (accessible directly from `/`). With the above container setup, you can find it running on 911106ade6SVladimir Kotal 921106ade6SVladimir Kotalhttp://localhost:8080/ 931106ade6SVladimir Kotal 941106ade6SVladimir KotalThe first reindex will take some time to finish. Subsequent reindex will be incremental so will take signigicantly less time. 951106ade6SVladimir Kotal 961106ade6SVladimir Kotal### Build image locally 971106ade6SVladimir Kotal 981106ade6SVladimir KotalIf you want to do your own development, you can build the image yourself: 991106ade6SVladimir Kotal 1006670a14aSVladimir Kotal mvn -DskipTests=true clean package && \ 1011106ade6SVladimir Kotal docker build -t opengrok-dev . 1021106ade6SVladimir Kotal 1031106ade6SVladimir KotalThen run the container: 1041106ade6SVladimir Kotal 1051106ade6SVladimir Kotal docker run -d -v <path/to/your/src>:/opengrok/src -p 8080:8080 opengrok-dev 1061106ade6SVladimir Kotal 1071106ade6SVladimir Kotal## Inspecting the container 1081106ade6SVladimir Kotal 1091106ade6SVladimir KotalYou can get inside a container using the [command below](https://docs.docker.com/engine/reference/commandline/exec/): 1101106ade6SVladimir Kotal 1111106ade6SVladimir Kotal``` 1121106ade6SVladimir Kotaldocker exec -it <container> bash 1131106ade6SVladimir Kotal``` 1141106ade6SVladimir Kotal 1151106ade6SVladimir KotalEnjoy. 116
){kind=link}
){kind=link}