Pipeline stage to test that AM's FBC (file-based config) can be upgraded (and then used with AM successfully) after every commit. This stage will fail if required openam-config-upgrader rules are missing from fbc/master.groovy.
Deployments of (file-based) AM require an upgrade mechanism. The openam-config-upgrader (released within the AM.zip) can upgrade the FBC configuration files. To ensure that the upgrader rules are kept up to date the fbc-config-upgrader-tests stage has been added to the postCommit pipeline. The premise is that a known baseline FBC can be upgraded, using the tool and rules, and then used to successfully start up the latest version of AM. The rules should be idempotent; so running multiple times will produce the same end result.
The test has its own deployer UpgradedFBCAmDeployer which can be called by the Tests' CLI. The AM-7.0.0 baseline configuration is in the OpenAM git repository along with scripts to generate a new configuration if/when required. At the time of writing there is one upgrade rule to set the configuration version.
- Start with a known set of configuration at a fixed version. (It is possible a new baseline will be required from time to time e.g. new major release)
- Run the upgrader with the "master" set of rules
- Start AM with the upgraded configuration
- Verify that AM has started correctly
Because this test implementation relies on a static known FBC the setup can be quite brittle. The baseline FBC does make use of some placeholders however there are a some significant hard coded values. Please refer to baseline configuration generation scripts and resources for its definitive status. The significant values are:
|Significant hard coded values ^|
- TODO: Update the links in this page, from the fbc_deployer branch, to master once the code is merged with master.TODO: Move to mandatory test section
Jira server ForgeRock JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 45b4e541-fe03-30e2-b999-cf4e643b93ec key AME-19111 Jira server ForgeRock JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 45b4e541-fe03-30e2-b999-cf4e643b93ec key AME-19254 Jira server ForgeRock JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 45b4e541-fe03-30e2-b999-cf4e643b93ec key AME-19294