From 520240ff86eb4733c59739a4d51c3c06239fb38b Mon Sep 17 00:00:00 2001 From: Philip Durbin Date: Tue, 5 Nov 2019 14:52:59 -0500 Subject: [PATCH] explain how developers can run the API test suite on EC2 --- .../source/developers/testing.rst | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/doc/sphinx-guides/source/developers/testing.rst b/doc/sphinx-guides/source/developers/testing.rst index fc3910ac36a..88cf415ec31 100755 --- a/doc/sphinx-guides/source/developers/testing.rst +++ b/doc/sphinx-guides/source/developers/testing.rst @@ -105,6 +105,26 @@ Unfortunately, the term "integration tests" can mean different things to differe - Integration tests operate on an installation of Dataverse that is running and able to talk to both PostgreSQL and Solr. - Integration tests are written using REST Assured. +Running the Full API Test Suite Using EC2 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To run the API test suite on EC2 you should first follow the steps in the :doc:`deployment` section to get set up for AWS in general and EC2 in particular. + +Then read the instructions in https://github.com/IQSS/dataverse-sample-data for EC2 but be sure to make the adjustments below. + +Edit ``ec2config.yaml`` to change ``test_suite`` to ``true``. + +Pass in the repo and branch you are testing. You should also specify a local directory where server.log and other useful information will be written so you can start debugging any failures. + +.. code-block:: bash + + export REPO=https://github.com/IQSS/dataverse.git + export BRANCH=123-my-branch + export LOGS=/tmp/123 + + mkdir $LOGS + ./ec2-create-instance.sh -g ec2config.yaml -r $REPO -b $BRANCH -l $LOGS + Running the full API test suite using Docker ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~