Mina-dotenv

:black_circle: Dotenv plugin for mina.

Alleviate the need to SSH to your server and setup an .env file manually there. This plugin simply copies your local .env to your server :yum:

Installation

To use it in your project's deployment process install this gem with the following command:

gem install mina-dotenv

Add the following line to your deploy.rb script:

require 'mina/dotenv'

This enables you to use the dotenv:push task in your deploy script.

To automatically push your .env file to the server add this line to your deploy task:

invoke :'dotenv:push'

Configuration

Your development machine and your server will often need different keys to run your app. Therefore a :dotenv_location variable exist to define which .env file to push to the server.

Important: The :dotenv_location defaults to .env

To change which .env file to push add this line your deploy.rb file:

set :dotenv_location, '.server_env'

Example deploy script

require 'mina/bundler'
require 'mina/rails'
require 'mina/git'
require 'mina/rbenv'
require 'mina/dotenv' # <---- Added this line

set :domain, 'my-page.com'
set :deploy_to, '/home/deploy/www/...'
set :repository, 'https://github.com/...'
set :branch, 'master'
set :dotenv_location, '.server_env' # <--- Added this line

...

desc "Deploys the current version to the server."
task :deploy => :environment do
  to :before_hook do
  end

  deploy do
    invoke :'git:clone'
    invoke :'deploy:link_shared_paths'
    invoke :'dotenv:push' # <----- Added this line
    invoke :'bundle:install'
    invoke :'rails:assets_precompile'
    invoke :'deploy:cleanup'

    to :launch do
      queue "mkdir -p #{deploy_to}/#{current_path}/tmp/"
      queue "touch #{deploy_to}/#{current_path}/tmp/restart.txt"
    end
  end
end

What it does

Tasks

Push

The push task will look for the '.env' file specified in the :dotenv_location variable. If found it will copy it's content and echo it to an .env file located in the shared folder location you your app's deploy location. And symlink it to the root of the newest release.

If no local .env file is found a blank one will be created on the server.