JSPM – cloudfront-tls@1.0.0

Package Exports

cloudfront-tls

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cloudfront-tls) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

cloudfront-tls

Easily set up a Amazon Cloudfront Distribution for your project, optionally with your custom TLS certificates.

Your AWS credentials should either be in ~/.aws/credentials or in the environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY.

Installation

cloudfront-tls is a node.js program/module.

npm install -g cloudfront-tls

Usage (CLI)

$ cloudfront-tls -h

  Usage: cloudfront-tls [options] origin

  Options:

    -h, --help                               output usage information
    -V, --version                            output the version number
    -a, --aliases <aliases,...>              CNAMES for your distribution.
    --cert-id <IAM ServerCertId>             The ID of your cert in IAM.
    -c, --cert <cert>                        Path to the public key certificate.
    -k, --key <key>                          Path to the private key.
    -n, --cert-name <certificate name>       A unique name for the server certificate.
    -i, --intermediate <intermediate certs>  Path to the concatenated intermediate certificates.

All the options are optional ;-). When using --cert-id you don't need to provide cert, key and intermediate. If you don't already have your certificate in IAM, provide at least cert, key and 'cert-name' so it can be uploaded to IAM for you.

cloudfront-tls -a www.my-site.com my-bucket.s3.aws.com creates a distribution for the specified origin and sets up the alias www.my-site.com. You can then set up a CNAME record for www.my-site.com pointing to the returned cloudfront hostname.

Usage (API)

var cloudfront = require('cloudfront-tls')

cloudfront({
  origin: 'my-bucket.s3.aws.com', // required
  aliases: ['www.my-site.com'], // optional aliases
  certId: 'foobar', // If you already have your cert in IAM, provide its id here

  // otherwise provide at least cert, certName and key if you want to use your own certificate
  cert: 'foo.crt', // Path to the public key certificate
  key: 'foo.key', // Path to the private key
  certName: 'my-cert', // A unique name for the server certificate
  intermediate: 'chain.crt', // Path to the concatenated intermediate certificates (optional)
}, function(err, distribution) {
  if (err) throw err
  console.log(distribution)
})

Contributing

Feel free to open issues and submit pull requests.

License

ISC