OSIRIS is an open platform for the food security community to access and exploit EO data in a collaborative virtual work environment. We're a part of ESA's Thematic Exploitation Platform initiative.
The latest and greatest OSIRIS source code can be found on GitHub.
OSIRIS may be built and packaged using the shell scripts in the build/
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 run the build scripts:
docker build -t osiris-build ./build/
docker run -v $PWD:$PWD -w $PWD osiris-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-osiris 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 from running the scripts described above: build/osiris.sh,
build/zoo-project.sh and build/standalone-dist.sh.
Once the distribution has been prepared, create your test environment
configuration in distribution/puppet/hieradata/standalone.local.yaml,
for example:
---
classes:
- osiris::backend
- osiris::db
osiris::repo::location: 'file:///vagrant/.dist/repo'
Then install the required vagrant plugins, and bring the machine up:
vagrant plugin install vagrant-vbguest vagrant-puppet-install
vagrant up osiris
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.
OSIRIS 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/>.