statica

README

statica

Simple CLI tool to deploy static websites to AWS S3 with Cloudflare DNS

Features

Backendless deploy tool for static websites to AWS S3 bucket with Cloudflare DNS

• Automatically creates and configures bucket if does not exist
• Automatically creates Cloudflare DNS record to AWS S3 website endpoint
• Uploads static files from current working directory (or give via second argument) to AWS S3 bucket

Installation

Homebrew

brew install vojtechmares/tap/statica

Supports macOS and linux.

Docker

docker pull vojtechmares/statica

Configuration

Environment variables

statica is configured via environment variables

• STATICA_AWS_ACCESS_KEY_ID - AWS Access Key ID
• STATICA_AWS_SECRET_KEY - AWS Secret Key
• STATICA_AWS_REGION - AWS Region (region in which S3 bucket will be created)
• STATICA_CF_API_TOKEN - Cloudflare API Token

statica currently does not support configuration files

Usage

Example

statica example.com dist

• domain is your domain in Cloudflare, this argument is mandatory
• directory is directory from which to deploy files to S3, default is . (current working directory)

Commands

statica

Deploys content from directory

Requires at least one argument (domain)

statica example.com

Second argument is optional and specifies source directory of files to upload

Default: . (current working directory)

Flags

• bucket-name - Overrides default bucket name (default bucket name is domain argument)
• bucket-prefix - Adds prefix in front of bucket name (does not include separator)
• bucket-suffix - Adds suffix behind bucket name (does not include separator)
• no-dns - Omits DNS record creation

statica destroy

Deletes AWS s3 bucket (including content) and Cloudflare DNS record

Requires exactly one argument (domain)

statica destroy example.com

Flags

• bucket-name - Overrides default bucket name (default bucket name is domain argument)
• bucket-prefix - Adds prefix in front of bucket name (does not include separator)
• bucket-suffix - Adds suffix behind bucket name (does not include separator)
• no-dns - Omits DNS record deletion

statica version

Prints version of statica.