mirror of
https://github.com/SAP/jenkins-library.git
synced 2024-12-12 10:55:20 +02:00
b219fb6514
* fix typos in step yamls * fix typos in go files * regenerate step code * fix typos in md files * fix typos in groovy files * fix further typos
148 lines
6.3 KiB
Groovy
148 lines
6.3 KiB
Groovy
import com.sap.piper.ConfigurationHelper
|
|
import com.sap.piper.GenerateDocumentation
|
|
import com.sap.piper.GitUtils
|
|
import com.sap.piper.Utils
|
|
|
|
import groovy.text.GStringTemplateEngine
|
|
import groovy.transform.Field
|
|
|
|
import static com.sap.piper.Prerequisites.checkScript
|
|
|
|
@Field String STEP_NAME = getClass().getName()
|
|
|
|
@Field Set GENERAL_CONFIG_KEYS = [
|
|
/** @see seleniumExecuteTests */
|
|
'gitSshKeyCredentialsId'
|
|
]
|
|
@Field Set STEP_CONFIG_KEYS = GENERAL_CONFIG_KEYS.plus([
|
|
/** @see dockerExecute */
|
|
'dockerEnvVars',
|
|
/** @see dockerExecute */
|
|
'dockerImage',
|
|
/** @see dockerExecute */
|
|
'dockerWorkspace',
|
|
/**
|
|
* With `failOnError` the behavior in case tests fail can be defined.
|
|
* @possibleValues `true`, `false`
|
|
*/
|
|
'failOnError',
|
|
/** @see seleniumExecuteTests */
|
|
'gitBranch',
|
|
/**
|
|
* The command that is executed to install the test tool.
|
|
*/
|
|
'installCommand',
|
|
/**
|
|
* The command that is executed to start the tests.
|
|
*/
|
|
'runCommand',
|
|
/**
|
|
* The host of the selenium hub, this is set automatically to `localhost` in a Kubernetes environment (determined by the `ON_K8S` environment variable) of to `selenium` in any other case. The value is only needed for the `runCommand`.
|
|
*/
|
|
'seleniumHost',
|
|
/** @see seleniumExecuteTests */
|
|
'seleniumHubCredentialsId',
|
|
/**
|
|
* The port of the selenium hub. The value is only needed for the `runCommand`.
|
|
*/
|
|
'seleniumPort',
|
|
/** @see dockerExecute */
|
|
'sidecarEnvVars',
|
|
/** @see dockerExecute */
|
|
'sidecarImage',
|
|
/** @see dockerExecute */
|
|
'stashContent',
|
|
/**
|
|
* This allows to set specific options for the UIVeri5 execution. Details can be found [in the UIVeri5 documentation](https://github.com/SAP/ui5-uiveri5/blob/master/docs/config/config.md#configuration).
|
|
*/
|
|
'testOptions',
|
|
/** @see seleniumExecuteTests */
|
|
'testRepository',
|
|
/**
|
|
* The `testServerUrl` is passed as environment variable `TARGET_SERVER_URL` to the test execution.
|
|
* The tests should read the host information from this environment variable in order to be infrastructure agnostic.
|
|
*/
|
|
'testServerUrl'
|
|
])
|
|
@Field Set PARAMETER_KEYS = STEP_CONFIG_KEYS
|
|
|
|
/**
|
|
* With this step [UIVeri5](https://github.com/SAP/ui5-uiveri5) tests can be executed.
|
|
*
|
|
* UIVeri5 describes following benefits on its GitHub page:
|
|
*
|
|
* * Automatic synchronization with UI5 app rendering so there is no need to add waits and sleeps to your test. Tests are reliable by design.
|
|
* * Tests are written in synchronous manner, no callbacks, no promise chaining so are really simple to write and maintain.
|
|
* * Full power of webdriverjs, protractor and jasmine - deferred selectors, custom matchers, custom locators.
|
|
* * Control locators (OPA5 declarative matchers) allow locating and interacting with UI5 controls.
|
|
* * Does not depend on testability support in applications - works with autorefreshing views, resizing elements, animated transitions.
|
|
* * Declarative authentications - authentication flow over OAuth2 providers, etc.
|
|
* * Console operation, CI ready, fully configurable, no need for java (coming soon) or IDE.
|
|
* * Covers full ui5 browser matrix - Chrome,Firefox,IE,Edge,Safari,iOS,Android.
|
|
* * Open-source, modify to suite your specific neeeds.
|
|
*
|
|
* !!! note "Browser Matrix"
|
|
* With this step and the underlying Docker image ([selenium/standalone-chrome](https://github.com/SeleniumHQ/docker-selenium/tree/master/StandaloneChrome)) only Chrome tests are possible.
|
|
*
|
|
* Testing of further browsers can be done with using a custom Docker image.
|
|
*/
|
|
@GenerateDocumentation
|
|
void call(Map parameters = [:]) {
|
|
handlePipelineStepErrors (stepName: STEP_NAME, stepParameters: parameters) {
|
|
def script = checkScript(this, parameters) ?: this
|
|
def utils = parameters.juStabUtils ?: new Utils()
|
|
String stageName = parameters.stageName ?: env.STAGE_NAME
|
|
|
|
// load default & individual configuration
|
|
Map config = ConfigurationHelper.newInstance(this)
|
|
.loadStepDefaults([:], stageName)
|
|
.mixinGeneralConfig(script.commonPipelineEnvironment, GENERAL_CONFIG_KEYS)
|
|
.mixinStepConfig(script.commonPipelineEnvironment, STEP_CONFIG_KEYS)
|
|
.mixinStageConfig(script.commonPipelineEnvironment, stageName, STEP_CONFIG_KEYS)
|
|
.mixin(parameters, PARAMETER_KEYS)
|
|
.addIfEmpty('seleniumHost', isKubernetes()?'localhost':'selenium')
|
|
.use()
|
|
|
|
utils.pushToSWA([
|
|
step: STEP_NAME,
|
|
stepParamKey1: 'scriptMissing',
|
|
stepParam1: parameters?.script == null
|
|
], config)
|
|
|
|
config.stashContent = config.testRepository ? [GitUtils.handleTestRepository(this, config)] : utils.unstashAll(config.stashContent)
|
|
config.installCommand = GStringTemplateEngine.newInstance().createTemplate(config.installCommand).make([config: config]).toString()
|
|
config.runCommand = GStringTemplateEngine.newInstance().createTemplate(config.runCommand).make([config: config]).toString()
|
|
config.dockerEnvVars.TARGET_SERVER_URL = config.dockerEnvVars.TARGET_SERVER_URL ?: config.testServerUrl
|
|
|
|
seleniumExecuteTests(
|
|
script: script,
|
|
buildTool: 'npm',
|
|
dockerEnvVars: config.dockerEnvVars,
|
|
dockerImage: config.dockerImage,
|
|
dockerName: config.dockerName,
|
|
dockerWorkspace: config.dockerWorkspace,
|
|
seleniumHubCredentialsId: config.seleniumHubCredentialsId,
|
|
sidecarEnvVars: config.sidecarEnvVars,
|
|
sidecarImage: config.sidecarImage,
|
|
stashContent: config.stashContent
|
|
) {
|
|
sh returnStatus: true, script: """
|
|
node --version
|
|
npm --version
|
|
"""
|
|
try {
|
|
sh "NPM_CONFIG_PREFIX=~/.npm-global ${config.installCommand}"
|
|
sh "PATH=\$PATH:~/.npm-global/bin ${config.runCommand} ${config.testOptions}"
|
|
} catch (err) {
|
|
echo "[${STEP_NAME}] Test execution failed"
|
|
script.currentBuild.result = 'UNSTABLE'
|
|
if (config.failOnError) error "[${STEP_NAME}] ERROR: The execution of the uiveri5 tests failed, see the log for details."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
boolean isKubernetes() {
|
|
return Boolean.valueOf(env.ON_K8S)
|
|
}
|