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.

User guide

New releases are logged in GitHub Releases.

• 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.

• 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

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

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

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

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

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

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

• 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.

• Now requires Jenkins 2.60.x or later.
• JENKINS-40612 - Performance improvement in rendering.
• JENKINS-46933 - Metadata changes.

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

• JENKINS-43518 - Interrupt button on indexing log does not work
• JENKINS-45823 - Fix default values for Orphaned Item Strategy

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

• JENKINS-43424 PeriodicFolderTrigger demonstrates sympathetic harmonization for short intervals

• 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

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

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

Do not use! JENKINS-42593

• 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

• JENKINS-41370 Test harness upgrades to fix PCT
• JENKINS-41842 Additional tests for Computed folder 
• JENKINS-42151 Event support for Computed folders should be thread safe

• 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

• 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

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

• 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

• 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

• Upgrade to Credentials Plugin 2.0 APIs for managing folder based credentials stores

• 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.

• 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.

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

• JENKINS-25240 Another fix to the fix from 5.5.
• Cleanup from JENKINS-33759 fix in 5.6.
• Matching change from JENKINS-31162 Jenkins 2.0 fix needed for New Item filtering, including JENKINS-33972 API change.

• 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.

• 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.

• JENKINS-33479 NullPointerException when using the GitHub Organization Folder Plugin.
• Avoid a stack trace when Credentials plugin is disabled.

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

• Deleted resource file left over from 5.2.

• Restored Java 6 compatibility.

• Removed dependency on the Matrix Authorization Strategy Plugin. If you accept this update, you must also update that plugin (to 1.3 or higher), and you must update the Icon Shim Plugin (to 2.0.3 or higher).

• 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.

• 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.

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

• 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)

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

• 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.

• 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.

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

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

• 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)

• Move link was broken in 4.3. (JENKINS-21724)

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

• Backported permission checks from 4.6 and 4.6.1.

• Configurable default view (JENKINS-20235, JENKINS-20006)
• Provide views list in breadcrumb bar (JENKINS-20523)

• 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)

• Try harder to enforce subitem restrictions. (JENKINS-21113)

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

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

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

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