How to Use Custom Version of Terraspace

If you want or need to run a forked version of terraspace, here’s how:

Change Version Number

First, clone down the source and change version number so you can identify that it’s a custom version. Clone down the project:

$ git clone https://github.com/boltops-tools/terraspace

Update lib/terraspace/version.rb so you’ll be able to tell that it’s a custom build. For example:

module Terraspace
  VERSION = "0.6.22.custom"
end

There are 2 ways to use the custom version:

  1. Gemfile: Forked Git Source
  2. Gem Package: Build and Install

Gemfile: Forked Git Source

Point terraspace to use your repo with the forked version. Example:

Gemfile:

source "https://rubygems.org"
gem 'terraspace', git: 'https://github.com/REPO/terraspace', branch: "master"

Remember to change REPO, to your repo name.

Then run:

bundle

Gem Package: Build and Install

Build the gem package:

$ bundle
$ rake build
pkg/terraspace-0.6.22.custom.gem

The produced .gem file can used to install the gem. You can install it locally:

$ gem install pkg/terraspace-0.6.22.custom.gem
$ terraspace -v
0.6.22.custom

Or on any machine with Ruby installed. You can copy it to the machine, ssh into it, and install the custom gem:

$ scp pkg/terraspace-0.6.22.custom.gem user@server.com:
$ ssh user@server.com
$ gem install terraspace-0.6.22.custom.gem
$ terraspace -v
0.6.22.custom

Contributing

Learning how to run a forked version of terraspace allows you to make changes to the framework. Consider improving terraspace by submitting a Pull Request. See: Contributing.

In this section:

    More tools: