README.md

Mina-dotenv

⚫ 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 😋

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

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.

Pull

The pull task uses scp to retrieve the .env file from the server.

Note: It will take all configuration from your deploy.rb file!

Important: It will add the downloaded file to your .gitignore file!

It is intended to be used from the terminal like this:

mina dotenv:pull

Contribution

If you have ideas or feature requests please feel free to open an issue on this Github page. Pull requests are welcome also 😄