Actions - s3-website-pr-action 🚀

This is a fork of https://github.com/danburtenshaw/s3-website-pr-action

Automatically deploy built PR bundles to an S3 static website

Usage 📝

See s3-website-pr-action-example for an example application using create-react-app.

PR opened or updated

name: PR

on:
  pull_request:
    branches: [ master ]

build:
  runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - name: Yarn Install and Build
        run: |
          yarn install
          yarn build

      - name: Deploy S3 Website
        uses: igusdev/s3-website-pr-action@v1
        with:
          bucket-prefix: "example-app"
          folder-to-copy: "./dist"
        env:
          AWS_REGION: 'eu-central-1'
          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Execute the s3-website-pr-action action on pull request opened, synchronize and reopened events. This will create a new S3 static site and upload the contents of folder-to-copy. The site url will be posted as a comment on the pull request.

Note: By default, workflows using the pull_request activity type will include the above events. Docs

Required Environment Variables

Environment Variable	Description
AWS_ACCESS_KEY_ID	AWS Access Key ID of an IAM user
AWS_SECRET_ACCESS_KEY	AWS Secret Access Key of an IAM user
GITHUB_TOKEN	GitHub automatically provides the secret value

Optional Environment Variables

Environment Variable	Description
AWS_REGION	AWS region for s3 bucket

Required Parameters

Parameter	Description
bucket-prefix	Prefix to the S3 bucket name
folder-to-copy	The directory to your built web app. This folder will be copied to S3

Optional Parameters

Parameter	Description
environment-prefix	Prefix to the GitHub Deployment. Defaults to 'PR-'

PR closed

name: PR - Closed

on:
  pull_request:
    branches: [master]
    types: [closed]

build:
  runs-on: ubuntu-latest
  steps:
    - name: Delete Website Bucket
      uses: igusdev/s3-website-pr-action@v1
      with:
        bucket-prefix: 'example-app'
      env:
        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Execute the s3-website-pr-action action on pull request closed events. This will remove the S3 bucket that was created in the previous stage.

Required Environment Variables

Environment Variable	Description
AWS_ACCESS_KEY_ID	AWS Access Key ID of an IAM user
AWS_SECRET_ACCESS_KEY	AWS Secret Access Key of an IAM user
GITHUB_TOKEN	GitHub automatically provides the secret value

Optional Environment Variables

Environment Variable	Description
AWS_REGION	AWS region for s3 bucket (needs to be set if used in PR creation)

Required Parameters

Parameter	Description
bucket-prefix	Prefix to the S3 bucket name. This should be the same value as the other stage

Optional Parameters

Parameter	Description
environment-prefix	Prefix to the GitHub Deployment. Defaults to 'PR-'

IAM 🔐

Required IAM permissions for this action.

Replace <YOUR_BUCKET_PREFIX> with the same bucket-prefix value that you defined in your workflows.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:PutBucketPublicAccessBlock",
        "s3:PutBucketWebsite",
        "s3:PutBucketPolicy",
        "s3:GetBucketPolicy",
        "s3:CreateBucket",
        "s3:ListBucket",
        "s3:DeleteObject",
        "s3:DeleteBucket",
        "s3:PutObjectAcl"
      ],
      "Resource": ["arn:aws:s3:::<YOUR_BUCKET_PREFIX>-*"]
    }
  ]
}

Versioning and Releasing

Refer to https://github.com/actions/toolkit/blob/master/docs/action-versioning.md#recommendations

License

The scripts and documentation in this project are released under the MIT License