diff options
author | Edan Binshtok <eb578m@intl.att.com> | 2017-10-04 09:33:23 +0300 |
---|---|---|
committer | Edan Binshtok <eb578m@intl.att.com> | 2017-10-04 09:36:04 +0300 |
commit | f8907f0c4fc0ba4bb97a1d636a50c5b40c2642f2 (patch) | |
tree | 3d04d86910c93e42c055e5ed699ab1919482d5be /README.md | |
parent | 733e00df0a6fa19dd92ec7392966340345dd1885 (diff) |
Initial seed
Initial upload of django test framework
Change-Id: I643a7f4efc52cfafe4cc6d92e3178f36a0c1837c
Issue-Id: VVP-1
Signed-off-by: Edan Binshtok <eb578m@intl.att.com>
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..3fdb9fb --- /dev/null +++ b/README.md @@ -0,0 +1,68 @@ +# ICE CI Container (Automat Testing): +In order to run the container, follow the below steps: + + +## DataBase: +The CI container uses internal `Sqlite` database. +It creates its own database tables in order to store the tests results. +The CI Container needs also the main ICE database configuration (see below). + +## Environment: +The CI container requires the following Environment variables: + + >#### General + >* DJANGO_SETTINGS_MODULE=settings + >* PYTHONPATH=/app + >* DISPLAY=:99 + +>#### ICE-CI Database Settings +>* CI_DB_NAME=ice_ci_db +>* CI_DB_USER=iceci + +>#### ICE-EM Database Settings +>* ICE_DB_NAME=icedb +>* ICE_DB_USER=_\<ice db user name\>_ +>* ICE_DB_PASSWORD=_\<ice db user password\>_ +>* ICE_DB_HOST=_<ice db host name>_ +>* ICE_DB_PORT=5432 + +>#### ICE-CI Contact Mail Settings for sending results report +>* NUMBER_OF_TEST_RESULTS=30 + +>#### Mail setting +>* ICE_CI_ENVIRONMENT_NAME=Staging +>* ICE_EMAIL_HOST=_\<email host name\>_ +>* ICE_CONTACT_FROM_ADDRESS=noreply-ci@d2ice.att.io + +>#### Recipients for CI report +>* ICE_CONTACT_EMAILS=_'\<user mail\>, \<…\> '_ + +>#### URL of ICE portal (used by Selenium) +>* ICE_PORTAL_URL=_\<url of ice portal\>_ (e.g: http://development.d2ice.att.io/) + +## DB Migration: +Migrations should be run in the standard way + +## Test Execution: +In order to invoke the test session, run the following ansible playbook. +It will run the tests and record their results inside the CI dedicated database. +``` +$ ansible-playbook scripts/playbooks/run_ci_test.yml --extra-vars='test_num=<id_number>' +``` + +## Report Only: +Run the command using the additional tag "ci_report": +``` +$ ansible-playbook scripts/playbooks/run_ci_test.yml --extra-vars='test_num=<id_number>' --tags ci_report +``` + +## Trigger Sending Test Report to mail recipients: +``` + GET http://<ci-django-app-host-and-port>/ice-ci/v1/testresultstomail/<identification-number> +``` + \<identification-number\> means an arbitrary identifier for the generated report mail. + + + + + |