From 5810901e68d2c2e3813fb169c23fdbbba10893c9 Mon Sep 17 00:00:00 2001 From: Priit Tark Date: Mon, 16 Mar 2015 12:35:11 +0200 Subject: [PATCH] Added RBENV upgrade doc --- CHANGELOG.md | 2 +- doc/application_build_doc.md | 2 +- doc/debian_build_doc.md | 69 ++++++++++++++++++++---------------- 3 files changed, 40 insertions(+), 33 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index df7e8ae92..bf3ba9b79 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ 16.03.2015 -* ruby upgraded to version 2.2.1 +* ruby upgraded to version 2.2.1, added RBENV upgrade howto to debian doc at: doc/debian_build_doc.md 27.02.2015 diff --git a/doc/application_build_doc.md b/doc/application_build_doc.md index 53c93415b..79da11bcb 100644 --- a/doc/application_build_doc.md +++ b/doc/application_build_doc.md @@ -22,7 +22,7 @@ Deploy overview: (database schema should be loaded and seeds should be present) # at your local machine git clone git@github.com:internetee/registry.git cd registry - rbenv local 2.2.0 # more info about rbenv at debian doc + rbenv local 2.2.1 # more info about rbenv at debian doc gem install mina mina pr setup # one time, only creates missing directories ssh registry diff --git a/doc/debian_build_doc.md b/doc/debian_build_doc.md index c7531b504..c05814d0e 100644 --- a/doc/debian_build_doc.md +++ b/doc/debian_build_doc.md @@ -4,8 +4,46 @@ System build All systems should run on Debian 7 or newer, however officially Debian 7 is supported and tested. +### Manual build + +* Consider using [RBENV](https://github.com/sstephenson/rbenv) +* Compile requried [ruby version](https://github.com/internetee/registry/blob/master/.ruby-version) +* [Phusion passenger](https://www.phusionpassenger.com/documentation/Users%20guide%20Apache.html) +* [Postgresql](http://www.postgresql.org/docs/) + +Registry application is not tested with multi-threaded system (such as Puma) and +it's not officially supported. Please use multi-process system instead (Passenger, Unicorn, Mongrel) + +Use Phusion Passenger [official debian packages](https://www.phusionpassenger.com/documentation/Users%20guide%20Apache.html#install_on_debian_ubuntu) NB! Passenger runtime does not depend on ruby version, thus you can use multiple different ruby version apps with same passenger install. + +We also recommend to investigate +[Passenger Optimization Guide](https://www.phusionpassenger.com/documentation/ServerOptimizationGuide.html) for proper configuration. + + +### For building gem libs + +Please install following lib, otherwise your bundler install might not be successful. + + sudo apt-get install libxml2-dev + +### RBENV install + + cd /home/registry + git clone https://github.com/sstephenson/rbenv.git /home/registry/.rbenv + git clone https://github.com/sstephenson/ruby-build.git /home/registry/.rbenv/plugins/ruby-build + +### RBENV upgrade + + cd .rbenv + git pull origin master + cd plugins/ruby-build + git pull origin master + + ### Using babushka autoscripts +Alternatively you can build servers up using scripts such as babushka. + You can use or find ideas how to build up production servers using sysadmin tool [Babushka](https://github.com/benhoskings/babushka). @@ -27,34 +65,3 @@ Please inspect those scripts before running anything, they might not be complete or might have serious bugs. You are free to fork it. -### Manual build - -Alternatively you can build up everything manually, required components: - -* Consider using [RBENV](https://github.com/sstephenson/rbenv) -* Compile requried [ruby version](https://github.com/internetee/registry/blob/master/.ruby-version) -* [Phusion passenger](https://www.phusionpassenger.com/documentation/Users%20guide%20Apache.html) -* [Postgresql](http://www.postgresql.org/docs/) - -Registry application is not tested with multi-threaded system (such as Puma) and -it's not officially supported. Please use multi-process system instead (Passenger, Unicorn, Mongrel) - -Use Phusion Passenger [official debian packages](https://www.phusionpassenger.com/documentation/Users%20guide%20Apache.html#install_on_debian_ubuntu) NB! Passenger runtime does not depend on ruby version, thus you can use multiple different ruby version apps with same passenger install. - -We also recommend to investigate -[Passenger Optimization Guide](https://www.phusionpassenger.com/documentation/ServerOptimizationGuide.html) for proper configuration. - - -### For building gem libs - -Please install following lib, otherwise your bundler install might not be successful. - - sudo apt-get install libxml2-dev - - -### RBENV install - - cd /home/registry - git clone https://github.com/sstephenson/rbenv.git /home/registry/.rbenv - git clone https://github.com/sstephenson/ruby-build.git /home/registry/.rbenv/plugins/ruby-build -