X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=blobdiff_plain;f=docs%2Fjjb%2Flf-macros.rst;h=ce7ac0d246bfdd33d988387c4eff12a60da3d64d;hb=603bc6bed1996d666f34ec88b06d9c3dfc69d090;hp=1ab522cb3430f6ed250c24b21a16cc2f6706bb65;hpb=bbaf6b55269a0cb6fb129af73d82c2efd6d83bcf;p=releng%2Fglobal-jjb.git diff --git a/docs/jjb/lf-macros.rst b/docs/jjb/lf-macros.rst index 1ab522cb..ce7ac0d2 100644 --- a/docs/jjb/lf-macros.rst +++ b/docs/jjb/lf-macros.rst @@ -95,11 +95,29 @@ lf-infra-gpg-verify-git-signature Verify gpg signature of the latest commit message in $WORKSPACE. This command assumes that $WORKSPACE is a git repo. +lf-infra-pre-build +------------------ + +Macro that runs before all builders to prepare the system for job use. + +lf-infra-package-listing +------------------------ + +Lists distro level packages. + lf-infra-packer-build --------------------- Run `packer build` to build system images. +:Required parameters: + + :openstack: Packer template uses an OpenStack builder (true|false). + :openstack-cloud: Sets OS_CLOUD variable to the value of this parameter. + :packer-version: Version of packer to use. + :platform: Build platform as found in the vars directory. + :template: Packer template to build as found in the templates directory. + lf-infra-packer-validate ------------------------ @@ -187,6 +205,17 @@ lf-rtd-verify ReadTheDocs verify script. +lf-sigul-sign-dir +----------------- + +Use Sigul to sign a directory via {sign-dir}. + +Requires ``SIGUL_BRIDGE_IP`` configured as a global envvar. + +:Required Parameters: + :sign-artifacts: Whether or not to sign artifacts with Sigul. + :sign-dir: Directory to sign. + lf-infra-provide-docker-cleanup ------------------------------- @@ -195,12 +224,34 @@ Forcibly removes all of the docker images. Parameters ========== +lf-clm-parameters +------------------- + +Provides the policy evaluation stage to run against Nexus IQ Server. +Valid values include: 'build', 'stage-release', 'operate'. + +lf-cmake-parameters +------------------- + +Provides parameters needed by CMake. Should be used by any jobs that need to +call the ``cmake && make && make install`` pattern. + lf-infra-maven-parameters ------------------------- Provides parameters needed by Maven. Should be used by any jobs that need to call the mvn cli. +lf-infra-openstack-parameters +----------------------------- + +Provides parameters needed by OpenStack client CLI. Use in jobs that need to +call the openstack cli. + +:Required Parameters: + + :os-cloud: Configures ``OS_CLOUD`` envvar as used by openstack cli. + lf-infra-parameters ------------------- @@ -244,6 +295,18 @@ Provides basic lf-infra recommended publisher configurations which should be used in all job templates. This primary objective of this trigger is to gather build logs and copy them to a log server. +lf-stack-delete +--------------- + +Requirements: + +* lftools >= v0.17.0 + +Delete an openstack heat stack. Use at the end of a job that creates a stack. + +This macro requires a parameter defined in the job named STACK_NAME +containing the name of the stack to delete. + SCM ===