diff options
author | Matt Rendina <rendinam@users.noreply.github.com> | 2019-03-21 17:16:09 -0400 |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-03-21 17:16:09 -0400 |
commit | d9d2b53ce76d4654f70766acb846c1b3baf5588a (patch) | |
tree | d8370d072c757523b38d93c91c2ce1eda4f7607c | |
parent | 362ed861198e0ff15bbf4df8e5c048ca20e975b4 (diff) | |
download | jscu_refactor-d9d2b53ce76d4654f70766acb846c1b3baf5588a.tar.gz |
Document credentials injection capability (#43)1.3.11
* Document credentials injection capability
* Update README.md
-rw-r--r-- | README.md | 1 |
1 files changed, 1 insertions, 0 deletions
@@ -93,6 +93,7 @@ It has the following properties: | `post_test_summary` | boolean | no | When `true`, will cause the creation of a Github issue on the project's repository containing a summary of test results produced by all build configurations hosted in the the job if any tests returned a `failure` or `error` status. Default is false, meaning no summary issues will be created upon test failures or errors. When set to `true`, if no test failures or errors occur, a summary post will not be generated. Default value when not specified or no jobconfig object passed to `run()`: `false` | | `enable_env_publication` | boolean | no | When `true`, and when conda is used during the job (for instance when a `conda_packages` list is provided in a build config), every build configuration (See BuildConfig Class below) that produces an XML test report with no test failures will also publish a list of the environment's packages to an Artifactory repository defined in either a `setup.cfg [tool:pytest]` section _OR_ in a `pytest.ini` file (but not both) using the `results_root` configuration value. i.e. `results_root = <artifactory destination repo>` The environment list file produced is the result of the command `conda list --explicit` from within the active environment and will be named `conda_env_dump_<value of buildconfig.name>.txt`. Note: the Artifactory repository specified must be configured to allow files to be published there. Default value when not specified or no jobconfig object passed to `run()`: `false` | | `publish_env_on_success_only` | boolean | no | When `enable_env_publication` is set to true, a `false` value for this option will publish a package list of any conda environments that are used in each build configuration, even if the test results contain failures. Default value when not specified or no jobconfig object passed to `run()`: `true` | +| `credentials` | list of strings | no | If string-type credentials have been added to Jenkins's internal credentials store in a scope available to the job in question, adding the credential ID value(s) here in a comma separated list of strings will cause the value of each credential item to be injected into the runtime environment of each build configuration hosted by the job as an environment variable with the same name as the credential ID. | #### Test Summary Issue Posts If test summaries are requested using the `post_test_summary` property of the JobConfig class as described above, each Jenkins job that produces one or more test errors or failures will result in a single new Github issue being posted to the project's repository. |