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 title S3 Features Most features offered by S3 are available by means of specifying additional Metadata fragments.
Include Page _ZIPArchiveSupportNote _ZIPArchiveSupportNote Upload File(s)
Don't fail if nothing to upload Check to not fail the build, if there is nothing to upload. Clear to trigger a build failure otherwise. Artifact Select the artifact you want to upload.
Source Local Path Specify 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
Tip title Common rename patterns See How to use Ant regular expressions to rename files on S3 uploads for common renaming patterns, for example:
Use default excludes when selecting files Check to apply Ant default excludes when selecting files. Uncheck to ignore default excludes.
Due to the way file selection is implemented in Bamboo, this setting also applies when the Use Ant patterns to select filesoption is not checked!
As of Ant 1.8.2 the default excludes also contain common version control meta files/directories (refer to the related upstream issueSCP Task to disable Ant default excludes (BAM-17438) for details):
Code Block language bash title Default excludes contains common version control meta files/directories **/.git **/.git/** **/.gitattributes **/.gitignore **/.gitmodules **/.hg **/.hg/** **/.hgignore **/.hgsub **/.hgsubstate **/.hgtags **/.bzr **/.bzr/** **/.bzrignore
Upload as ZIP archive Check to compress the selected file(s) into a single ZIP archive before uploading. Uncheck to upload separately. Target Bucket Name Specify the name of the S3 bucket where you want the files to be uploaded to.
Target Object Key Prefix (Virtual Directory) (Optional) Specify the S3 object key prefix you want the uploaded files to gain in the target bucket. Metadata Configuration (Optional) Specify 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 covering various use cases, for example:
Panel borderColor grey - – Declares file(s) to be compressed css.
- Activate server-side encryption and reduced redundancy storage.
- Redirect request to another location, if the bucket is configured as a website.
- – Sets a one hour maximum age.
- – Grant public read access.
- Note that this has somewhat tricky implications, refer to PUT Object - Copy for details.
– Replace source metadata with new values.- Tagging – Use object tagging to categorize storage, refer to Object Tagging for details.
- Object lock retention and legal hold – Store objects using a "Write Once Read Many" (WORM) model, refer to Object Lock for details.
- ...
Tags (Optional) Specify tags to apply to the resulting object(s) in JSON format. Insert fragments from the inline Examples dialog to get started.
- Refer to Object Tagging for details.
Download Object(s)
Don't fail if nothing to download Check to not fail the build, if there is nothing to download. Clear to trigger a build failure otherwise. Source Bucket Name Specify the name of the S3 bucket where you want the objects to be downloaded from.
Source Object Key Prefix Specify the key prefix of the S3 objects you want to download from the source bucket. Target Local Path (Optional) Specify the local path (relative to the working directory) where the objects will be downloaded to. Delete Object(s)
Don't fail if nothing to delete Check to not fail the build, if there is nothing to delete. Clear to trigger a build failure otherwise. Source Bucket Name see Download above
Source Object Key Prefix see Download above Copy Object(s)
Don't fail if nothing to copy Check to not fail the build, if there is nothing to copy. Clear to trigger a build failure otherwise. Source Bucket Name see Download above
Source Object Key Prefix see Download above Target Bucket Name see Upload above
Target Object Key Prefix (Virtual Directory) see Upload above Metadata Configuration see Upload above Tags (Optional) Specify tags to apply to the resulting object(s) in JSON format. Insert fragments from the inline Examples dialog to get started.
- If you do not specify any tags, the existing tags will be copied – you can prevent the copying of existing tags by providing an empty JSON array.
- Refer to Object Tagging for details.
Generate Pre-signed URL
Include Page _S3ConfigurationAsCodeNote _S3ConfigurationAsCodeNote Bucket Name Specify the name of the S3 bucket the URL should target.
Object Key Specify the key of the S3 object the URL should target. Method Select the HTTP method the URL is supposed to be used with.
- Currently supported is
GET
– if you have a use case forPUT
,HEAD
orDELETE
, please vote and comment onJira Legacy server JIRA (utoolity.atlassian.net) columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId fac61c2e-db0a-39da-bb3c-e0dc0ef556f0 key UAA-259
Expiration Specify for how long the URL should be valid (seconds).
Variables
Include Page | ||||
---|---|---|---|---|
|
Upload File(s)
Code Block | ||||
---|---|---|---|---|
| ||||
Creating resource variables for uploaded object 'prefix/taws-tst-object-4B.txt': ... bamboo.custom.aws.s3.object.first.BucketName: taws-tst-target-us-east-1 ... bamboo.custom.aws.s3.object.first.ETag: 1dafad37f6d9e169248bacb8485fd9cc ... bamboo.custom.aws.s3.object.first.ObjectKey: prefix/taws-tst-object-4B.txt ... bamboo.custom.aws.s3.object.first.VersionId: null |
Download Object(s)
N/A
Delete Object(s)
N/A
Copy Object(s)
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Creating resource variables for copied object 'taws-tst-object-4B.a.txt': ... bamboo.custom.aws.s3.object.first.BucketName: taws-tst-target-us-east-1 ... bamboo.custom.aws.s3.object.first.ETag: 1dafad37f6d9e169248bacb8485fd9cc ... bamboo.custom.aws.s3.object.first.ObjectKey: taws-tst-object-4B.a.txt ... bamboo.custom.aws.s3.object.first.VersionId: null |
Generate Pre-signed URL
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Creating resource variables for pre-signed URL 'https://taws-tst-source-us-east-1.s3.amazonaws.com/taws-tst-object-4B.txt': ... bamboo.custom.aws.s3.object.first.PresignedUrl.password: ****** ... bamboo.custom.aws.s3.object.first.BucketName: taws-tst-source-us-east-1 ... bamboo.custom.aws.s3.object.first.ObjectKey: taws-tst-object-4B.txt ... bamboo.custom.aws.s3.object.first.Method: GET ... bamboo.custom.aws.s3.object.first.Expiration: 20170511T103911Z |
How-to Articles
Filter by label (Content by label) | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Frequently Asked Questions (FAQ)
Include Page | ||||
---|---|---|---|---|
|
Questionslist macro | ||||||||
---|---|---|---|---|---|---|---|---|
|