How to Clear Jira's Plugin Cache in a Kubernetes Helm Chart Installation
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
This article provides instructions on how to clear Jira's plugin cache when running Jira in a Kubernetes environment using Helm Charts. Clearing the plugin cache can resolve issues related to inconsistent app behavior or problems with apps during startup.
Environment
Any Jira version on Kubernetes cluster deployed via the official Atlassian Helm Charts.
Solution
Clearing Plugin Cache Using Helm Chart Configuration
- Add ATL_JIRA_CLEAR_PLUGIN_CACHE to Your Helm Values File:
In your Helm values file, set the ATL_JIRA_CLEAR_PLUGIN_CACHE environment variable to true. This will delete the plugin cache at ${JIRA_HOME}/plugins/.bundled-plugins and ${JIRA_HOME}/plugins/.osgi-plugins before Jira starts.
containers:
- name: jira
env:
- name: ATL_JIRA_CLEAR_PLUGIN_CACHE
value: "true"
2. Deploy the Updated Configuration:
helm upgrade <release-name> atlassian-data-center/jira --values <your-values-file>.yaml
Notes
- This procedure automates the cache clearance, making it easier to manage in a Kubernetes environment.
- Ensure you follow best practices for testing the changes in a staging environment before applying them to production.
References