Convox Community

Sharing a Ruby gem I've written to streamline Convox installations

Hi everyone,

I wanted to share a Ruby gem I’ve been working on, which makes it easier to build a convox installation workflow.

The gem is called convox_installer, and you can include it in a single Ruby file with bundler/inline. So you can have an install.rb script that starts like this:

#!/usr/bin/env ruby
require 'bundler/inline'

gemfile do
  source 'https://rubygems.org'
  gem 'convox_installer'
end

require "convox_installer"
include ConvoxInstaller

# Your installation script here

Including the ConvoxInstaller module gives you some Ruby methods you can call to perform various operations. These methods are all documented in the README.

Here’s a full example of a Convox install script, which includes some custom config prompts, CORS settings for an S3 bucket, setting ENV vars, data setup and seeding, health check upgrade flow, and a final summary that you can customize for your users.

Please check it out, and I hope someone finds this useful!

Many thanks to the Convox devs for the awesome convox/rack and CLI tool. This is a really awesome and easy way to get open source projects or on-premise deployments set up on your own AWS infrastructure.

2 Likes

Really nice idea! :grin: