Awesome

Forestry-TEP

F-TEP is an open platform for the forestry community to access and exploit EO data in a collaborative virtual work environment. We're a part of ESA's Thematic Exploitation Platform initiative.

Source

The latest and greatest F-TEP source code can be found on GitHub.

Note that we are using Git submodules, so after checking out this repo, make sure to git submodule init and git submodule update.

Building

F-TEP may be built and packaged using the shell scripts in the buildImg/ subdirectory. The main part of the project may be built simply via Gradle.

To simplify the use of third-party dependencies in the full packaging pipeline, we offer a Dockerfile defining the full build environment, suitable for use in CI or locally.

To set up the build container and build the full distribution:

docker build -t ftep-build ./buildImg/
docker run -v $PWD:$PWD -w $PWD ftep-build gradle build buildDist --parallel

Note that some additional paths or environment variables may be required for each build task.

The standalone-dist.sh script produces a portable Puppet environment, using the cgieoss-ftep Puppet module (which is locally imported to the third-party/puppet directory).

Vagrant may be used to manage the Docker build container:

vagrant up build
vagrant ssh build

Test environment

We offer a Vagrant configuration environment which can be used for testing the distribution locally. This requires the full build results and yum repository achieved by building the gradle target buildDist in an environment containing /usr/bin/createrepo.

Once the distribution has been prepared, create your test environment configuration in distribution/puppet/hieradata/standalone.local.yaml. Copy the base standalone.yaml and adjust as needed.

Then install the required vagrant plugins, and bring the machine up:

vagrant plugin install vagrant-vbguest vagrant-puppet-install
vagrant up ftep

Vagrant will fully provision a VM from the Puppet modules and specified local configuration. The VM's web server should be available locally on port 8080.

License

F-TEP is licensed under the GNU Affero General Public License. The terms of the license are as follows:

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.