FromScratch
I'm sick and tired of thousands of articles "How to setup Rails app server". Here is your last command to do that.
No configs, no questions. Just ~~one ring to rule them all~~ one command to get fully functional server with best security practices ready for first cap production deploy
.
Usage
$ gem install from-scratch
$ scratchify your_app_name your.host.com
And everything is done. Then add following to your config/deploy.rb
or config/deploy/production.rb
for Capistrano:
server 'your.host.com', user: 'deploy', roles: %w(app db web)
set :deploy_to, "/home/deploy/#{fetch(:application)}"
Supports
OS:
- APT-based Linux (Ubuntu, Debian)
- YUM-based Linux (RedHat, CentOS)
Ruby installers:
- RVM (default)
- rbenv:
scratchify your_app_name your.host.com --rbenv
Setting specific ruby version:
$ scratchify your_app_name your.host.com --ruby jruby-1.7.19
It's a kind of magic!
Not actully. Just preconfigured Chef. Here are the things done with the command:
- Install user-wide RVM with latest MRI (2.2.4)
- Install PostgreSQL, create database with user, pg_tune a little
- Add deploy non-admin user to system specially for your app, upload your SSH pub key to it
- Install nginx and replace it's default site config with one prepared for rails app
- Generate app folder inside deploy's home and generate
database.yml
andsecrets.yml
Things you need to know
Nginx config is set up to connect to unix socket placed at /home/deploy/your_app_name/shared/tmp/sockets/application.sock
. Change it manually or config your favorite app server (Puma, Unicorn, Thin etc) to place it's socket there.
You can just ssh [email protected]
because your SSH pub key is already there.
Both postgres
and your_app_name
DB users get (different) randomly generated passwords. You can see app-user password inside config/database.yml
, but postgres
password is not saved anywhere. If you need admin access to your PostgreSQL, then you should SSH as root and:
# su - postgres
$ psql
Development
Feel free to create bug-reports and feature-requests here on Issues page
Contributing
All help is highly appreciated. I'll be thankful for recipes fixes and advices as well as new features implementations. Just fork and pull-request when you have some proposals.
License
The gem is available as open source under the terms of the MIT License.