We’ve now got Ubuntu Hardy and Lucid packages available on our apt repository and we consider it ready for production use. Brightbox customers can upgrade from Passengr 2.x simply by running these commands on their Brightboxes:

sudo apt-get update
sudo apt-get install -qy libapache2-mod-passenger

If you’ve not got a Brightbox, you’ll need to add our apt repository key and config first. You can read more about it on our wiki.

We now have Passenger 3.0.0-pre3 packages available for Ubuntu 10.04 (Lucid) and Ubuntu 8.04 (Hardy). As they’re pre-release versions, we don’t recommend them in production just yet and have put them in their own repository to prevent any accidental upgrades.

If you’re not already a Brightbox customer, then you’ll need to set up base access to our apt repository first.

Otherwise, just add the new passenger-testing repository (switch “lucid” to “hardy” if you’re on Hardy):

sudo sh -c 'echo "deb http://apt.brightbox.net lucid passenger-testing" > /etc/apt/sources.list.d/brightbox-passenger-testing.list'

Then you can upgrade/install 3.0.0-1bbox1~pre3

apt-get update
apt-get install libapache2-mod-passenger

Passenger now has a native library, which depends on your version of ruby. For simplicity, these packages currently require the ruby1.8 packages to be installed. You can, of course, switch to ruby1.9 and passenger will auto-compile the necessary native support for you. We’ll be providing packages for 1.9 support soon, so you won’t need to rely on the auto-compiling.

Now, whenever a new box is deployed, the SSH keys of all the technical contacts on your Brightbox account are automatically pre-installed for the default ‘rails’ user. To add your own SSH key, edit your user profile within the control panel and paste in your SSH public key using the editor at the bottom.

Remember, this only affects newly provisioned boxes – as the it’s done during the box build stage. Removing or adding technical contacts in the control panel at a later date will not automatically change any access control on existing boxes.

We’ve built our Ubuntu Hardy packages for i386 and AMD64 architectures which are now available from the Brightbox apt repository.  We’ve also upgraded our librack-ruby packages to 1.1.0.

Today I’m pleased to announce a new revision of the Brightbox Deployment Gem, version 2.3.6. This release fixes some of the issues reported to us by our users, along with a few extra features.

The documentation on the wiki has been updated with the new fixes and features. If you have any tips or find any errors just let us know.

NEW FEATURES

Apt Package Dependencies

Just as you can currently define gems your application relies on and have them automatically installed onto your servers, you can now do the same with apt packages. Define them in your deploy.rb and they’ll be installed before installing your required rubygems, which means you can use it to install apt packages that gems depend on. As an example, the nokogiri gem depends on a couple of apt packages.

depend :remote, :apt, "libxml2-dev"
depend :remote, :apt, "libxslt1-dev"
depend :remote, :gem, "nokogiri", ">= 0"

Intermediate SSL Certificates

Support for Intermediate SSL Certificates in Apache has been added, meaning you no longer need to manually edit the Apache config files directly. Just add one line to your deploy.rb and the gem now takes care of updating the Apache config for you. An example SSL configuration:

set :ssl_certificate, "my_cert.pem"
set :ssl_key, "my_cert.key"
set :ssl_intermediate, "intermediate.crt"

See the wiki page for Adding SSL Support to Apache for more information.

Deploy.local.rb

A common issue we’ve seen with is setting the deploy password. If you put it in deploy.rb, then it inevitably ends up in your source control repository, which is a bad idea. A workaround we’ve suggested in the past is to have a deploy.local.rb file, which isn’t tracked by source control, and load that from within your deploy.rb file. This allows you to have the password (or any other sensitive settings) defined, but kept outside your source control.

As part of this release, the gem now has official support for a deploy.local.rb file. If it exists, the gem will load it in for you.

For more information see the Advanced Gem Settings page on the wiki.

Disable (re)generating webserver config

If you’ve made manual changes to your webserver (apache or nginx) configuration, then you don’t want an accidental deploy:setup to overwrite your configs. Up until now you just had to avoid running the command, but now there’s a setting to disable it for you.

set :generate_webserver_config, false

FIXES AND ENHANCEMENTS

• Max Age setting now accepts a number as well as a string
• deploy:initial reloads Apache so the new config is loaded

This package won’t actually support Rails 3 just yet though as we’ve yet to package and test the librack 1.1.0, which Rails 3 depends on.  We’re working on it now and once we’re happy with it we’ll add new packages to our repository as usual.

As usual, details on installing the packages from our repository are available on our wiki.

If you’re using Passenger and it’s making you happy, please do consider supporting its development by donating money in the form of an “Enterprise License” direct from Phusion, the company behind it.

We’ve had to restructure the way our Ubuntu packages are built to enable installation of the NGINX extension, so needs more extensive testing than usual.  The packages are now available for Ubuntu Hardy in our testing repository.

You’ll need to add our testing repository to your apt sources list. And if you’re not on a Brightbox, you’ll need to import our key and add our stable repository too.

Once you’ve done that, you can install the new version of Passenger.  If you’re wanting to just install the Apache version:

sudo apt-get update
sudo apt-get install libapache2-mod-passenger

This will pull in a new dependency, passenger-common.

If you just want to get stuck in with the new NGINX support, install the nginx-brightbox package:

sudo apt-get update
sudo apt-get install nginx-brightbox

This will also pull in the passenger-common dependency. This is NGINX 0.6.36 plus some useful modules: upload progress, upstream fair, geoip, ey-balancer and access key. It will replace any other NGINX packages you have installed (NGINX does not support dynamic modules like Apache).

You can install both Apache and NGINX side by side, but you’ll obviously need to run them on different ports.

The 2.2.1 Apache package has already had quite a bit of testing by us, but the NGINX package has had very little. We’ve already come across a Passenger bug with reloading NGINX (reported here), though we expect this will be fixed quickly.  So basically, these are good to play with but not for production just yet.

If you need any help with these packages, try our Passenger support forum.

The details are on the usual page on our wiki.  If you have any problems or need any help, try our forums.

The new packages depend on new versions of the Ruby rack libraries (not the gem), but this is provided in our repository too and will be automatically installed. You need to install the fastthread gem yourself though.  Our repository provides a few other useful Hardy packages too.

We are only testing our packages against Ubuntu Hardy right now, but they should install and run fine on newer versions of Ubuntu too.

Remember, for maximum memory savings (and speed improvements) try our Ruby Enterprise Edition packages for Ubuntu Hardy (currently only 32bit packages available).

Version 2.3 of the gem fixes some issues reported to us by our users. A quick summary of the changes from the release notes:

• Removed the Capistrano task which calls the db:check:config rake task. This task was introduced to help with a common config mistake, but just resulted in a different mistake becoming common.
• Removed the Capistrano task which calls rake gems:install. Running this as sudo was causing some permissions errors caused by initialising the Rails stack as root.
• Fixed how we track the commands the gem depends upon, the deploy:check command now works as expected.
• Gem dependencies are now installed by listing them in deploy.rb, extra examples have been added to the boilerplate deploy file.

The change in the way we handle gem dependencies was the reasoning behind making this a minor version release. Previously we simply called the inbuilt Rails 2.2 gem install task.  However we found some issues where customers with fresh deployments when running this command as root would result in files being created that could not then be removed during subsequent deployments. We took the decision to use the inbuilt capistrano dependencies to handle the installation of remote gems (examples are available inside the deploy.rb that the brightbox command automatically generates for you).

Update 24/2/2009: We’ve just pushed a new version, 2.3.2 that changes slightly how the gem dependencies work. You now specify a dependency with an alternate source in your deploy.rb like this:

depend :remote, :gem, "tmm1-amqp", ">=0.6.0", :source => "http://gems.github.com"

We’re now also providing 64bit versions of the packages (the source of the 404 errors some of you reported when trying to install the package).

Documentation for the packages in the usual place on the wiki.

More Passenger news coming soon :)

The quick answer is (stop press) within the next few weeks. Read on for the longer version :)

There are a couple of things we need to do before “officially” supporting Passenger on Brightbox…

1. We need to complete the packaging of Ruby Enterprise Edition for Ubuntu Hardy (which John is working on right now)
2. We need to update the Brightbox gem to support deployment and management with Passenger – as well as Apache/Mongrel and Nginx/Mongrel (which it will continue to do).

Neither of these are particulary mammoth tasks, but we do have a lot of internal projects going on at the same time such as improving the control panel (watch this space) as well as the day-to-day work of running a hosting company and managing clusters for some very large customers [plug].

Stay tuned over the next few weeks as we announce Passenger support together with a very special discount offer!

Why not join our announcements list to stay up to date?

We’re proud to announce the beta version of our new Brightbox deployment gem. It is available from the Brightbox gem testing repository at http://gems.brightbox.net/testing. You can add this repository to your list by following these instructions.

This gem is a complete rewrite, to take advantage of the latest features of Capistrano and Rails. The Gem works with the current version of Capistrano (2.3) and supports the deployment of Rails 2.x applications.

FEATURES

Deploy with a single command

You can deploy a Rails application onto the Brightbox system with a single command (deploy:initial). We’ve tried to reduce the amount of work required to get an application working. You can follow our simplified initial deployment guide on our wiki

Focus on new deployment

The Brightbox gem is designed to allow you to quickly deploy an application to your new Brightbox. We’ve created sensible defaults for many of the Brightbox command options, and trimmed as much of the fat as we can from the deployment process. But because the gem generates Capistrano files you can tailor this starting point to your exact needs using the full power of Capistrano.

Deploy your working copy

The gem uses the new ‘:none’ scm option in Capistrano that simply zips up the current directory and deploys it on the server. No more messing around with version control security until you’re ready. Just deploy and go.

Automatically creates database configuration

The standard ‘mysql’ command allows you to put the database, username and password in a file called ‘.my.cnf’ in the ‘rails’ user home directory on the server. The mysql command will then read that file and logon to the database directly. If your application is short of a ‘production’ section in its config/database.yml then the recipes will take the contents of ‘.my.cnf’ and create a production section dynamically.

Automatically creates databases and gems

Rails now has rake commands for creating databases and installing required gems. Where these are available the recipes will use them automatically. For Rails 2.0 users we’ve created a simple ‘stop gap’ rake task that you can use to specify your required gems.

Separate server and client gems

Once the gem is released all new brightboxes will come with the server gem preinstalled. For older boxes you will need to install the server tools manually. Log into your brightbox and run:

sudo gem install brightbox-server-tools -y --no-ri --no-rdoc

Logs Rotated

The gem asks the operating system to monitor the size of the application logs and rotate them when they get too big or too old. No longer should a neglected log file bring your server to its knees.

Mongrels Cleaned

Mongrel tend to be dirty when it falls over and leaves PID files lying around to trap the unwary. The new gem cleans up dirty PID files before it restarts.

Works alongside Capistrano

We’ve simplified the recipes so that, wherever possible, they augment the existing Capistrano deployment commands we all know and love rather than replacing them. That way your deployments gain the benefits of Capistrano improvements as well as improvements in the Brightbox gem. Free software at its best.

NOW WE NEED YOUR HELP!

We’d like as many Brightbox customers to use the new gem and let us know what they think of it so that we can hone it to perfection. Please give it a go and then pop along to our Brightbox Beta discussion group (http://groups.google.com/group/brightbox-beta) and let us know any feedback or problems.