Aptible's public web site is built with Middleman.

Clone the repo:

git clone https://github.com/aptible/www.aptible.com.git
cd www.aptible.com/

Install necessary dependencies:

bundle install
cd aptiblejs
npm install

(Optionally) pull dynamic Resource and Blog content from Contentful:

bundle exec rake contentful:pull

Start the server. You can access it at http://localhost:4567/

bundle exec middleman server
cd aptiblejs
npm run dev

If you are running Aptible's documentation site locally, set the BASE_DOC_URL environment variable:

BASE_DOC_URL=http://localhost:8888 bundle exec middleman server

First, some prerequisites:

• AWS CLI, installed locally
• A valid AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY in your environment

In production and staging, the site is deployed as an S3 website (fronted by CloudFront).

To manually deploy to production, using Omnivault:

omnivault exec bundle exec rake deploy:production

Staging:

omnivault exec bundle exec rake deploy:staging

An arbitrary S3 bucket:

omnivault exec bundle exec rake deploy[bucket]

To deploy content-only changes, make sure your changes are set to published in Contentful and then deploy manually from Travis:

• Login to https://travis-ci.org/aptible/www.aptible.com.
• Go to More Options > Trigger build
• Select the release branch
• Click Trigger custom build

Travis CI deploys to both staging and production on every successful merge to master. This requires the encrypted AWS credentials for an authorized user to be stored in the .travis.yml configuration file.

To update these credentials at any time, run:

travis encrypt -r aptible/www --add env AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=...

If you run into an issue that needs documentation, feel free to submit a pull request or open an issue. We send t-shirts and swag to contributors.

Copyright (c) 2019 Aptible. All rights reserved.