Features¶
Prancer's enterprise edition adds various additional features such as:
- Database storage for configuration files, snapshot configuration files and test reports
- A web interface to manage all this
- Everything is managed in your own infrastructure (On premise)
The difference with the SaSS offering is that you install the enterprise edition on your servers while the SaSS manages it for you on Prancer's infrastructure.
Database storage in the basic edition¶
Database storage is not a locked feature. It exists even in the basic edition but isn't really useful unless you create a large set of tools around it to manage the input and output. This is exactly what the enterprise edition solves by offering a managed web interface that you can install on premise.
If you want to use Prancer in database mode, ensure you have configured the following settings in the [mongodb] section in the projecy configuration file:
| Key | Possible values | Explanation |
|---|---|---|
| SNAPSHOT | string | Name of the collection where snapshot configuration files are stored |
| TEST | string | Name of the collection where test configurations are stored |
| STRUCTURE | string | Name of the collection where connector configurations are stored |
| OUTPUT | string | Name of the collection where test results are stored |
These settings are optional if you use file based storage but necessary when you use the database storage. Each additional collection will receive different documents, you can insert the documents yourself or use the utilities to push file based documents into the database.
Database management utilities¶
Prancer comes with a tool that will help you push your documents to the database. This is particularly useful when migrating to the enterprise edition or if you want to store everything yourself in the MongoDB database without the enterprise edition support.
Notes: Edition differences Note that this tool doesn't come with the
prancer-basicpackage, you need to work with the source version.
For example, to import document you can use:
python3 utilities/populate_json.py lq --file azureApiVersions.json --type structure
python3 utilities/populate_json.py lq --file awsStructure.json --type structure
python3 utilities/populate_json.py lq --file azureStructure.json --type structure
python3 utilities/populate_json.py lq --file azureStructure1.json --type structure
python3 utilities/populate_json.py lq --file parameterStructure.json --type structure
python3 utilities/populate_json.py lq --file parameterStructure1.json --type structure
python3 utilities/populate_json.py lq --file notifications/notifications_slack_wk.json --type notifications
python3 utilities/populate_json.py lq --file notifications/notifications_email_gm.json --type notifications
python3 utilities/populate_json.py lq --file notifications/notifications_email_sg.json --type notifications
python3 utilities/populate_json.py container1 --dir validation/container1
python3 utilities/populate_json.py container3 --dir validation/container3
python3 utilities/populate_json.py container4 --dir validation/container4
python3 utilities/populate_json.py container5 --dir validation/container5
python3 utilities/populate_json.py container6 --dir validation/container6
These are a few examples of how you can use populate_json.py to load the files into the MongoDB database.
Running tests using the database¶
If you want Prancer to run the tests using the database configuration, the only thing you need will be a config.ini on disk and then issue the following:
prancer --db <container-name>
This will run the tool using the database instead of the filesystem.