First things first, you'll need to fork and clone the repository to your local machine.
git clone https://github.com/ecosyste-ms/repos.git
The project uses ruby on rails which have a number of system dependencies you'll need to install.
Once you've got all of those installed, from the root directory of the project run the following commands:
bundle install
bundle exec rake db:create
bundle exec rake db:migrate
rails server
You can then load up http://localhost:3000 to access the service.
Alternatively you can use the existing docker configuration files to run the app in a container.
Run this command from the root directory of the project to start the service.
docker-compose up --build
You can then load up http://localhost:3000 to access the service.
For access the rails console use the following command:
docker-compose exec app rails console
TODO
The applications tests can be found in test and use the testing framework minitest.
You can run all the tests with:
rails test
The applications rake tasks can be found in lib/tasks.
You can list all of the available rake tasks with the following command:
rake -T
Background tasks are handled by sidekiq, the workers live in app/sidekiq.
To process the tasks run the following command:
bundle exec sidekiq
You can also view the status of the workers and their queues from the web interface http://localhost:3000/sidekiq
TODO
A container-based deployment is highly recommended, we use dokku.com.
This service uses a number of other ecosyste.ms services, you can use alternative domains for these services by setting the following environment variables:
- PARSER_DOMAIN (default: https://parser.ecosyste.ms)
- ARCHIVES_DOMAIN (default: https://archives.ecosyste.ms)
- TIMELINE_DOMAIN (default: https://timeline.ecosyste.ms)
- COMMITS_DOMAIN (default: https://commits.ecosyste.ms)
- PACKAGES_DOMAIN (default: https://packages.ecosyste.ms)