Custom S3 Buckets

Purple uses AWS to store contents for all apps by default. The default storage location is in Europe (eu-west-1) and is distributed by AWS Cloudfront as it's CDN.

There may be reasons why you would want to manage your storage yourselves:

• Your consumers are located in different parts of the world. Do reduce latencies it may be beneficial to have your S3 storage in a different region
• You want to keep track of the costs for the content delivery
• Your internal or external policies require you to manage the storage yourself

Purple supports this by allowing you to configure the storage for your team.

We offer an official Terraform module which takes care of configuring all the necessary resources automatically.

There are only a handful parameters you need to provide. The module will setup an

• S3 bucket
• AWS Cloudfront distribution
• Lambda@Edge with Tachyon for dynamic image resizing
• and optionally an AWS ACM certificate for the Cloudfront distribution, if you want to use a custom CDN domain.

The following example sets up a bucket in eu-central-1 and configures cdn.example.com as the Cloudfront domain.

Example

provider "aws" {
  region = "eu-central-1"
}
provider "aws" {
  alias  = "us-east-1"
  region = "us-east-1"
}
data "aws_route53_zone" "default" {
  name = "example.com"
}
module "purple_files" {
  source  = "sprylab/purple-s3-cloudfront/aws"
  version = "~> 0.0"
  providers = {
    aws               = aws
    aws.us-east-1     = aws.us-east-1
    aws.bucket-region = aws
  }
 
  # S3
  bucket_name          = "my-purple-files-123"
  bucket_iam_user_name = "my-purple-files-123"
 
  # Cloudfront
  cloudfront_domain  = "cdn.example.com"
  cloudfront_comment = "Purple Files"
 
  # ACM
  acm_certificate_name = "Purple Files"
  acm_zone_id          = data.aws_route53_zone.default.id
}

Once this configuration was applied using Terraform, you can configure the custom bucket in the Purple Manager like this: