An ember-cli-deploy plugin to upload files to S3
This plugin uploads one or more files to an Amazon S3 bucket. It could be used to upload the assets (js, css, images etc) or indeed the application's index.html.
A plugin is an addon that can be executed as a part of the ember-cli-deploy pipeline. A plugin will implement one or more of the ember-cli-deploy's pipeline hooks.
For more information on what plugins are and how they work, please refer to the Plugin Documentation.
To get up and running quickly, do the following:
-
Ensure ember-cli-deploy-build is installed and configured.
-
Install this plugin
$ ember install ember-cli-deploy-s3- Place the following configuration into
config/deploy.js
ENV.s3 = {
accessKeyId: '<your-aws-access-key>',
secretAccessKey: '<your-aws-secret>',
bucket: '<your-s3-bucket>',
region: '<the-region-your-bucket-is-in>'
}- Run the pipeline
$ ember deployRun the following command in your terminal:
ember install ember-cli-deploy-s3For detailed information on what plugin hooks are and how they work, please refer to the Plugin Documentation.
configureupload
For detailed information on how configuration of plugins works, please refer to the Plugin Documentation.
**WARNING: Don't share a configuration object between [ember-cli-deploy-s3-index](https://github.com/ember-cli-deploy/ember-cli-deploy-s3-index) and this plugin. The way these two plugins read their configuration has sideeffects which will unfortunately break your deploy if you share one configuration object between the two** (we are already working on a fix)
The AWS access key for the user that has the ability to upload to the bucket. If this is left undefined,
the normal AWS SDK credential resolution will take place.
Default: undefined
The AWS secret for the user that has the ability to upload to the bucket. This must be defined when accessKeyId is defined.
Default: undefined
The AWS session token for the user that has the ability to upload to the bucket. This may be required if you are using the AWS Security Token Service.
This requires both accessKeyId and secretAccessKey to be defined.
Default: undefined
The AWS bucket that the files will be uploaded to.
Default: undefined
The region the AWS bucket is located in.
Default: undefined
The ACL to apply to the objects.
Default: public-read
A directory within the bucket that the files should be uploaded in to.
Default: ''
Files that match this pattern will be uploaded to S3. The file pattern must be relative to distDir.
Default: '**/*.{js,css,png,gif,ico,jpg,map,xml,txt,svg,swf,eot,ttf,woff,woff2,otf}'
The root directory where the files matching filePattern will be searched for. By default, this option will use the distDir property of the deployment context, provided by ember-cli-deploy-build.
Default: context.distDir
The list of built project files. This option should be relative to distDir and should include the files that match filePattern. By default, this option will use the distFiles property of the deployment context, provided by ember-cli-deploy-build.
Default: context.distFiles
The list of files that have been gziped. This option should be relative to distDir. By default, this option will use the gzippedFiles property of the deployment context, provided by ember-cli-deploy-gzip.
This option will be used to determine which files in distDir, that match filePattern, require the gzip content encoding when uploading.
Default: context.gzippedFiles
The path to a manifest that specifies the list of files that are to be uploaded to S3.
This manifest file will be used to work out which files don't exist on S3 and, therefore, which files should be uploaded. By default, this option will use the manifestPath property of the deployment context, provided by ember-cli-deploy-manifest.
Default: context.manifestPath
The client used to upload files to S3. This allows the user the ability to use their own client for uploading instead of the one provided by this plugin.
The client specified MUST implement a function called upload.
Default: the upload client provided by ember-cli-deploy-s3
The underlying S3 library used to upload the files to S3. This allows the user to use the default upload client provided by this plugin but switch out the underlying library that is used to actually send the files.
The client specified MUST implement functions called getObject and putObject.
Default: the default S3 library is aws-sdk
Sets the Cache-Control header on the uploaded files.
Default: max-age=63072000, public
Sets the Expires header on the uploaded files.
Default: Mon Dec 31 2029 21:00:00 GMT-0300 (CLST)
Sets the default mime type, used when it cannot be determined from the file extension.
Default: application/octet-stream
The following properties are expected to be present on the deployment context object:
distDir(provided by ember-cli-deploy-build)distFiles(provided by ember-cli-deploy-build)gzippedFiles(provided by ember-cli-deploy-gzip)manifestPath(provided by ember-cli-deploy-manifest)
Ensure you have the minimum required permissions configured for the user (accessKeyId). A bare minimum policy should have the following permissions:
{
"Statement": [
{
"Sid": "Stmt1EmberCLIS3DeployPolicy",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:PutObject",
"s3:PutObjectACL"
],
"Resource": [
"arn:aws:s3:::<your-s3-bucket-name>/*"
],
"Principal": { "AWS": "arn:aws:iam::AWS-account-ID:root" }
}
]
}
Replace with the name of the actual bucket you are deploying to. Also, remember that "PutObject" permission will effectively overwrite any existing files with the same name unless you use a fingerprinting or a manifest plugin.
To properly serve certain assets (i.e. webfonts) a basic CORS configuration is needed
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedOrigin>http://www.your-site.com</AllowedOrigin>
<AllowedOrigin>https://www.your-site.com</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedMethod>HEAD</AllowedMethod>
</CORSRule>
</CORSConfiguration>
Replace http://www.your-site.com with your domain.
Some more info: Amazon CORS guide, Stackoverflow
npm test