[JENKINS-63022] Make Fingerprint Storage Engine configurable from the config page

core/src/main/java/jenkins/fingerprints/FileFingerprintStorage.java

@@ -36,6 +36,7 @@
 import jenkins.model.Jenkins;
 import org.kohsuke.accmod.Restricted;
 import org.kohsuke.accmod.restrictions.NoExternalUse;
+import org.kohsuke.stapler.DataBoundConstructor;
 import org.xmlpull.v1.XmlPullParserException;
 
 import java.io.EOFException;
@@ -58,6 +59,9 @@ public class FileFingerprintStorage extends FingerprintStorage {
     private static final Logger logger = Logger.getLogger(FileFingerprintStorage.class.getName());
     private static final DateConverter DATE_CONVERTER = new DateConverter();
 
+    @DataBoundConstructor
+    public FileFingerprintStorage () {}
+
     /**
      * Load the Fingerprint with the given unique id.
      */
@@ -255,4 +259,14 @@ private static String serialize(Fingerprint.RangeSet src) {
         return buf.toString();
     }
 
+    @Extension
+    public static class DescriptorImpl extends FingerprintStorageDescriptor {
+
+        @Override
+        public String getDisplayName() {
+            return "Disabled";
+        }
+
+    }
+
 }

core/src/main/java/jenkins/fingerprints/FingerprintStorage.java

@@ -29,6 +29,7 @@
 
 import java.io.IOException;
 
+import hudson.model.AbstractDescribableImpl;
 import hudson.model.Fingerprint;
 import org.kohsuke.accmod.restrictions.Beta;
 import org.kohsuke.accmod.Restricted;
@@ -39,14 +40,13 @@
  * @author Sumit Sarin
  */
 @Restricted(Beta.class)
-public abstract class FingerprintStorage implements ExtensionPoint {
+public abstract class FingerprintStorage extends AbstractDescribableImpl<FingerprintStorage> implements ExtensionPoint {
 
     /**
-     * Returns the first implementation of FingerprintStorage for the instance.
-     * External storage plugins which implement FingerprintStorage are given a higher priority.
+     * Returns the configured {@link FingerprintStorage} engine chosen by the user for the system.
      */
     public static FingerprintStorage get() {
-        return ExtensionList.lookup(FingerprintStorage.class).get(0);
+        return ExtensionList.lookupSingleton(GlobalFingerprintConfiguration.class).getFingerprintStorage();
     }
 
     /**
@@ -80,4 +80,8 @@ public static FingerprintStorage get() {
      */
     public abstract boolean isReady();
 
+    @Override public FingerprintStorageDescriptor getDescriptor() {
+        return (FingerprintStorageDescriptor) super.getDescriptor();
+    }
+
 }

core/src/main/java/jenkins/fingerprints/FingerprintStorageDescriptor.java

@@ -0,0 +1,39 @@
+/*
+ * The MIT License
+ *
+ * Copyright (c) 2020, Jenkins project contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package jenkins.fingerprints;
+
+import hudson.DescriptorExtensionList;
+import hudson.model.Descriptor;
+import jenkins.model.Jenkins;
+
+/**
+ * Descriptor for {@link FingerprintStorage}. Used for configuring external fingerprint storages.
+ */
+public class FingerprintStorageDescriptor extends Descriptor<FingerprintStorage> {
+
+    public static DescriptorExtensionList<FingerprintStorage, FingerprintStorageDescriptor> all() {
+        return Jenkins.get().getDescriptorList(FingerprintStorage.class);
+    }
+
+}

core/src/main/java/jenkins/fingerprints/GlobalFingerprintConfiguration.java

@@ -0,0 +1,68 @@
+/*
+ * The MIT License
+ *
+ * Copyright (c) 2020, Jenkins project contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package jenkins.fingerprints;
+
+import hudson.Extension;
+import hudson.ExtensionList;
+import jenkins.model.GlobalConfiguration;
+import net.sf.json.JSONObject;
+import org.kohsuke.stapler.DataBoundSetter;
+import org.kohsuke.stapler.StaplerRequest;
+
+import java.util.logging.Logger;
+
+@Extension
+public class GlobalFingerprintConfiguration extends GlobalConfiguration {
+
+    private FingerprintStorage fingerprintStorage = ExtensionList.lookupSingleton(FileFingerprintStorage.class);
+    private static final Logger logger = Logger.getLogger(GlobalFingerprintConfiguration.class.getName());
+
+    public GlobalFingerprintConfiguration() {
+        load();
+    }
+
+    public static GlobalFingerprintConfiguration get() {
+        return ExtensionList.lookupSingleton(GlobalFingerprintConfiguration.class);
+    }
+
+    public FingerprintStorage getFingerprintStorage() {
+        return fingerprintStorage;
+    }
+
+    @DataBoundSetter
+    public void setFingerprintStorage(FingerprintStorage newFingerprintStorage) {
+        this.fingerprintStorage = newFingerprintStorage;
+        logger.fine("Fingerprint Storage for the system changed to " +
+                newFingerprintStorage.getDescriptor().getDisplayName());
+    }
+
+    @Override
+    public boolean configure(StaplerRequest req, JSONObject json) {
+        json = json.getJSONObject("fingerprints");
+        req.bindJSON(this, json);
+        save();
+        return true;
+    }
+
+}

core/src/main/resources/jenkins/fingerprints/GlobalFingerprintConfiguration/config.jelly

@@ -0,0 +1,27 @@
+<!--
+The MIT License
+Copyright (c) 2020, Jenkins project contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+-->
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:f="/lib/form">
+    <f:section title="${%Fingerprints}" name="fingerprints">
+        <f:entry>
+            <f:dropdownDescriptorSelector field="fingerprintStorage" title="Configure External Fingerprint Storage"/>
+        </f:entry>
+    </f:section>
+</j:jelly>