Frontend Developer Manual / Version 2107
Table Of ContentsThe code examples Example 5.10, “Job DSL description of theme import” and Example 5.11, “Jenkinsfile description of theme import” describe the following tasks required for the theme import:
Check out the head of the configured branch of your SCM, here Git. If you use the Blueprint repository to develop themes, you have to accept the caveat, that each commit on the whole repository will trigger an import. If you cannot accept this, you can still switch to a manual trigger or cron based trigger or use the separate Frontend Developer workspace.
Build the themes and the theme importer.
Run the
import-themescommand line client against your running development system.
The code example also use some best practices and formatting compromises:
It is a good practice to checkout to a subdirectory instead of the workspace root. The reason for this configuration is to keep the Maven repository separated from the SCM directory and keep it between builds using clean checkouts.
By disabling concurrent builds, two theme importer runs will not interfere with each other.
To keep lines short, the paths to the command line client and the folder with the packaged themes are referenced using
THEME_IMPORTER_DIR=${WORKSPACE}/apps/studio-server/modules/cmd-tools/theme-importer-application/target/theme-importerandTHEMES_DIR=${WORKSPACE}/frontend/target/themes.Some basic configurations like build and log retention as well as useful additional configurations like build log time stamping and coloring are kept out for conciseness reasons but you should always configure them.
To import themes you need to provide the IOR URL and the credentials to the command line client. If you do not want plain credentials in the Jenkins jobs, you can also use the credentials plugin and inject them into the build. Please refer to the corresponding documentation for either Job DSL or Jenkinsfile.
