F-TEP is an open platform for the forestry community to access and exploit EO data in a collaborative virtual work environment. Forestry TEP has been originally developed as part of ESA's Thematic Exploitation Platform initiative.
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.
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
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.
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/>.