Amazon S3 Files for Confluence
- ILA eSolution
Atlassian Approved for Confluence Data Center on 2019-09-20
Helps to Store, manage, versioning and centralize space or project related files or documents on Amazon AWS S3 bucket.
Features
Beside Upload, Option to attach and detach existing AWS S3 Files on Confluence.
Helps Files Versioning in AWS S3 bucket
Provides Macros
Amazon S3 Files Summary {amazon-s3-files-summary}
Amazon S3 File Link {amazon-s3-file-link}
If your upgrading from older than version 2.0.2, please re-update the bucket configuration.
Quick Start Steps
Step-1
Go to General Configuration → Configure Amazon S3 Buckets.
Note:
Access Secret Keys are not required If you are Confluence is hosted on AWS EC2.
You can attach S3 role to EC2 with read and write access
If you are bucket is on different account then use Bucket policy to grant permission to Confluence Hosted account.
For Access Secret Keys two ways to get i.e.
Create IAM User through Console (Simple & easy step)
Step-2
Go to page options i.e. Click (…) → Amazon S3 Files
Attach existing files or upload new one.
Attach / Link existing Amazon S3 File to Space via REST API.
% curl -u admin -XPOST "http://localhost:8090/rest/spaces3documents/1.0/utility/attach/document" \
-H "Content-Type: application/json" --data '{"bucketConfigId": 4, "spaceKey": "DT", \
"pageId": 4816905, "documentKey": "s3://ilaesolution/documents/DT/pom.xml"}'
{"status":19,"message":"Amazon S3 File has been attached to Space. File ID #19"}
%Upload new Amazon S3 File via REST API.
% curl -u admin -XPOST "http://localhost:8090/rest/spaces3documents/1.0/utility/upload/document" \
-H "X-Atlassian-Token: no-check" -F bucketId=4 -F pageId=4816905 -F file=@/tmp/pom.xml
{"status":0,"message":"Space S3 File Upload Successful. (documents/DT/pom.xml)"}
%To overwrite: -F updateDocument=true
Step-3
Go to page Edit → Add Amazon S3 File Link or Amazon S3 Files Summary macros.
Results:
Step-4
For Debug. Go to, Logging and profiling → Add new entry
Package / Class Name: com.tse.confluence.spaces3documents.plugin
Logging Level: DEBUG