X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=blobdiff_plain;f=docs%2Fjjb%2Flf-macros.rst;h=8a4fb0c159d77c880f19b7bbfdffceffe9754172;hb=f0dae8046088b145652b9da6a15068b8c99ced6c;hp=72d898c6e1cd002e65c3fb51aab993dadeb51dd5;hpb=00c55b34e2528da665e08cc773c1af94984de115;p=releng%2Fglobal-jjb.git diff --git a/docs/jjb/lf-macros.rst b/docs/jjb/lf-macros.rst index 72d898c6..8a4fb0c1 100644 --- a/docs/jjb/lf-macros.rst +++ b/docs/jjb/lf-macros.rst @@ -16,6 +16,26 @@ called DEPENDENCY_BUILD_ORDER which can be used if necessary to build projects in the specified order. The order is determined by first patch instance for a project in the patch list. +lf-license-check +---------------- + +Checks files for + +:Required parameters: + + :file-patterns: Space-separated list of file patterns to scan. + For example: \*.go \*.groovy \*.java \*.py \*.sh + :spdx-disable: Disable the SPDX-Identifier checker. + :lhc-version: Version of LHC to use. + :license-exclude-paths: Comma-separated list of paths to exclude from the + license checker. The paths used here will be matched using a contains + rule so it is best to be as precise with the path as possible. + For example a path of '/src/generated/' will be searched as + '**/src/generated/**'. + Example: org/opendaylight/yang/gen,protobuff/messages + :licenses-allowed: Comma-separated list of allowed licenses. + For example: Apache-2.0,EPL-1.0,MIT + lf-infra-create-netrc --------------------- @@ -25,6 +45,13 @@ Create a ~/.netrc file from a Maven settings.xml :server-id: The id of a server as defined in settings.xml. +:Optional parameters: + + :ALT_NEXUS_SERVER: URL of custom nexus server. + If set this will take precedence. + Use this to point at nexus3.$PROJECTDOMAIN + for example. + lf-infra-deploy-maven-file -------------------------- @@ -68,6 +95,11 @@ 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-package-listing +------------------------ + +Lists distro level packages. + lf-infra-packer-build --------------------- @@ -84,6 +116,24 @@ Run `packer validate` to verify packer configuration. server as CLOUDENV environment variable. :packer-version: Version of packer to use. +lf-infra-push-gerrit-patch +-------------------------- + +Push a change through a Jenkins job to a Gerrit repository in an automated +way using git-review. + +:Required parameters: + + :gerrit-commit-message: Commit message to assign. + :gerrit-host: Gerrit hostname. + :gerrit-topic: Gerrit topic. + :gerrit-user: Gerrit user-id used for submitting the change. + :reviewers-email: Reviewers email. Space-separated list of + email addresses to CC on the patch. + :project: Gerrit project name. + +.. _lf-infra-ship-logs: + lf-infra-ship-logs ------------------ @@ -132,6 +182,27 @@ Cleanup maven settings.xml configuration. This should be called at the end of any macros that calles the :ref:`lf-provide-maven-settings ` macro. +.. _provide-sigul-config: + +lf-provide-sigul-configuration +------------------------------ + +Provides sigual configuration to the Jenkins build node. + +Requires the following Config File Provider managed files in Jenkins +preconfigured. + +* sigul-config +* sigul-password +* sigul-pki + +.. _provide-sigul-config-cleanup: + +lf-provide-sigul-configuration-cleanup +-------------------------------------- + +Cleanup configuration provided by `provide-sigul-config`. + lf-rtd-trigger-build -------------------- @@ -142,15 +213,43 @@ lf-rtd-verify ReadTheDocs verify script. +lf-sigul-install +---------------- + +Install Sigul. + +Requires ``SIGUL_BRIDGE_IP`` configured as a global envvar. + +lf-infra-provide-docker-cleanup +------------------------------- + +Forcibly removes all of the docker images. + Parameters ========== +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 ------------------- @@ -211,14 +310,6 @@ On the `branch` variable you can assign `$sha1` or `$ghprbActualCommit` as the value. This will require that the job be triggered via the GHPRB plugin and not manually. -Triggers -======== - -lf-infra-github-pr-trigger --------------------------- - -Provides configuration for a GitHub PR Trigger. - Wrappers ========