WS Copy Policy
Project description
MEND copy policy tool
The script allows copying policies automatically, from the template project/product to the newly created projects/products, and update existing projects with the template policy. It should run periodically, in order to make sure that all the policies under the required projects/products are up to date.
How to use the script
- Create an empty project/product or few with the required template policy.
- Tag an empty project/product with the following project tag:
key=Policy.Template.Source, value=<yourUniqueTemplateName>
. - For a new project/product creation that requires the template policy, add the following project/product tag:
key=Policy.Template.Destination, value=<yourUniqueTemplateName>
. It can be added via the UI or as part of the Unified Agent run. - The template policy will be updated for the required projects/products.
Note: Make sure that the tag
Policy.Template.Source
value is unique and is presented only in one project/product.
What does the script do?
For each project/product in the system, the script extracts the Tag key called: Policy.Template.Source
, and the tag key called Policy.Template.Destination
.
In the event, the tag value of the project/product with Policy.Template.Source
tag key equals the tag value of the project/product with Policy.Template.Destination
tag key, the script will do the following:
- Delete the existing policies from the project/product with
Policy.Template.Destination
tag key. - Copy the project/product policies of the project/product with
Policy.Template.Source
tag key to the project/product withPolicy.Template.Destination
tag key.
Supported Operating Systems
- Linux (Bash): CentOS, Debian, Ubuntu, RedHat
- Windows (PowerShell): 10, 2012, 2016
Prerequisites
- Python 3.9 or above
Installation and Execution by pulling package from PyPi:
- Execute
pip install ws-copy-policy
- Note: If installing packages as a non-root be sure to include the path to the executables within the Operating System paths.
- Run report:
ws-copy-policy --wssURL <URL> --userKey <USER_KEY> --apiKey <ORG_TOKEN> --scope <COPY_SCOPE> --thread <THREAD_NUMBER>
orws-copy-policy <CONFIG_FILE_PATH>
- Note: If installing packages as a non-root be sure to include the path to the executables within the Operating System paths.
Configuration Parameters
===============================================================================================================
| Group | Parameter | Description |
===============================================================================================================
| DEFAULT | wssUrl | Mend server URL. Can be found under the 'Integrate' tab in |
| | | your Mend organization under Server URL: |
| | | https://<domain>.whitesourcesoftware.com |
---------------------------------------------------------------------------------------------------------------
| DEFAULT | userKey | Mend User Key. Can be found under the 'Profile' section in |
| | | your Mend organization. |
---------------------------------------------------------------------------------------------------------------
| DEFAULT | apiKey | Mend API Key. Can be found under the 'Integrate' tab in your |
| | | your Mend organization. |
---------------------------------------------------------------------------------------------------------------
| DEFAULT | scope | The scope where the copying policies should be performed on. |
| | | Possible values: project/product. |
---------------------------------------------------------------------------------------------------------------
| DEFAULT | thread | Multi-threading - speeds up the copying, but it depends |
| | | on your environment capabilities (default: 5). |
===============================================================================================================
Author
Mend.io ©
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for ws_copy_policy-23.1.5.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ab5f9c7bbc9b29c4c5d8798498357beca4086b7b51af787acbe050072fe40f8a |
|
MD5 | fdde636ff2d491163028f92cde65865d |
|
BLAKE2b-256 | eda430b7e525c281c54285fe152fc6a66f3582839266514cb703a95b74a629ed |