https://github.com/opengeospatial/teamengine-docker
https://github.com/opengeospatial/teamengine-docker
docker-container docker-image dockerfile team-engine
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/opengeospatial/teamengine-docker
- Owner: opengeospatial
- Created: 2017-02-01T13:38:59.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-06-25T09:39:39.000Z (12 months ago)
- Last Synced: 2025-06-25T10:21:52.779Z (12 months ago)
- Topics: docker-container, docker-image, dockerfile, team-engine
- Language: Dockerfile
- Size: 196 KB
- Stars: 7
- Watchers: 11
- Forks: 22
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Running OGC TEAM Engine with selected executable test suites on Docker
This project provides Dockerfiles for building Docker Images with OGC TEAM Engine and selected executable test suites pre-installed.
## Modules
Currently, following modules are available.
| Module name | Description |
| --- | --- |
| teamengine-production | Includes TEAM Engine and executable test suites of OGC CITE Production environment |
| teamengine-beta | Includes TEAM Engine and executable test suites of OGC CITE Beta environment |
## Introduction
Running the Docker Containers with pre-installed OGC TEAM Engine and selected executable test suites from the provided Dockerfiles needs some preparations:
* Install Docker
* Build required Maven projects (not always required)
* Build Docker Image with Maven
* Create and start Docker Container
The steps are described in the following sections.
### Requirements
The following software is required for the complete workflow (from git clone to the running Docker Container). The specified versions are the tested ones. Other versions should also work.
* JDK 1.8
* Git 2.9.3
* Maven 3.3.9
* Docker 1.12
## Prerequisites
Before you start to work with this project, Docker has to be installed and all dependencies be provided as described in the following sections.
### Install Docker
Check the official [Docker documentation](https://docs.docker.com/engine/) for information how to install Docker on your operating system. And then install Docker and supporting tools.
### Dependencies
Most dependencies are automatically downloaded from Central Maven Repository (https://search.maven.org/) by Maven.
However, some dependencies must be built manually.
You can use the script scripts/build-test-suites-not-available-via-central-maven-repo.sh to automatically build all missing dependencies.
Note: You can use any versions of the TEAM Engine and executable test suites.
Just update the versions set in the properties in the pom.xml.
### Build TEAM Engine Docker Image
Run following commands to build a Docker Image with TEAM Engine and all selected executable test suites:
% git clone https://github.com/opengeospatial/teamengine-docker.git
% cd teamengine-docker
% mvn clean install
If those commands are executed, all modules are built (```mvn clean install``` is executed in root directory of this project).
## Running TEAM Engine inside a Docker Container
The following Docker command starts TEAM Engine with executable test suites inside a Docker Container on port 8081 with the previously built Docker Image named ```ogccite/teamengine-production```:
% docker run -p 8081:8080 --rm ogccite/teamengine-production
## Accessing the TEAM Engine web interface
Use a browser of your choice and open the URL:
http://localhost:8081/teamengine
## Hints for usage in production
### Mount user data from host system
User data should be backed up regularly as they contain all registered users and the corresponding test runs.
An easy way to achieve this is to hold these data on the host system. By that they can be backed up by simple file system backups. Also, the data can easily be copied and used by different Docker Containers.
So, the user data folder must be mounted into the Docker Container.
A host system directory can be mounted as a data volume with the ```-v``` flag.
This is an example how to mount the ~/te_base/users (Linux syntax) folder (is created if not existing) of host system into Docker Container:
% docker run -p 8081:8080 -v ~/te_base/users:/usr/local/tomcat/te_base/users --rm ogccite/teamengine-production