Bruin Bear (statue) In 1984 to mark its 50th Anniversary, the UCLA Alumni Association commissioned "Mighty Bruins" and presented the Bruin Bear Statue to the university. The statue is now a campus landmark and a focal point in Westwood Plaza.
This section gives basic instructions to get Ursus running locally. More extensive developer documentation is maintained in the wiki.
Ursus is a Blacklight application and only needs Solr and Fedora.
Ursus can run locally in two ways:
- Stand alone mode
- In conjunction with local instance of Californica
The file docker-compose-standalone.yml
includes a setup with a clone of the ursus-stage and sinai-stage solr indexes, so you do not need to run californica and manually ingest material (in fact, californica should #not# be running to avoid port conflicts.)
git clone git@github.com:UCLALibrary/ursus.git
cd ursus
docker-compose run web bundle exec rails db:setup
** Do this after setting up the databases** - the startup scripts require the database to be ready so that they can set feature flags e.g. for the Sinai UI mode.
docker-compose up
- Ursus / UCLA Library Digital Collections UI is enabled on port 3003
Connect to a shell inside the container with:
docker-compose run web bash
Then run the entire suite, except for the cypress integration test, with:
sh start-ci.sh
You can inspect the start-ci.sh
script to see which linters and tests this invokes.
Or individually:
- root@ursus:/ursus# bundle exec erblint --lint-all
- root@ursus:/ursus# yarn run lint
- root@ursus:/ursus# rubocop
First, you will need to install node.js and npm locally.
Then cd into the e2e
directory and install the javascript dependencies:
cd e2e
npm install
Next, you can either open the cypress test runner GUI with:
npx cypress open
or run the tests in the command line:
npx cypress run
Visual regression testing is done via percy.io. This runs only for pull requests on travis; it will not run locally.
If you need to rebuild the docker image (for example, if packages were added to the Gemfile), run:
docker-compose pull
docker-compose up --build