README

This is a quick example repo to show one possible method for setting up a rails app to be deployed using Habitat without needing to duplicate configs or rails application code for each service that is being run.

Requirements

• Ruby 2.6
• Rails 6
• Habitat

Layout

The application is setup like a typical Rails application with a couple of exceptions:

• components/ - Contains the various habitat plans necessary for building and deploying the application

Deployment

Deployment is handled via habitat packages.

Install habitat

curl https://raw.githubusercontent.com/habitat-sh/habitat/master/components/hab/install.sh | sudo bash

If you have never configured habitat before be sure to follow the instructions at https://habitat.sh on how to get started.

Building hab packages

cd /path/to/application
hab studio enter
build components/yarn
build components/supersite
build components/supersite-db
build components/supersite-web
build components/supersite-worker

Setup configs

To configure the rails app a few config values need to be setup. This would be for handling settings the decryption key master_key for the rails secrets or specifying a DATABASE_URL for connecting to an external database

First setup the master_key for decrypting rails secrets

• Create a config.toml with the following contents

  [web]
  master_key = "SOME MASTER KEY"
  

• Apply the config

  hab config apply supersite.default $(date +%s) config.toml

Starting services

hab svc load will/supersite-db
hab svc load will/supersite --bind database:supersite-db -s at-once
hab svc load will/supersite-web -s at-once
hab svc load will/supersite-worker -s at-once

Accessing the rails console

hab pkg exec will/supersite rails c