reg-publish-s3-plugin

reg-suit plugin to fetch and publish snapshot images to AWS S3.

Install

npm i reg-publish-s3-plugin -D
reg-suit prepare -p publish-s3

AWS Credentials

This plugin needs AWS credentials to access S3. You can set them by the following 2 methods.

Environment values

export AWS_ACCESS_KEY_ID=<your-access-key>
export AWS_SECRET_ACCESS_KEY=<your-secret-key>

Create INI file

Create a file at ~/.aws/credentials and edit it. For example:

[default]
aws_access_key_id = <your-access-key>
aws_secret_access_key = <your-secret-key>

Configure

{
  bucketName: string;
  acl?: string;
  sse?: boolean | string;
  customDomain?: string;
  pathPrefix?: string;
  sdkOptions?: S3.Types.ClientConfiguration;
}

• bucketName - Required - AWS S3 bucket name to publish the snapshot images to.
• acl - Optional - Specify ACL property. By default, public-read.
• sse - Optional - Specify server-side encryption property. Default false. If you set true, this plugin send with --sse="AES256.
• customDomain - Optional - Set if you have your domain and host S3 on it. If set, the HTML report will be published with this custom domain(e.g. https://your-sub.example.com/...).
• pathPrefix - Optional - Specify paths. For example if you set some_dir, the report is published with URL such as https://your-backet-name.s3.amazonaws.com/some_dir/xxxxxxxxx/index.html.
• sdkOptions - Optional - Specify SDK options to pass to the S3 client. For details about the options, refer to the AWS JavaScript SDK docs.