ponyfoo v1.0.29

Pony Foo

Open-source blogging platform

Development

Merely install dependencies and run the application using npm start. The start command will compile and bundle all necessary assets, set up file watchers, as well as nodemon and browser-sync so that you're able to continuously develop.

npm install
npm start

Deployments

First off you'll need to download and install the awscli tool.

pip install awscli

Then configure it with your AWS credentials. Make sure to leave the default JSON format output as-is, the deployment scripts revolve around using jq to parse the awscli output.

aws configure

You'll probably want to create an instance on EC2. The command below will spin up a new instance, give it an IP address, and set it up for node and nginx. Note that the database server must be hosted separately. For this purpose I chose MongoLab as my DBaaS provider of choice, the free tier should suffice.

npm run launch

Configure it with it's private environment variables, which you should place in an .env file in the application root. The command below will push the .env file via rsync to the server and restart it, so make sure you only update environment variables when necessary.

npm run configure

Whenever you want to deploy, use the command below. It'll bump the version by a single patch digit and upload the diff since the last deployment. Uploading occurs via rsync, then nginx and node are hot-reloaded thanks to forever and recluster.

npm run deploy

You can then quickly access the deployed site on your favorite browser.

npm run open

If you run into trouble, you can ssh into the instance and ammend the situation by yourself.

npm run ssh

Usage

To access the production site visit ponyfoo.com, or use curl to get a plaintext edition.

curl -L -H "Accept: text/plain" ponyfoo.com/articles/last

License

MIT