codepipeline-s3-package
Provides ability to do AWS S3 source package updates for AWS CodePipeline.
Whever triggered:
- It creates new release package (.zip) from the source files
- Checks if the package MD5 checksum differs from the target package
- If checksum is different, it uploads new package
- This will in turn trigger any AWS CodePipelines monitoring that target package
Install
$ npm install codepipeline-s3-package --save
Requirements
For accessing the S3 bucket, the package requires eitehr aws-cli
installed and configured or
AWS_ACCESS_KEY_ID
and AWS_SECRET_ACCESS_KEY
environment variables containing the AWS access and
secret keys.
Migrating from 1.x.x
To have more flexibility 2.x.x versions keep the relative directory strucure. If you need to
generate 1.x.x style flat package, where all files are in the root of the package, pass in
--flatten
flag.
Usage in package.json
{
"scripts": {
"codepipeline": "codepipeline-s3-package --source-files=cloudformation/**/* --target-bucket=my-cloudformation-bucket --target-key=my-pipelines-source.zip"
}
}
Usage with multiple source file locations:
{
"scripts": {
"codepipeline": "codepipeline-s3-package --source-files='cloudformation/**/* tests/**/*' --target-bucket=my-cloudformation-bucket --target-key=my-pipelines-source.zip"
}
}
Arguments
--source-files
- glob pattern(s) for source files
--target-bucket
- AWS S3 bucket name
--target-key
- AWS S3 file key for the target package
--flatten
- Flatten package directory structure