Folders

This plugin allows users to create "folders" to organize jobs. Users can define custom taxonomies (e.g. by project type, organization type). Folders are nestable and you can define views within folders.

Documentation

User guide

Version History

New releases are logged in GitHub Releases.

Version 6.9 (Jun 12, 2019)

  • JENKINS-48452 - Update the description of the orphaned item strategy adding a generic explanation that can be changed by implementations for a more context specific explanation to prevent from misunderstanding.

Version 6.8 (Apr 5, 2019)

  • Add function to programmatically remove a trigger from a folder PR#126
  • Code cleanup PR#124
  • Allow implementations of ComputedFolder to run initialization tasks PR#121

Version 6.7 (Nov 16, 2018)

  • JENKINS-47077 - Tidy up how the periodically if not otherwise run trigger for computed folders works to better align with its implied contract. 

Version 6.6 (Jun 25, 2018)

  • JENKINS-22936 - Modify renaming logic to use the new flow introduced in Jenkins 2.110 once JENKINS-52164 is fixed.
  • Updated the baseline

Version 6.5.1 (Jun 25, 2018)

  • JENKINS-52164 - Revert modifications to renaming logic until the associated bug is fixed.

Version 6.5 (Jun 25, 2018)

  • JENKINS-22936 - Modify renaming logic to use the new flow introduced in Jenkins 2.110.

Version 6.4 (Mar 16, 2018)

  • Show a warning when clicking apply while trying to rename a folder instead of a nested view.

Version 6.3 (Jan 05, 2018)

  • JENKINS-33622 - Use Jenkins 2.x-style configuration page.
  • JENKINS-47438 - Race condition with throttling of computed folder indexing.

Version 6.2.1 (Oct 16, 2017)

  • JENKINS-47416 Updating primary view from older plugin versions never worked correctly, but as of 6.2.0 began reporting errors in Manage Old Data.

Version 6.2.0 (Oct 11, 2017)

Version 6.1.2 (Aug 4, 2017)

  • JENKINS-45984 - Fix default orphaned item strategy for new instances

Version 6.1.1 (Aug 3, 2017)

Version 6.1.0 (Jul 17, 2017)

  • JENKINS-45322 Computed folders should disabled orphaned items prior to removal by the orphaned item strategy
  • JENKINS-45501 Fix PCT test failures

Version 6.0.4 (May 2, 2017)

  • JENKINS-43424 PeriodicFolderTrigger demonstrates sympathetic harmonization for short intervals

Version 6.0.3 (March 16, 2017)

  • JENKINS-35112 Interrupt in-progress builds and computations when deleting a Folder
  • JENKINS-37369 Expose the ComputedFolder's last computation results via Last Success / Last Failure and Last Duration columns
  • JENKINS-42680 Prevent infinite loop if a Folder is a child of a ComputedFolder

Version 6.0.2 (March 8, 2017)

  • JENKINS-42593 Critical NullPointerException in 6.0.0/6.0.1 fixed.

Version 6.0.1 (March 8, 2017)

  • JENKINS-42511 Turn on the fix (was accidentally turned off during testing for 6.0.0 release)

Do not use! JENKINS-42593

Version 6.0.0 (March 8, 2017)

  • Switch to a more semver{.external-link}-like version scheme
  • JENKINS-42146 Added missing i18n bundle keys
  • JENKINS-40921 / JENKINS-33020 Only display relevant triggers in a ComputedFolder
  • JENKINS-41416 Fold the computation sub-menu into the main level for a ComputedFolder
  • JENKINS-42511 Change ComputedFolder API to define the behaviour for computations concurrent with events and fix PeriodicFolderTrigger to prevent a race condition that could cause concurrent computations

Do not use! JENKINS-42593

Version 5.18 (February 22, 2017)

Version 5.17 (February 2, 2017)

  • JENKINS-41004 Credentials Binding does not guarantee folder credential with a given ID will be returned over global credential with same ID
  • JENKINS-41124 Add an API that allows the folder's child item URLs to follow a different structure from the on-disk directory name where the child is stored

Version 5.16 (January 10, 2017)

  • JENKINS-40922 Events loading wheel needs explanation
  • Added some Japanese translations
  • JENKINS-38606 follow-up, when running on a version of Jenkins that has the fix for JENKINS-38606, trigger the migration of views

Version 5.15 (December 14, 2016)

  • JENKINS-40440 Computed folder should not redirect to computation if not buildable

Version 5.14 (December 5, 2016)

  • JENKINS-39213 Add ability for computed folders to control the views in the folder
  • JENKINS-39355 follow-up Adding API support to enable better handling of events that affect computed folders
  • JENKINS-39404 follow-up - synchronizing with the core changes
  • JENKINS-38960 Align with the IconSpec API
  • Better folder health caching

Version 5.13 (September 23, 2016)

  • JENKINS-36160 - The credentials provider was not considering the folder as an itemgroup when accessed as an Item.
  • JENKINS-37941 - folder plugin missing norefresh=true in RelocationAction

Version 5.12 (June 15, 2016)

  • JENKINS-32309 - Feature: Allow Actions to contribute summary items for folders
  • JENKINS-32359 - BugFix: Fix persistence of properties, for folders, which have been previously loaded from the disk
  • JENKINS-34939 - Performance: Improve locking behavior for folder delete operations to avoid delays in plugins like JobConfigHistory Plugin

Version 5.11 (May 24, 2016)

Version 5.10 (May 12, 2016)

  • JENKINS-33819 New API to set the orphanedItemStrategy field in ComputedFolder.
  • JENKINS-34306 Invalid destinations showed in the UI when you try to move an item.

Version 5.9 (Apr 27, 2016)

  • JENKINS-34200{.external-link} After creating or reconfiguring a ComputedFolder (e.g. used for Pipeline Multibranch projects) user is redirected to indexing console output.
  • JENKINS-34465{.external-link} Indexing options in the left menu have hardcoded paths.

Version 5.8 (Apr 12, 2016)

  • JENKINS-31162 Define New Item categorizations for use in Jenkins 2.0.

Version 5.7 (Apr 02, 2016)

Version 5.6 (Mar 29, 2016)

  • JENKINS-25240 Fix generalized to organization folders.
  • JENKINS-33759 Removed new link in favor of standard newJob, which will look different in Jenkins 2.0.
  • JENKINS-33817 Can now save backup copies of folder computation log: -Dcom.cloudbees.hudson.plugins.folder.computed.FolderComputation.BACKUP_LOG_COUNT=5
  • Handling of AbortException needed for JENKINS-33815.
  • Better thread names during folder computation to help diagnose issues.

Version 5.5 (Mar 21, 2016)

  • JENKINS-32179 Improper handling of duplicated children in a computed folder, such as two branch sources with overlapping branch names.
  • JENKINS-25240 Do not delete branch projects with running builds.
  • Allowing Delete Folder to appear in the context menu.
  • JENKINS-33479/JENKINS-33480 More general fix.
  • JENKINS-33006 Fixed form round-tripping for hour-unit values in Periodically if not otherwise run trigger.

Version 5.4 (Mar 14, 2016)

Version 5.3 (Mar 4, 2016)

  • Correctly handle {{Action}}s contributed by other plugins
  • Allow display name of folder computation to be customized by other plugins

Version 5.2.2 (Feb 25, 2016)

  • Deleted resource file left over from 5.2.

Version 5.2.1 (Feb 22, 2016)

  • Restored Java 6 compatibility.

Version 5.2 (Feb 22, 2016)

Version 5.1 (Nov 12, 2015)

  • Fixed a bug renaming a folder.
  • JENKINS-31129 Only rebuild a computed folder upon explicit configuration change.
  • API and UI adjustments to computed folder triggers.

Version 5.0 (Oct 27,2015)

  • Warning: binary-incompatible change can result in java.lang.NoSuchFieldError: owner for FolderProperty implementations from other plugins. The following plugins, if installed, should be updated to match:
    • CloudBees Folders Plus
    • CloudBees Templates
    • CloudBees Role-Based Access Control
    • GitLab Auth (no fix yet)
  • Non-beta release, no changes since 4.11-beta-1 other than version number.

Version 4.11-beta-1 (Oct 20, 2015)

  • Added new ComputedFolder API for folders whose contents are determined by an algorithm rather than manual customization.
  • JENKINS-30951 Implemented ModifiableViewGroup API.

Version 4.10 (Sep 17, 2015)

  • Added support for the TopLevelItemDescriptor.isApplicableIn(ItemGroup) method introduced in Jenkins 1.607+ (plugin baseline Jenkins version remains unchanged as the support is via reflection)

Version 4.9 (Jul 08, 2015)

  • Added an extension point to allow the UI for moving items to be extended/augmented by other plugins

Version 4.8 (May 06, 2015)

  • JENKINS-28243 Allow all item-group-scoped permissions (such as View/*) to be configured when using project-based matrix authorization strategy.
  • JENKINS-25597 Move link incorrectly shown--with a broken icon--for non-top-level items.

Version 4.7 (Oct 30, 2014) (Jenkins 1.554.1+)

  • JENKINS-25073 Avoid double-counting health metrics from subfolders.
  • Better checking of Job/Discover permission.
  • Let user select configure folder’s viewTabBar.
  • Display an enhanced API summary page when running on 1.569+, including information on /createItem.

Version 4.6.1 (Jun 4, 2014) [Jenkins 1.548+]

  • Missed one of the permission checks when fixing the permission checks in 4.6

Version 4.6 (May 21, 2014) [Jenkins 1.548+]

  • Permission checks on the per-folder credentials store were checking against Jenkins and not the folder's permissions.
  • Use transparent PNGs instead of GIFs

Version 4.5 (Feb 18, 2014) [Jenkins 1.548+]

  • Domain scoped credentials within folders were not discoverable via the credentials API
  • Configurable default view (JENKINS-20235, JENKINS-20006)
  • Provide views list in breadcrumb bar (JENKINS-20523)

Version 4.4 (Feb 10, 2014) [Jenkins 1.548+]

Version 4.3 (Jan 21, 2014) [Jenkins 1.548+]

  • Taking advantage of APIs in Jenkins 1.548+ that allow items to be moved among folders and plugins to receive notifications of this.

Version 4.2.3 (Jun 12, 2014) [Jenkins 1.526+]

  • Backported permission checks from 4.6 and 4.6.1.

Version 4.2.2 (May 09, 2014) [Jenkins 1.526+]

Version 4.2.1 (Feb 18, 2014) [Jenkins 1.480+]

  • Domain scoped credentials within folders were not discoverable via the credentials API (Cherry-picked from 4.5 to provide fix for Jenkins instances from 1.480-1.547)

Version 4.2 (Dec 23, 2013) [Jenkins 1.480+]

Version 4.1 (Dec 12, 2013) [Jenkins 1.480+]

  • Removed Job Config History plugin integration, with the intention of moving it into that plugin. (JENKINS-20990)

Version 4.0.1 (Nov 28, 2013) [Jenkins 1.480+]

  • Added CodeMirror-based syntax highlighting and preview to the folder description.        

Version 4.0 (Oct 10, 2013) [Jenkins 1.480+]

  • First open-source release. Formerly a CloudBees free plugin. Blog post

Versions 1.0 - 3.15

Previous versions were closed source, the version history can be found on the CloudBees release notes server