The new Zooniverse API for supporting user-created projects.
The Panoptes public API is documented here, using apiary.io.
If you're interested in how Panoptes is implemented check out the wiki and the Data Model Description.
Since Panoptes uses Docker to manage its environment, the requirements listed below are also found in docker-compose.yml
. The means by which a new Panoptes instance is created with Docker is located in the Dockerfile
. If you plan on using Docker to manage Panoptes, skip ahead to Installation.
Panoptes is primarily developed against stable MRI, currently 2.3. If you're running MRI Ruby you'll need to have the Postgresql client libraries installed as well as have Postgresql version 9.4 running.
- Ubuntu/Debian:
apt-get install libpq-dev
- OS X (with homebrew):
brew install postgresql
Optionally, you can also run the following:
- Cellect Server version > 0.1.0
- Redis version > 2.8.19
We only support running Panoptes via Docker and Docker Compose. If you'd like to run it outside a container, see the above Requirements sections to get started.
It's possible to run Panoptes only having to install the fig_rake
gem. Alternatives to various rake tasks are presented.
-
Docker
-
Clone the repository
git clone https://github.com/zooniverse/Panoptes
. -
cd
into the cloned folder. -
Setup the configuration files via a rake task
- Run:
rake configure:local
Or manually copy the example configuration files and setup the doorkeeper keys.
- Run:
find config/*.yml.hudson -exec bash -c 'for x; do x=${x#./}; cp -i "$x" "${x/.hudson/}"; done' _ {} +
- Run:
rake configure:doorkeeper_keys
-
Install Docker from the appropriate link above.
-
- If you have an existing Panoptes Docker container, or if your Gemfile or Ruby version has changed, run
docker-compose build
to rebuild the containers. - Otherwise, create and run the application containers by running
docker-compose up
- If you have an existing Panoptes Docker container, or if your Gemfile or Ruby version has changed, run
-
After step 5 finishes, open a new terminal and run
docker-compose run --rm --entrypoint=rake panoptes db:setup
to setup the database. This will launch a new Docker container, run the rake DB setup task, and then clean up the container. -
To seed the development database with an Admin user and a Doorkeeper client application for API access run
docker-compose run --rm --entrypoint=rails panoptes runner db/fig_dev_seed_data/fig_dev_seed_data.rb
-
Open up the application in your browser:
-
It should be running on http://localhost:3000
-
If it's not and you're on a Mac, run
docker ps
, and find the IP address where thepanoptes_panoptes
image is running. E.g.: 0.0.0.0:3000->3000/tcp means running on localhost at port 3000.
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 1f98164914be panoptes_panoptes "/bin/sh -c /rails_ap" 16 minutes ago Up 16 minutes 80/tcp, 0.0.0.0:3000->3000/tcp panoptes_panoptes_1 ```
This will get you a working copy of the checked out code base. Keep your code up to date and rebuild the image if needed!
There are multiple options for setting up a testing environment:
-
Run it entirely from within docker-compose:
- To create the testing database, run
docker-compose run --rm -e RAILS_ENV=test --entrypoint=rake panoptes db:setup
. - Run the full spec suite
docker-compose run -T --rm -e RAILS_ENV=test --entrypoint=rspec panoptes
. Note: this will be slow. Use rspec focus set or specify the spec you want to run, e.g. ``docker-compose run -T --rm -e RAILS_ENV=test --entrypoint="rspec path/to/spec/file.rb" panoptes`
- To create the testing database, run
-
Use parts of docker-compose manually and wire them up manually to create a testing environment.
docker-compose run -d --name postgres --service-ports postgres docker-compose run -T --rm -e RAILS_ENV=test --entrypoint="bundle exec rspec" panoptes
-
Assuming you have a Ruby environment already setup:
- Run
bundle install
- Start the docker Postgres container by running
docker-compose run -d --name postgres --service-ports postgres
- Modify your
config/database.yml
test env to point to the running Postgres container, e.g.host: localhost
- Setup the testing database if you haven't already, by running
RAILS_ENV=test rake db:setup
- Finally, run rspec with
RAILS_ENV=test rspec
- Run
Thanks a bunch for wanting to help Zooniverse. Here are few quick guidelines to start working on our project:
- Fork the Project on Github.
- Clone the code and follow one of the above guides to setup a dev environment.
- Create a new git branch and make your changes.
- Make sure the tests still pass by running
bundle exec rspec
. - Add tests if you introduced new functionality.
- Commit your changes. Try to make your commit message informative, but we're not sticklers about it. Do try to to add
Closes #issue
orFixes #issue
somewhere in your message if it's addressing a specific open issue. - Submit a Pull Request
- Wait for feedback or a merge!
Your Pull Request will run on travis-ci, and we'll probably wait for it to pass on MRI Ruby 2.3. For more information, see the wiki.
Copyright 2014-2016 by the Zooniverse
Distributed under the Apache Public License v2. See LICENSE