G’day Atlassian community!
I’m Randy, a Senior Software Engineer on one of Atlassian’s Cross-Product Data Center teams.
Our team has been working hard on updating Jira to support storing attachments and avatars in an Amazon S3 bucket, rather than in the
<sharedhome> directory. We believe this will greatly improve the scalability of the application, and reduce the burden of managing shared storage for our admins.
In preparation for this change, we had to deprecate a number of Java API endpoints related to attachments and avatars. This means that some features may no longer be available or may have changed, and we encourage all users to start familiarizing themselves with the updated API.
We apologize for any inconvenience this may cause in the short term, but we believe that the benefits of object storage support will be well worth it.
What is changing?
We’ve been able to provide alternative endpoints for some cases. However, there’re many places where you’ll need to refactor your app to access avatar and attachment data through the Jira API directly, rather than through direct filesystem access.
You can find a list of all deprecated API endpoints and more information on how to prepare your apps for the upcoming changes in Preparing for Jira 9.7.
When is it changing?
These deprecations take effect in Jira 9.7. Most deprecated endpoints, except for the
getAvatarBaseDirectory() , will continue to work as expected until Jira 10, then we’ll permanently remove them from the API.
As we stop supporting
getAvatarBaseDirectory() in earlier Jira versions, we recommend using the
AvatarManager#readAvatarData() to access avatar data directly. The deprecated endpoints will continue to work as expected until Jira 10 is released.
We’re looking forward to your feedback!
We are excited about the future of Jira Data Center and the improvements that the integration with Amazon S3 will bring. Thank you for your continued support and trust in our team.
If you have any feedback regarding this feature, leave a comment below this post.
Jira Data Center and Server team