Reliably Deploying Rails Applications
This book is 100% complete
Completed on 2017-01-15
About the Book
Mastering Rails application deployment
This book will show you from start to finish how to:
- Setup a VPS from Scratch
- Setup additional servers in minutes
- Use Capistrano 3 to deploy quickly and reliably
- Automate boring maintenance tasks
This is the fourth edition of this book, updated January 2017 and using current releases of Chef, Capistrano & Chef Zero.
If you've got applications on Heroku which are costing you a fortune, this will provide you with the tools you need to move them onto a VPS. This includes running several Rails Applications on a single VPS - great for small side projects.
If you're already running your app on a VPS but the deploy process is flaky - it sometimes doesn't restart or loads the wrong version of the code - this book provides a template for making the process hassle free.
Section 1: Chef
How to automate provisioning new servers with chef. By the end you'll be able to get a new server up and ready to use within minutes.
Many standard Rails system configurations are supported out of the box with the example code. For anything else, detailed instructions for setting up your own custom configurations and writing your own chef recipes are provided.
The aim of this section is to build a re-usable blueprint you can use whenever you need to setup a new VPS. It includes a "Five minute VPS" quickstart section for the impatient.
Section 2: Capistrano 3
Using Capistrano 3 to automate every aspect of deployment, from updating code to managing assets and background workers.
Particular attention is paid to setting up zero downtime deployment - essential if you're iterating rapidly and want to deploy several times per day. This includes a section on common gotchas such as failing to reload the gemfile on deployment as well as a detailed guide to troubleshooting when it goes wrong.
It also includes detailed sample code and complete instructions for deploying Sidekiq workers, configuring NGinx Virtualhosts and SSL. Finally it covers how to setup automated database backups and how to use Vagrant for testing.
I've spent hundreds of hours combing through blog posts, documentation and tweaking config files. This has got me to the stage where deploying to a VPS is as easy as - in fact often easier than - deploying to Heroku. If you want to do the same, this book will save you a lot of time.
The book is continuously updated as and when there are significant changes to Capistrano, Chef and other system components.
Any feedback on content, structure or corrections very gratefully received, you can get me on twitter (@talkingquickly) or by emailing ben@talkingquickly.co.uk
Table of Contents
-
Intro
- The purpose of this book
- If you’re in a hurry
- About Me
- Why This Book Exists
- Intended Audience
- Pre-requisites
- Structure of Part 1 - Setting up the server
- Structure of Part 2 - Deploying to the server
- Version
-
The Stack
- Overview
- Ubuntu 16.04 LTS
- Nginx
- Postgresql
- Ruby + rbenv
- Redis
- Memcached
- Why This Stack
- Adapting to your stack
-
Tools And Terminology
- Introduction
- Automation
- Introducing Chef
- Terminology
- Working without a Chef server - Chef Zero
- Leveraging the Community
-
Installing Tools
- Overview
- Â Installing Tools
-
Quick Start
- Â Overview
- The Stack
- Steps
- Next Steps
-
Creating a new project & Berkshelf
- Approaches
- Generating a Chef Repo
- Berkshelf
- Configuring Knife
- Recap / Quick Reference
-
Using Knife
- Overview
- SSH Access
- Setting up a node for Chef
- Editing data in Chef & Setting Your Editor
- Editing a node definition
- Editing attributes
- Adding to the run list
- Creating and editing roles
- Applying configuration to a node (converging)
- Working with data bags
- Other useful commands
- Quick Reference
-
Creating a Chef Cookbook
- Overview
- Prerequisites
- Generating a Cookbook
- Adding the cookbook to Berkshelf
- Structure of a Cookbook
- Installing Redis Manually
- Converting this into a simple Chef Cookbook
- Adding the recipe to the node definition
- Applying the updated node definition
- Is This Cookbook “Bad” or “Wrong”
- Limitations of the simple Cookbook
- Improving our Cookbook the Chef Way
- Updating The Node
- Adding flexibility with attributes
- Conclusion
-
Node and Role Definitions
- Overview
- Attribute Heirachy
- Node Definitions
- Role Definitions
- Breaking a System Into Roles
- Â Limitations of Roles
-
A Template for Rails Servers
- Overview
- The Example Configuration
-
Basic Server Setup
- Overview
- Unattended Upgrades
- Automatic System Time via NTP
- Locales
-
Security
- Overview
- No Magic Bullet
- Common Pitfalls
- SSH Hardening
- Firewall
- Users
- Sudo
-
Ruby & Gem Dependencies
- Â Overview
- Rbenv v RVM
- How rbenv works
- The rbenv Cookbook
- Gem Dependencies
-
Monit
- Which configuration goes where
- The importance of a custom monitoring configuration
- System level monitoring
- Monitoring Pids
- Monitoring Ports
- Free Space Monitoring
- Alerts and avoiding overload
- Serving the web interface with Nginx
-
nginx
- Overview
- Why Nginx
- The Cookbook
- Virtualhosts
- Monitoring
-
PostgreSQL
- Overview
- Installation
- Accessing the psql console
- Creating Databases
- Adding users to Databases
- Listing all databases and permissions
- Configuring Authentication
- Allow External Access
- Mangaging pg_hba.conf with chef
- Importing and Exporting Databases
- Monit
-
Redis and Memcached
- Redis
- Memcached
- Conclusion
-
Deploying with Capistrano Quickstart
- Overview
- Capistrano
- Steps
- Copying configuration to the destination server
- Conclusion
-
Deploying with Capistrano
- Overview
- Stages
- Upgrading from V2
- Adding Capistrano to an application
- Installation
- Capistrano 3 is Rake
- The Capfile
- Common configuration
- Running tests
- Hooks
- Setting up stages
- Generating Remote Configuration Files
- Database Credentials
- Deploying
- Conclusion
-
Writing Custom Capistrano Tasks
- Overview
- File Structure
- The Task
- A note on Namespacing
-
Unicorn Configuration and Zero Downtime Deployment
- Â Overview
- Unicorn and the request flow
- Basic Configuration
- Unix Signals
- Unicorn Init script
- Zero Downtime Deployment
- Gemfile Reloading
- Troubleshooting Process for Zero Downtime Deployment
-
Nginx Virtualhosts and SSL
- Overview
- A Basic Virtualhost
- DNS Overview
- Forcing HTTPS
- Adding SSL
- Chaining SSL Certificates
- Updating SSL Certificates
-
Sidekiq
- Â Overview
- Sidekiq Version 3
- Capistrano Integration
-
Backups
- Overview
- Structure
- Getting Started
- Triggering Backups with Whenever
- Conclusion
The Leanpub 45-day 100% Happiness Guarantee
Within 45 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms...