Public | Automated Build

Last pushed: 10 months ago
Short Description
Environment for the script which builds docs and pushes them to S3.
Full Description

Coral Projects Doc Sync

This folder contains scripts and configuration files that generate a copy of the static html files by MkDocs from the Markdown (.md) files and copies them to the AWS S3 bucket for hosting which is viewable via CloudFront (due to https requirements by HSTS).

Automated Publishing Workflow

  1. Docs are maintained and update in markdown files
  2. Github service hook to which runs Docker file
  3. Server generates MkDocs site folder, copying contents to AWS S3 bucket using
  4. AWS Cloudfront displays static files created by MkDocs

Team Process Workflow

  1. Clone git repository
  2. Ensure local repository is synched to master
  3. If working on significant changes, create new branch
  4. Commit changes to Github
  5. Solicit Coral Team members for review and feedback
  6. Merge changes



  • Command to delete all files from S3 bucket using s3tools

      s3cmd del -r --force s3://
  • Command to put (push) all files to S3 using s3tools

      s3cmd put ./site/* -rvM --force --no-mime-magic --guess-mime-type s3://
  • Command to sync all changed files by comparing the md5 checksum between local and S3 bucket files using s3tools

      s3cmd sync ./site/* -rvM --force --no-mime-magic --guess-mime-type --check-md5 s3://
  • Command to compress and upload docsync folder contents to (run within the folder)

    zip -r . && iron worker upload --zip --name docsync coralproject/docsync ./

Automated Publishing Workflow Set Up //Needs Update//

  1. Create an account if you do not already have one.
  2. Create an Project.
  3. In the project page, go to Credentials (Key icon) > Download iron.json file.
  4. Place the iron.json file in this directory (/docs/docsync)
  5. Install the command line utility:
    curl -sSL | sh
  6. Copy to
  7. Enter the following values into
    • GITHUB_REPO: Github repo to copy from
    • S3_BUCKET: S3 bucket to copy to
    • SUBDIR: Subdirectory of repo to copy, ie /site
    • AWS_ACCESS_KEY: AWS access key
    • AWS_SECRET_KEY: AWS secret key
  8. Upload docsync to
    zip -r . && iron worker upload --zip --name docsync coralproject/docsync ./
Docker Pull Command
Source Repository