Installing File preview

1. Create an AWS ECR private repository (if one does not exist already).

   aws ecr create-repository \
   --repository-name {repo_name} \
   --image-scanning-configuration scanOnPush=true \
   --region {region}
   

2. Provide Docker access to push docker images in AWS ECR private repositories.

   aws ecr get-login-password --region {region} | docker login --username AWS --password-stdin {account_id}.dkr.ecr.{region}.amazonaws.com

   You can obtain the {account_id} value running:

   aws sts get-caller-identity | grep Account

Build the docker images:

3. Preview: The main core function to generate the previews for the uploaded files.
   Note: There are four different encoders to replace the encoder value with: vp9, av1, x264, or openh264.

   The following code represents an example using vp9:

   cd previews && docker build --build-arg encoder=vp9 -t {account_id}.dkr.ecr.{region}.amazonaws.com/{repo_name}:previews .

   Note: The value {repo_name} has to match the name of the AWS ECR private repository you created in step one.
4. Previews-checker: Check existing items in the bucket on a particular path. previews-checker calls File Preview on each file that does not have a preview.

   cd ../previews-checker && docker build -t {account_id}.dkr.ecr.{region}.amazonaws.com/{repo_name}:checker .

5. Previews-filter: Filters out S3 upload triggers by file extensions using a low resource lambda.

   cd ../previews-filter && docker build -t {account_id}.dkr.ecr.{region}.amazonaws.com/{repo_name}:filter .

6. Push all docker images to your ECR repository.

   docker push {account_id}.dkr.ecr.{region}.amazonaws.com/{repo_name}:previews
   docker push {account_id}.dkr.ecr.{region}.amazonaws.com/{repo_name}:checker
   docker push {account_id}.dkr.ecr.{region}.amazonaws.com/{repo_name}:filter
   

7. Update both aws_secret_key and aws_access_key in ./terraform-aws/previews/variables.tf. Make sure to use a security_token when using short-term credentials. Your account must be able to install the following resources:
   • Bucket
   • IAM roles and policies
   • Lambda functions
   Note: You can modify the variables in the variables.ft file as needed.
8. Initialize a working directory containing Terraform configuration files.

   cd terraform-aws/previews
   terraform init
   

   The Terraform script will create a new bucket. You can also import an existing bucket, to do this make sure the bucket_names value in variables.tf is properly updated and run ./import.sh. Do the following to find the bucket_names for your existing AWS S3 bucket:

   • Sign in to your AWS account, and search for the keyword S3.
   • In the Buckets list, choose the names of the buckets that you want to select, and use those names as the list for the bucket_names variable.
9. Create an execution plan that lets you preview the changes that Terraform plans to make to your infrastructure.

   terraform plan

10. Validate the configuration files.

    transform validate

11. Execute the actions proposed in the Terraform plan.

    terraform apply

1. Define the following parameters to invoke the AWS Lambda function:
   • path: Location in the bucket where you want to check for previews, and which can also be empty to invoked Lambda function from the bucket root level.
   • bucket: Bucket name. The associated role should have access to it.
2. Invoke previews-checker lambda function with the previously defined parameters.

   $ aws lambda invoke \
       --function-name {checker_function_name} \
       --invocation-type Event \
       --payload '{ "path": {my_path}, "bucket": {bucket_name} }' \
       --region {region} \
       response.json

3. Optional: You can delete previews-checker if you don't have files without previews.

   $ terraform destroy --target aws_cloudwatch_log_group.terraform_log_checker  --target aws_lambda_function.terraform_lambda_checker

4. Optional: Delete the docker image from your ECR private repository.

   $ aws ecr batch-delete-image \
        --repository-name {repo_name} \
        --region {region} \
        --image-ids imageTag=checker