ArchivesSpace build system
Running the build system
To run the build system, use the
build/run script from your
ArchivesSpace project directory. This will display a list of all
available build tasks. This document describes a few of the important
The bootstrap task:
Will bootstrap your development environment by downloading all dependencies–JRuby, Gems, Solr, etc..
Running a development environment
To run a development instance of all ArchivesSpace components:
build/run backend:devserver build/run frontend:devserver build/run public:devserver build/run indexer
These should be run in different terminal sessions and do not need to be run in a specific order or are all required.
For added convenience see: [Supervisord for Development(https://archivesspace.github.io/archivesspace/user/using-supervisord-for-development/) for a simpler way of running the development servers with output for all servers sent to a single terminal window.
You can also clear your database and search indexes with:
To override configuration defaults create the file
and set values as needed (restart the development servers). To use MySQL
for development you can set the
common/config/config.rb or set
aspace.config.db_url property of
See the setup instructions for initializing the database.
The MySQL connector should be downloaded to
common/lib. If you restore a
database to use in development it may not play well with the tests.
Running the tests
ArchivesSpace uses a combination of RSpec, integration and Selenium tests. You will need to have Firefox on your path. Then, to run all tests:
See also: Selenium Test Suite for more information on the Selenium tests.
It’s also useful to be able to run the backend unit tests separately. To do this, run:
You can also run a single spec file with:
build/run backend:test -Dspec="myfile_spec.rb"
or a single example with:
build/run backend:test -Dexample="does something important"
You can run the coverage reports using:
This runs all of the above tests in coverage mode and, when the run
finishes, produces a set of HTML reports within the
directory in your ArchivesSpace project directory.
Building a distribution
See: Building an Archivesspace Release for information on building a distribution.
Generating API documentation
See: Building an Archivesspace Release for information on building the documentation.