Avalon Media System is an open source system for managing large collections of digital audio and video. The project is led by the libraries of Indiana University and Northwestern University with funding in part from the Institute of Museum and Library Services and the Andrew W. Mellon Foundation.
For more information and regular project updates visit the Avalon blog.
Docker provides an alternative way of setting up an Avalon Media System Development Environment in minutes without installing any dependencies beside Docker itself. It should be noted that the docker-compose.yml provided here is for development only and will be updated continually.
- Install Docker and docker-compose
git clone https://github.com/samvera-labs/avalon-bundlecd avalon-bundledocker-compose pulldocker-compose up avalon
Avalon is served by Puma in development mode so any changes will be picked up automatically.
Rails debugging with Pry can be accessed by attaching to the docker container: docker attach avalon_container_name. Now, when you reach a binding.pry breakpoint in rails, you can step through the breakpoint in that newly attached session.
To get live compilation and hot-reload when developing with Javascript, run WEBPACKER_DEV_SERVER_HOST=0.0.0.0 $NODE_PATH/.bin/webpack-dev-server --config /home/app/avalon/config/webpack/development.js inside the avalon container.
To run tests, first bring up the test stack then run Rspec as usual:
docker-compose up test.docker-compose exec test bash -c "bundle exec rspec".
bundle install
yarn install
rails db:migrate
rails hydra:server
bundle install
yarn install
bundle exec rails db:migrate
If you don't have Redis server running automatically on your machine at start up, start it manually:
redis-server`
Start Solr and Fedora manually:
solr_wrapper
fcrepo_wrapper
Configure an admin set, so that you can do things like add a new Work:
rails hyrax:default_admin_set:create
Configure fits; see instructions here, specifically list item #4: https://github.com/samvera/hyrax/wiki/Configuring-an-OS-X-Samvera-Dev-Environment#configuring-hyrax
Start the application:
bundle exec rails s
By default it will run on port :3000. If you have a port conflict in your local dev / bash environment, you can specify a port directly, ie:
bundle exec rails s -p 3333
Visit http://localhost:3000/ and make sure the application loads.
Sign up a new user:
username: [email protected]
password: archivist1