RPubs

Development

You’ll need docker and docker-compose installed. You’ll also need AWS credentials configured, that have permissions to write to s3://rstudio-rpubs-staging-static and able to read rpubs.staging.* keys from credstash.

One-time setup of the database can be performed with:

make initdb

Then, you can run the app with:

make run

or make run-nobuild if you want to run without rebuilding the image.

View the app at http://localhost:3000.

You can remove the created containers with make clean. Note that this will cause ALL database data to be reset–we currently store the data in the container itself, not in an external volume as we probably should.

Deploying to staging

Thanks to Steve Nolen, merging commits to master will cause Docker images to be built and deployed to fargate. Just wait several minutes, then access https://staging.rpubs.com. To publish to the staging environment, you’ll have to modify /etc/hosts to point rpubs.com and api.rpubs.com to the IP address for staging.rpubs.com.

Deploying to production

The Jenkins project rpubs/rpubs-deploy can be built with parameters to deploy a specific commit to production.