This document describes how to use the Ruby 2 feature on Engine Yard.
Get started with Ruby 2 on Engine Yard
Prerequisites
- This article assumes you already have an Engine Yard account. If not, see Sign up for an Engine Yard Account.
- To use Ruby 2 in your environment, you must use the Engine Yard Gentoo 12.11 stack option (stable-v4).
- Your environment must include other component versions as described in the Engine Yard Gentoo 12.11 Tech Stack.
- You must use 64-bit instances (32-bit instances are not supported on this distribution).
-
In order to deploy your app, you must use the engineyard gem (2.1.0.rc1 or newer) with this feature.
The engineyard gem can be installed by running:
gem install engineyard
For more information, see the Engine Yard gem repo on GitHub.
Note: If you aren't sure which version of the engineyard gem you have installed, you can check with:
$ ey --version
engineyard version 2.1.0.rc1
Use Ruby 2 with Engine Yard
Important: We recommend testing in a staging environment before applying changes in a production environment.
To deploy a new app using Ruby 2
-
Ensure that your app meets all the prerequisites above.
-
Create your application in the usual way.
Note: Your stack selections should be on the Engine Yard Gentoo 12.11 Tech Stack.
-
Create a new environment in the usual way.
Note: Your stack selections should be on the Engine Yard Gentoo 12.11 Tech Stack.
-
Select the new Gentoo 12.11 Stack: stable-v4.
This displays the configuration choices for your Engine Yard Gentoo 12.11 environment.
-
Select the Ruby 2 Runtime that you need.
-
On the Configuration page, select the environment setup you need.
-
Click Boot this Configuration.
Your Engine Yard Gentoo 12.11 environment starts up with Ruby 2 runtime.
More Information
These other resources might help you:
| For more information about ... | See ... |
|---|---|
| Ruby 2 releases | Ruby release news |
| Engine Yard gem | Engine Yard gem change log |
| Engine Yard Gem 2.0 blog | Deploying with engineyard gem version 2.0 |
| Engine Yard Gem 2.3 blog | Deploying with engineyard gem version 2.3 |
| Migrate Ruby | Migrate to the Latest Ruby Version |
If you have feedback or questions about this page, add a comment below. If you need help, submit a ticket with Engine Yard Support.
When will we be able to upgrade existing stacks?
Hi Vincent, please confirm: are you talking about upgrading from the Engine Yard Gentoo (stable-v2) to the Engine Yard Gentoo 12.11 (stable-v4) stack? Or are you referring to a different migration? thanks, kjm
The original Ruby doc had a prereq about upgrading due to most customers being on Engine Yard Gentoo 2009 (stable-v2) at that time. FYI: The docs describing migrating from Engine Yard Gentoo 2009 to Engine Yard Gentoo 12.11 (stable-v4) are:
Simple migration
and
Custom migration
If you are already on Engine Yard Gentoo 12.11 (stable-v4), upgrading Ruby should be fine.
As always, if you have any questions or concerns, our awesome Support team is happy to help. kjm
Check out the new Upgrade docs here: https://support.cloud.engineyard.com/forums/23079056-Upgrade-Center
If you want to upgrade Ruby: https://support.cloud.engineyard.com/entries/21214371-Upgrade-to-the-Latest-Ruby-Version