Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
You can use the Amazon S3 Object task to upload, download, delete or copy Amazon Simple Storage Service (Amazon S3) (files); in particular, you can upload your Bamboo job's build artifacts or select local files and directories (optionally via Ant Patterns) - when addressing S3 objects (files), it matches those by key prefix, which allows to operate on multiple objects at once (virtual directories resp. folder hierarchies).
Image Added
Panel | ||||
---|---|---|---|---|
| ||||
On this page:
|
Panel | ||||
---|---|---|---|---|
| ||||
Related Pages: |
Configuration
To configure an Amazon S3 Object task:
- Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
- Click the name of an existing Amazon S3 Object task, or click Add Task and then Amazon S3 Object Task to create a new task.
Complete the following settings:
Common to all tasks
Include Page _CommonTaskParametersTable _CommonTaskParametersTable
Actions supported by this task:
Tip Most features offered by S3 are available by means of specifying additional Metadata fragments.
Upload
Artifact (Optional) One or more instance IDs (semicolon separated).
Source Local Path The local path (relative to the Bamboo working directory) to the files you want to upload. Use commas to separate files and directories. You can also use:
- Ant-style pattern matching to include multiple files
- Ant-style regular expression matching to rename multiple files
Target Bucket Name The name of the S3 bucket where the objects will be uploaded to.
Target Object Key Prefix (Virtual Directory) The key prefix of the S3 objects to be uploaded in the target bucket. Metadata Configuration (Optional) Additional metadata in JSON format. Insert fragments from the inline Examples dialog to get started.
Refer to PUT Object and PUT Object - Copy for available metadata options and values. For example:
Panel borderColor grey - Content type and encoding – Declares file(s) to be compressed css.
- Encryption and storage class – Activate server-side encryption and reduced redundancy storage.
- Website redirect location – Redirect request to another location, if the bucket is configured as a website.
- Cache control – Sets a one hour maximum age.
- Access control – Grant public read access.
- (Copy only) Replace metadata –Replace source metadata with new values.
- Note that this has somewhat tricky implications, please see the PUT Object - Copy documentation for details.
Download
Source Bucket Name The name of the S3 bucket where the objects will be downloaded from.
Source Object Key Prefix The key prefix of the S3 objects to be downloaded from the source bucket. Target Local Path The local path (relative to the working directory) where the objects will be downloaded to. Delete
Source Bucket Name see Download above
Source Object Key Prefix see Download above Copy
Source Bucket Name see Download above
Source Object Key Prefix see Download above
Configuration
Image RemovedTarget Bucket Name see Upload above
Target Object Key Prefix (Virtual Directory) see Upload above Metadata Configuration see Upload above