Changeset 402

Show
Ignore:
Timestamp:
02/16/08 00:41:23 (11 months ago)
Author:
mbailey
Message:

further explanation of configs

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/docs/ANNOUNCE.deprec2

    r153 r402  
    22 
    33deprec2 has a two stage process for generating/deploying configuration files. 
    4 Configuration files for web, app, db servers (and more) are generated from templates and put under the config/ tree in your Rails apps source tree. The second stage is pushing the files out to the destination servers. This used to be a one stage process in deprec1 however the change has been made so that: 
     4Configuration files for web, app, db servers (and more) are generated from  
     5templates and put under the config/ tree in your Rails apps source tree.  
     6Alternatively you could create a non-rails-app tree to hold them. The second  
     7stage is pushing the files out to the destination servers. This used to be a  
     8one stage process in deprec1 however the change has been made so that: 
    59 
    610- all config files for a project can be kept under source control 
    711- you can make changes to config files that are not available through deprec 
    812 
    9 Many of the settings in these config files are based on values in the projects deploy.rb file. Others reflect defaults in deprec that you can override by adding fields to deploy.rb. This means you may never need to edit the generated config files directly. You can generate a set of config files with the following. 
     13Many of the settings in these config files are based on values in the projects  
     14deploy.rb file. Others reflect defaults in deprec that you can override by adding  
     15fields to deploy.rb. This means you may never need to edit the generated config  
     16files directly. You can generate a set of config files with the following: 
    1017 
    11 > cap deprec:trac:config_gen # generates config files for trac from templates 
     18        cap deprec:nginx:config_gen # generates config files for trac from templates 
     19         
     20config_gen is re-runnable and will prompt you before overwriting a file. It will 
     21also show you what changes overwriting would make (in diff format) to help you 
     22decide whether you want it to do so. 
    1223 
    13 Changes to service configuration should never be done on the server. Deprec acknowledges this by offering no assistance to people who want to copy config files back from servers. But pushing the files out couldn't be simpler! 
     24Changes to service configuration should never be made on the server. Deprec  
     25acknowledges this by offering no assistance to people who want to copy config  
     26files back from servers. But pushing the files out couldn't be simpler! 
    1427 
    15 > cap deprec:trac:config # pushes out all config files for trac 
     28        cap deprec:nginx:config # pushes out all config files for trac 
     29 
     30deprec2 takes into consideration the fact that that some services are used to  
     31host more than one application. For example, a webserver will often have one  
     32main configuration and a number of virtual host configurations. Monit has a 
     33single config file (/etc/monitrc) but will also load other configs it finds in 
     34a certain directory (/etc/monit.d). 
     35 
     36When you deploy a Ruby on Rails app with deprec it drops configs for your project 
     37into the config/ directory for your project and symlinks them into a shared path 
     38on the server. This means you can install multiple apps on a remote server and  
     39they shouldn't stop on each other.  
     40         
     41== Extra services 
     42 
     43- nginx 
     44- monit 
     45- postfix 
     46- nagios 
     47- more...