Add sigul signing to maven-stage job 12/12312/10
authorThanh Ha <thanh.ha@linuxfoundation.org>
Sat, 18 Aug 2018 02:15:07 +0000 (22:15 -0400)
committerThanh Ha <thanh.ha@linuxfoundation.org>
Wed, 12 Sep 2018 00:38:45 +0000 (20:38 -0400)
Refactor the lf-sigul* macros into a new one called lf-sigul-sign-dir
to be used as a one shot macro to sign a directory. Macro initializes
and cleans up after itself so no need to call extra builder steps.

Issue: RELENG-1071
Change-Id: I0ff965c2ef24fa7a44a114445d8a97c3176e575a
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>
docs/jjb/lf-macros.rst
docs/jjb/lf-maven-jobs.rst
jjb/lf-macros.yaml
jjb/lf-maven-jobs.yaml
releasenotes/notes/sigul-signing-f9d7389354ad6b3a.yaml [new file with mode: 0644]
shell/sigul-sign-dir.sh [new file with mode: 0644]

index a57fac5..c6334fd 100644 (file)
@@ -187,27 +187,6 @@ Cleanup maven settings.xml configuration. This should be called at the end of
 any macros that calles the
 :ref:`lf-provide-maven-settings <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
 --------------------
 
@@ -218,13 +197,17 @@ lf-rtd-verify
 
 ReadTheDocs verify script.
 
-lf-sigul-install
-----------------
+lf-sigul-sign-dir
+-----------------
 
-Install Sigul.
+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
 -------------------------------
 
index 74a3e7e..6144e05 100644 (file)
@@ -297,6 +297,7 @@ directory is then used later to deploy to Nexus.
     :mvn-opts: Sets MAVEN_OPTS. (default: '')
     :mvn-params: Additional mvn parameters to pass to the cli. (default: '')
     :mvn-version: Version of maven to use. (default: mvn35)
+    :sign-artifacts: Sign artifacts with Sigul. (default: false)
     :stream: Keyword that can be used to represent a release code-name.
         Often the same as the branch. (default: master)
     :submodule-recursive: Whether to checkout submodules recursively.
index 5188417..2e3a857 100644 (file)
             - file-id: '{settings-file}'
               variable: 'SETTINGS_FILE'
 
-- builder:
-    name: lf-provide-sigul-configuration
-    # Push configuration files to interact with sigul
-    builders:
-      - config-file-provider:
-          files:
-            - file-id: sigul-config
-              variable: SIGUL_CONFIG
-            - file-id: sigul-password
-              variable: SIGUL_PASSWORD
-            - file-id: sigul-pki
-              variable: SIGUL_PKI
-      - shell: !include-raw: ../shell/sigul-configuration.sh
-
 - builder:
     name: lf-pip-install
     builders:
           # DO NOT fail build if any of the above lines fail.
           exit 0
 
-- builder:
-    name: lf-provide-sigul-configuration-cleanup
-    # Clear sigul configuration files after we're done using them
-    builders:
-      - shell: !include-raw: ../shell/sigul-configuration-cleanup.sh
-
 - builder:
     name: lf-rtd-trigger-build
     builders:
           - ../shell/rtd-verify.sh
 
 - builder:
-    name: lf-sigul-install
+    name: lf-sigul-sign-dir
     # Requires that Jenkins be configured with SIGUL_BRIDGE_IP as a global
     # Environment variable
     builders:
-      - shell: !include-raw: ../shell/sigul-install.sh
+      - conditional-step:
+          condition-kind: boolean-expression
+          condition-expression: '{sign-artifacts}'
+          steps:
+            - config-file-provider:
+                files:
+                  - file-id: sigul-config
+                    variable: SIGUL_CONFIG
+                  - file-id: sigul-password
+                    variable: SIGUL_PASSWORD
+                  - file-id: sigul-pki
+                    variable: SIGUL_PKI
+            - shell: !include-raw-escape: ../shell/sigul-configuration.sh
+            - shell: !include-raw-escape: ../shell/sigul-install.sh
+            - inject:
+                properties-content: SIGN_DIR={sign-dir}
+            - shell: !include-raw-escape:
+                - ../shell/common-variables.sh
+                - ../shell/sigul-sign-dir.sh
+            - shell: !include-raw-escape: ../shell/sigul-configuration-cleanup.sh
 
 - builder:
     name: lf-infra-provide-docker-cleanup
index c89ba5b..78ef2f6 100644 (file)
     mvn-opts: ''
     mvn-params: ''
     mvn-version: mvn35
+    sign-artifacts: false
     stream: master
     submodule-recursive: true
 
           - ../shell/maven-patch-release.sh
       - lf-maven-build:
           mvn-goals: '{mvn-goals}'
+      - lf-sigul-sign-dir:
+          sign-artifacts: '{sign-artifacts}'
+          sign-dir: '$WORKSPACE/m2repo'
       - lf-maven-stage
       - lf-provide-maven-settings-cleanup
 
diff --git a/releasenotes/notes/sigul-signing-f9d7389354ad6b3a.yaml b/releasenotes/notes/sigul-signing-f9d7389354ad6b3a.yaml
new file mode 100644 (file)
index 0000000..560ab30
--- /dev/null
@@ -0,0 +1,38 @@
+---
+features:
+  - |
+    New macro ``lf-sigul-sign-dir`` available to sign artifacts in a provided
+    directory using Sigul.
+
+    Usage:
+
+    .. code-block:: yaml
+
+       - lf-sigul-sign-dir:
+           sign-dir: '$WORKSPACE/m2repo'
+
+    This macro also requires a boolean variable to ``SIGN_ARTIFACTS`` to be set
+    to true to activate the macro. We recommend the job-template that uses
+    this macro to define it in the job parameters section.
+
+    Example:
+
+    .. code-block:: yaml
+
+       - bool:
+           name: SIGN_ARTIFACTS
+           default: '{sign-artifacts}'
+           description: Use Sigul to sign artifacts.
+
+  - |
+    Add Sigul signing support to the maven-staging job. To activate Sigul
+    signing make sure to set ``sign-artifacts: true``. Example:
+
+    .. code-block:: yaml
+
+       - project:
+           name: abc
+           jobs:
+             - gerrit-maven-stage
+
+           sign-artifacts: true
diff --git a/shell/sigul-sign-dir.sh b/shell/sigul-sign-dir.sh
new file mode 100644 (file)
index 0000000..8bb7bea
--- /dev/null
@@ -0,0 +1,17 @@
+#!/bin/bash -l
+# SPDX-License-Identifier: EPL-1.0
+##############################################################################
+# Copyright (c) 2018 The Linux Foundation and others.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+##############################################################################
+echo "---> sigul-sign-dir.sh"
+
+# Ensure we fail the job if any steps fail.
+set -e -o pipefail
+
+lftools_activate
+lftools sign sigul "${SIGN_DIR}"