document how to create custom rails environments

This commit is contained in:
Yves Senn 2013-01-21 20:38:04 +01:00
parent 5984894fc9
commit 7e6e4f2547
2 changed files with 8 additions and 1 deletions

@ -594,4 +594,4 @@ Before the interceptor can do its job you need to register it with the Action Ma
ActionMailer::Base.register_interceptor(SandboxEmailInterceptor) if Rails.env.staging?
```
NOTE: The example above uses a custom environment called "staging" for a production like server but for testing purposes.
NOTE: The example above uses a custom environment called "staging" for a production like server but for testing purposes. You can read [Creating Rails environments](./configuring.html#creating-rails-environments) for more information about custom Rails environments.

@ -552,6 +552,13 @@ development:
Change the username and password in the `development` section as appropriate.
### Creating Rails environments
By default Rails ships with three environments (production, development and test). While these are sufficient for most use cases, there are circumstances when you want more environments. Imagine you have a server, which mirrors the production environment but is only used for testing. You can create a separate environment for this server by creating a file called `config/environments/staging.rb`. This will create a new environment called "staging". You can use the contents of any existing file in `config/environments` as a starting point and make the necessary changes from there.
After you created the environment file you can now start a server with `rails server -e staging` or a console with `rails console staging`
Rails Environment Settings
--------------------------