Folders Plugin
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