Paste this code to create some basic starting application myapp.com with authentication and other funny tools. I extensively use echo sed grep commands here.

give a man a fish and you feed him for a day. teach a man to fish and you feed him for a lifetime

RVM and other tools

If you do not have rails or git you need to install

command curl -sSL https://rvm.io/mpapis.asc | gpg --import -
command curl -sSL https://rvm.io/pkuczynski.asc | gpg --import -

\curl -sSL https://get.rvm.io | bash
# \curl -sSL https://get.rvm.io | bash -s stable --ruby
rvm install 2.3.0
gem install bundle

sudo apt install git postgresql libpq-dev nodejs

Initial commit

You can choose database with rails param rails new myapp --database=postgresql You can also create .railsrc so it is used for all rails but that is not so obvious.

cat >> ~/.railsrc << HERE_DOC
-d postgresql # use postgresql
HERE_DOC

For existing apps you can change database from sqlite to postgres with one command

rails db:system:change --to=postgresql

Create new app

rails new myapp
# to specify version you can use
rails _5.2.1_ new myapp
cd myapp
rails db:create
git init . && git add . && git commit -m "rails new myapp"

There is no option like --skip-helper but we can configure that in

# config/initializers/generators.rb
Rails.application.config.generators do |g|
  g.helper false
end

You can start from template for devise and i18n https://github.com/duleorlovic/devise-views-i18n

UUID

https://github.com/trkin/contact_form/commit/52532f3378604f59fb16c1e6432cc567542c391d

bin/rails g migration enable_extension_for_uuid
last_migration
# add following line to migration
  def change
    # if you do not have priviledged deploy user than run as root
    # sudo su - postgres; psql ; CREATE EXTENSION pgcrypto;
    enable_extension 'pgcrypto' unless extension_enabled?('pgcrypto')
  end

cat >> config/initializers/generators.rb << HERE_DOC
Rails.application.config.generators do |g|
  g.orm :active_record, primary_key_type: :uuid
end
HERE_DOC

rake db:create db:migrate
git add .
git commit -m 'Enable uuid in postgresql'

Later, if you add some references, you need to specify type: :uuid like:

  t.references :post, type: :uuid, index: true

or error will be raised:

DETAIL:  Key columns "post_id" and "id" are of incompatible types: bigint and uuid.

Note that ordering by id, uuid is not possible. It is hard to implement on existing projects and on MySQL db.

Sample page

rails g controller pages index --no-stylesheets --no-helper --no-assets --no-jbuilder

sed -i "" -e '/^end$/i \
  # root page\
  root "pages#index"\
' config/routes.rb

Rubocop cli

rubocop --auto-correct # to autocorrent correct some files (except lineLength)
# initial scale on mobile devices
sed -i app/views/layouts/application.html.erb -e '/title/a \
    <meta content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no" name="viewport">'

Font icons

Fontello provides a icons which you can include in your project using https://github.com/railslove/fontello_rails_converter Main file is config.json where each icon is listed. You can import that file to http://fontello.com/ and than icons are shared between sessions. There is tmp/fontello_session_id which is used to open and convert from browser

# Gemfile
# pick icons
gem 'fontello_rails_converter'

# select some fonts http://fontello.com/ and download zip to `tmp/fontello.zip`
bundle exec fontello convert --no-download
# restart rails server and open http://localhost:3000/fontello-demo.html
gnome-open http://localhost:300`expr $(get_current_viewport) + 1`/fontello-demo.html

# when you want to update you can
fontello open
# select new icons
bundle exec fontello convert

To configure in rails you need to import

# app/assets/stylesheets/application.sass
// vendor
@import 'fontello'

And use with classes

# app/layouts/application.html.erb
<i class="demo-icon icon-mobile"></i>

Using in node, you need to download config.json npm install fontello-cli -g. First you need to download one config.json file, and you can open session page

fontello-cli --config fontello/config.json open

You can download package and extract to /fontello or you can download config.json and copy and install (in this case it will not update demo.html)

cp ~/Downloads/config.json fontello/
fontello-cli --config fontello/config.json install

To see local previews you can also

gnome-open fontello/demo.html

Prepare icons https://github.com/fontello/fontello/wiki/How-to-use-custom-images#preparing-images-in-inkscape

Gitignore

cat >> .gitignore << 'HERE_DOC'
# vim temp files
*.swp
*.swo
# carrierwave upload files
/public/uploads
# gedit files
*~
# vagrant files
.vagrant
# byebug
.byebug_history
# rspec temporary file
spec/examples.txt
HERE_DOC
git commit -am "Update .gitignore"

Gemfile development & production tools

Some of the gems could be found on thoughtbot suspenders Paid 3th party service alternative for bullet is scoutapp, for exception_notification is sentry, informantapp.

cat >> Gemfile << HERE_DOC
group :development do
  # pretty print Ruby objects in full color
  gem 'awesome_print', require: 'ap'
  # static analysis security vulnerability scanner, run: `brakeman`
  gem 'brakeman', '~> 3.5.0', require: false
  # detect N+1 sql queries
  gem 'bullet'
  # detect out-of-date or vulnerable gems, run: `gemsurance`
  gem 'gemsurance'
  # automatic reload
  gem 'guard-livereload', require: false
  # open emails in browser
  gem 'letter_opener'
  # detect file changes
  gem 'listen', '~> 3.0.5'
  # support for Rails Panel - chrome extension
  gem 'meta_request'
  # debugger
  gem 'pry'
  gem 'pry-rails'
  # ruby static code analyzer
  gem 'rubocop', require: false
  # spring speeds up development by keeping your application running in the
  # background. Read more: https://github.com/rails/spring
  gem 'spring'
  gem 'spring-watcher-listen', '~> 2.0.0'
HERE_DOC

Some not used gems

  # do not show assets in log\
  # gem "quiet_assets # can not find rails 5 version"\

  # irbtools includes interactive_editor gem (vim inside irb)\
  # just create ~/.irbrc with\
  # require "rubygems"\
  # require "irbtools"\
  gem "irbtools", require: "irbtools/binding"\

  # is not needed since rails will show line on which there is
  # exception (no need to insert console and use on web page).
  gem better_errors

  # Access an interactive console on exception pages or by calling 'console' anywhere in the code.
  gem 'web-console', '>= 3.3.0'

  # config/application.rb
  # run with rails s -p b 0.0.0.0 to allow local network, allow remote requests\
  config.web_console.whiny_requests = false'

Production gems and configurations

cat >> Gemfile << HERE_DOC
# adding vendor prefixes to css rules
gem "autoprefixer-rails"

# sets timezone based on browser timezone for each request
gem "browser-timezone-rails"
HERE_DOC

# need some js for timezone
cat >> app/assets/javascripts/application.js << HERE_DOC
//= require js.cookie
//= require jstz
//= require browser_timezone_rails/set_time_zone
HERE_DOC

bundle
guard init livereload
# gem https://github.com/guard/guard-livereload suggest some old extension
# https://addons.mozilla.org/en-US/firefox/addon/livereload/ but there is new
# https://addons.mozilla.org/en-US/firefox/addon/livereload-web-extension
# or you can use rack-livereload
# I receive error No such middleware to insert before: ActionDispatch::Static
# so better is to use browser plugin instead of gem 'rack-livereload'
# sed -i config/environments/development.rb -e '/^end/i \
#   # livereload\
#   # use rack-livereload or browser extension\
#   # if guard is not running, there is an error in js console:\
#   # Cross-origin plugin content from  must have a visible size larger than 400 x\
#   # 300 pixels, or it will be blocked. Invisible content is always blocked.\
#   config.middleware.insert_after ActionDispatch::Static, Rack::LiveReload\
# '

When I get error with command
RAILS_ENV=production rails assets:precompile
 No such middleware to insert before: ActionDispatch::Static
Than solution is to add `gem 'rails_12factor`, group: :production`
https://github.com/AssetSync/asset_sync/issues/221#issuecomment-75492905


cat > config/initializers/bullet.rb << HERE_DOC
if defined? Bullet
  Bullet.enable = true
  Bullet.alert = true
  Bullet.rails_logger = true
end
HERE_DOC

git add . && git commit -m "Adding guard and other useful gems"

# to run guard live reload, first increase max watches than just run guard
# https://github.com/guard/listen/wiki/Increasing-the-amount-of-inotify-watchers
# echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo
sysctl -p
guard -d
# livereload debug with `guard -d`. Error if you also run it on another project
# there should not be eventmachine.rb:530:in `start_tcp_server': no acceptor (port is in use or requires root privileges) (RuntimeError)

Customize log output of rails logger in production with https://github.com/roidrage/lograge#handle-actioncontrollerroutingerror

Fonts

Copy definition from node_modules css files where font-face is defined, and change from url to asset-url

npm install typeface-roboto
mkdir app/assets/stylesheets/plugins
cat >> app/assets/stylesheets/plugins << HERE_DOC
@font-face {
  font-family: 'Roboto';
  font-style: normal;
  font-weight: 400;
  src: local('Roboto Regular'), local('Roboto-Regular'), asset-url('typeface-roboto/files/roboto-latin-400.woff') format('woff'), asset-url('typeface-roboto/files/roboto-latin-400.woff2') format('woff2');
}
@font-face {
  font-family: 'Roboto';
  font-style: normal;
  font-weight: 500;
  src: local('Roboto Medium'), local('Roboto-Medium'), asset-url('typeface-roboto/files/roboto-latin-500.woff') format('woff'), asset-url('typeface-roboto/files/roboto-latin-500.woff2') format('woff2');
}
@font-face {
  font-family: 'Roboto';
  font-style: normal;
  font-weight: 600;
  src: local('Roboto SemiBold'), local('Roboto-SemiBold'), asset-url('typeface-roboto/files/roboto-latin-500.woff') format('woff'), asset-url('typeface-roboto/files/roboto-latin-500.woff2') format('woff2');
}
@font-face {
  font-family: 'Roboto';
  font-style: normal;
  font-weight: 700;
  src: local('Roboto Bold'), local('Roboto-Bold'), asset-url('typeface-roboto/files/roboto-latin-700.woff') format('woff'), asset-url('typeface-roboto/files/roboto-latin-700.woff2') format('woff2');
}
HERE_DOC

cat >> app/assets/stylesheets/application.sass << HERE_DOC
// plugins
@import 'plugins/roboto_font_face'
HERE_DOC

cat >> app/assets/stylesheets/common/body.sass << HERE_DOC
body
  font-family: 'Roboto', sans-serif
HERE_DOC

Adding flash (both from server and client)

You can use text-center bootstrap helper (ie text-align: center;). Also the collors

sed -i app/views/layouts/application.html.erb -e '/yield/c \
  <div class="text-center">\
    <span class="notice text-success" id="notice"></span>\
    <span class="alert text-danger" id="alert"></span>\
  </div>\
  <script>\
    <%=raw "flash_message(document.getElementById('notice'), '#{j notice}');" if notice %>\
    <%=raw "flash_message(document.getElementById('alert'), '#{j alert}');" if alert %>\
  </script>\
\
  <article>\
    <%= yield %>\
  </article>'

cat > app/assets/javascripts/main.js.erb << 'HERE_DOC'
var FLASH_LETTER_STEP = 10;
var FLASH_DURATION = 5000;
function flash_appear(element, message, i) {
  if (i == undefined)
    i = 0;
  element.innerText = message.substring(0,i);
   setTimeout(function(){ 
    if (i<message.length)
      flash_appear(element, message, i+1);
  }, FLASH_LETTER_STEP);
}
function flash_dissapear(element, message, i) {
  if (message == undefined)
    message = element.innerText;
  if (i == undefined)
    i = message.length-1;
  element.innerText = message.substring(0,i);
  setTimeout(function(){ 
    if (i>0)
      flash_dissapear(element, message,i-1);
  }, FLASH_LETTER_STEP);
}

function flash_message(element, message) {
  flash_appear(element, message);
  setTimeout(function(){ flash_dissapear(element); }, FLASH_DURATION);
}
HERE_DOC
git add . && git commit -m "Adding flash to layout"

Bourbon css mixins

echo '
# css mixin library http://bourbon.io/
gem "bourbon", '~> 5.0.0.beta' # bourbon 5 is requred by bitters 1.3
# https://github.com/thoughtbot/bitters/issues/235
gem "neat"
' >> Gemfile
echo '
@import "bourbon";
@import "base/base"; // this is http://bitters.bourbon.io/
@import "neat";
' > app/assets/stylesheets/application.scss
git rm app/assets/stylesheets/application.css

bundle
gem install bitters
cd app/assets/stylesheets && bitters install
sed -i '/grid-settings/c @import "grid-settings";' base/_base.scss
cd -

git add . && git commit -m "Adding bourbon, neat and bitters scss"

Slim

sed -i Gemfile -e '/group :development do/a  \
  # slim templating\
  gem "slim-rails"'

gem install html2slim
erb2slim app/views/leads/index.html.erb

Angular

For various ways of integrating Angular look at angular-and-ruby-on-rails

Simplify secrets and add smtp credentials

YML file can use anchor (&) and reference (*) so you do not repeat the code. When you use reference * (as for testing) you can not add or update keys, but with << you can (as for production) (more on get syntax right) Note that you can use default values for env variables but only for those strings. Do not use boolean since <%= ENV['MY_VAR'} || true %> will always resolve to true. Instead of this

development: &default
  secret_key_base: <%= ENV["SECRET_KEY_BASE"] || 'some_secret' %>

test: *default
production:
  <<: *default
  monitor_mode: true

In rails 5 there are shared key which will use all stuff.

cat > config/secrets.yml << HERE_DOC
shared:
  secret_key_base: <%= ENV["SECRET_KEY_BASE"] || 'some_secret' %>

  # sending emails
  smtp_username: <%= ENV["SMTP_USERNAME"] %>
  smtp_password: <%= ENV["SMTP_PASSWORD"] %>

  # for all outgoing emails
  mailer_sender: <%= ENV["MAILER_SENDER"] || "My Company <[email protected]>" %>


# `shared` is automatically included, no need to write
# shared: &default
# development: *default
# or
# development:
#   <<: *default
HERE_DOC

git add . && git commit -m "Simplify secrets"

Basic mail settings

We can generate application mailer with:

rails generate mailer UserMailer hello
git add . && git commit -am "rails generate mailer UserMailer hello"

Change default from address:

sed -i app/mailers/application_mailer.rb -e '/default/c \
  default from: Rails.application.secrets.mailer_sender'

Set default url option, that is domain for root_url:

# if you need to get from rails 4 use { port: Rails::Server.new.options[:Port] }
# in config/environments/development.rb and also include
# require 'rails/commands/server` on the top of the file

# for rails 5 you can use Rack::Server.new.options[:Port] and no need to
# require anything, but it works only if you provide -p param to rails s
# and it should be callend only once, like I did in const.rb

# config/application.rb
    link = {
      host: (Rails.env.production? ? 'myapp.herokuapp.com' : 'localhost'),
      # in test we set up port manually to 3333 in test/a/capybara.rb
      port: (Rails.env.production? ? nil : Rails.env.development? ? Rack::Server.new.options[:Port] : 3333),
    }
    # for link urls in emails
    config.action_mailer.default_url_options = link
    # for link urls in rails console
    config.after_initialize do
      Rails.application.routes.default_url_options = link
    end
    # for asset-url or img_tag in emails
    config.action_mailer.asset_host = "//#{link[:host]}:#{link[:port]}"

For devise

For local development use Letter opener:

sed -i '/group :development do/a  \
  # open emails in browser\
  gem "letter_opener"' Gemfile
sed -i '/^end$/i \  config.action_mailer.delivery_method = :letter_opener' config/environments/development.rb 
bundle && git add . && git commit -m "Letter opener to see emails in browser"
rails runner UserMailer.hello.deliver

For production see send and receive emails in rails

Authentication

Cleareance gem

Clearance is simple email authorization. It could work with facebook auth but it’s designed to be only email auth.

echo "gem 'clearance'" >> Gemfile && bundle
rails generate clearance:install
rake db:migrate
rails generate clearance:routes
git add . && git commit -m "rails g clearance:install"

sed -i '/<body>/a \\n\
  <nav>\
    <% if signed_in? %>\
      <%= current_user.email %>\
      <%= button_to "Sign out", sign_out_path, method: :delete %>\
    <% else %>\
      <%= link_to "Sign in", sign_in_path %>\
    <% end %>\
  </nav>\
' app/views/layouts/application.html.erb
git add . && git commit -m "Adding sign signout path"

Company scaffold with skipped unused files

rails g scaffold company name:string user:references --no-stylesheets --no-helper --no-assets --no-jbuilder
# --no-fixture --no-test-framework
# or put in config/environments/development.rb
  config.generators do |generate|
    generate.helper false
    generate.stylesheets false
  end

sed -i '/companies/a \  root "companies#index"' config/routes.rb
rake db:migrate && git add . && git commit -m "rails g scaffold company name:string user:references"

Puma

Puma is now default webserver on rails. But by default it runs in single mode WEB_CONCURRENCY=0 so on heroku it will allow RAILS_MAX_THREADS connections if GIL is not trigered. In cluster mode WEB_CONCURRENCY=1 (or more) there is one master process and worker processes. You can simulate slow connection with sleep 10 (sleep does not trigger GIL).

export RAILS_MAX_THREADS=1
curl $u/action_with_sleep_10 &
curl $u/action_with_sleep_10 &
# real 10s
# real 20s


export RAILS_MAX_THREADS=2
curl $u/action_with_sleep_10 &
curl $u/action_with_sleep_10 &
# real 10s
# real 10s

You can follow heroku article Also https://www.digitalocean.com/community/tutorials/how-to-deploy-a-rails-app-with-puma-and-nginx-on-ubuntu-14-04 https://prograils.com/posts/capistrano-deploy-to-ubuntu-with-systemd-nginx-puma-and-rbenv

cat >> Gemfile <<HERE_DOC
gem 'puma'
HERE_DOC
bundle

# Rails 5 puma is default, and config/puma.rb is used, so do not need Procfile
# but is it advisable to write it and put rake db:migrate so you do not need to
# run migration after you deploy. Restart is not needed as it was needed after
# heroku run rake db:migrate (there are no exception, but update was not
# actually saved in new columns, so restart was needed)
cat >> Procfile <<HERE_DOC
web: bundle exec puma -C config/puma.rb
worker: bin/delayed_job run --queues=webapp,mailers
release: rake db:migrate
HERE_DOC

# if you use unicorn and sidekiq than Procfile will be
web: bundle exec unicorn -p $PORT -c ./config/unicorn.rb
worker: sidekiq
release: rake db:migrate

# default puma config is fine, but on production should include those lines
cat >> config/puma.rb <<HERE_DOC
# should match number of CPU cores: grep -c processor /proc/cpuinfo
workers Integer(ENV['WEB_CONCURRENCY'] || 2)
threads_count = Integer(ENV['RAILS_MAX_THREADS'] || 5)
threads threads_count, threads_count

preload_app!

rackup      DefaultRackup
port        ENV['PORT']     || 3000
environment ENV['RACK_ENV'] || 'development'

on_worker_boot do
  # Worker specific setup for Rails 4.1+
  # See: https://devcenter.heroku.com/articles/deploying-rails-applications-with-the-puma-web-server#on-worker-boot
  ActiveRecord::Base.establish_connection
end
HERE_DOC

# on development always use single mode
mkdir config/puma
cat >> config/puma/development.rb <<HERE_DOC
workers 0
HERE_DOC

Restart system

sudo systemctl daemon-reload
sudo systemctl enable puma.service
sudo systemctl start puma.service

Phusion passenger

Installation https://www.phusionpassenger.com/docs/tutorials/deploy_to_production/installations/oss/aws/ruby/nginx/

In nginx configuration you need to have

  passenger_enabled on;

https://www.phusionpassenger.com/library/dev/ruby/rails_integration.html https://www.phusionpassenger.com/library/config/nginx/action_cable_integration/

Gorails says it is faster https://gorails.com/forum/passenger-vs-puma

Can not find pidfile, there is some configuration to start in given pid file https://www.phusionpassenger.com/library/config/standalone/reference/#–pid-file-pid_file

Heroku deploy

If you need to run separate command for background jobs, you need to write Procfile.

When you create an app on macos you need to add linux platform on Gemfile.lock

bundle lock --add-platform x86_64-linux

Heroku use ubuntu 16 or Ubuntu 18, you can change

heroku apps:info
heroku stack
heroku stack:set heroku-16

You can pull dump from heroku database https://devcenter.heroku.com/articles/heroku-postgresql#pg-push-and-pg-pull you need to find the name of heroku database by clicking on Postgresl plugin

export MYAPP_NAME=my-app # only dash, not underscore
# # postgresql on production
# sed -i Gemfile -e "/gem 'sqlite3/c \
# gem 'pg'"
# sed -i '/adapter: sqlite3/c \  adapter: postgresql' config/database.yml
# sed -i "/development.sqlite3/c \  database: ${MYAPP_NAME}_dev" config/database.yml
# sed -i "/test.sqlite3/c \  database: ${MYAPP_NAME}_test" config/database.yml
# sed -i "/production.sqlite3/c \  database: ${MYAPP_NAME}_prod" config/database.yml
#
# rails in production use: production: url: <%= ENV['DATABASE_URL'] %>

cat >> Gemfile << HERE_DOC
# heroku uses this 12 factor gem
gem 'rails_12factor', group: :production
HERE_DOC
bundle
git commit -am "Heroku uses 12factor gem"

heroku apps:create $MYAPP_NAME # heroku create application name, no underscores
heroku addons:create heroku-postgresql:hobby-dev # this will set DATABASE_URL
git push heroku master --set-upstream

# heroku run rails db:setup will raise error:
# PG::ConnectionBad: FATAL:  permission denied for database "postgres"
# DETAIL:  User does not have CONNECT privilege
# https://kb.heroku.com/why-am-i-seeing-user-does-not-have-connect-privilege-error-with-heroku-postgres-on-review-apps
# so instead of create you just need to run migration and seed
heroku run rails db:migrate db:seed

# heroku pg:info
# heroku pg:reset --confirm $MYAPP_NAME
# heroku pg:reset --confirm `[[ $(git remote get-url heroku) =~ https...git.heroku.com.(.*).git ]] && echo ${BASH_REMATCH[1]}`
# heroku pg:reset --confirm ${PWD##*/}
# heroku restart
#
# I do not know how to drop db since db:migrate:reset does not work either

# sometimes you need to recompile assets when you change secrets but assets are
# not changed, and you need to purge cache, install plugin
# https://github.com/heroku/heroku-repo
# heroku plugins:install heroku-repo
# heroku repo:purge_cache

rails db:drop
heroku pg
# find name after "Add-on:"
heroku pg:pull postgresql-name-on-heroku my_rails_app_development
# or in one command
bundle exec rake db:drop
rails db:drop && heroku pg:pull `heroku pg|grep Add|awk '{print $2}'` `bundle exec rails runner "puts ActiveRecord::Base.configurations['development']['database']"`
# or dump in one command
DISABLE_DATABASE_ENVIRONMENT_CHECK=1 rails db:drop && heroku pg:pull `heroku pg|grep Add|awk '{print $2}'` `bundle exec rails runner "puts ActiveRecord::Base.configurations['development'][:database]"`

# also pushing
# heroku pg:reset --confirm `[[ $(git remote get-url heroku) =~ https...git.heroku.com.(.*).git ]] && echo ${BASH_REMATCH[1]}`
heroku pg:push `bundle exec rails runner "puts ActiveRecord::Base.configurations['development'][:database]"` `heroku pg|grep Add|awk '{print $2}'`

Using rake db:fixtures:load on heroku is not allowed

WARNING: Rails was not able to disable referential integrity.

This is most likely caused due to missing permissions.
Rails needs superuser privileges to disable referential integrity.

    cause: PG::InsufficientPrivilege: ERROR:  permission denied: "RI_ConstraintTrigger_a_16717182" is a system trigger

rails aborted!

so you can load localy and push to production. Another way is to run rake task https://gist.github.com/pvcarrera/123280c58eca51ccebe3 (remove :reset dependency) like on https://github.com/trkin/trk_datatables_demo/blob/master/lib/tasks/sample_data.rake

But there could be error

ActiveRecord::InvalidForeignKey: PG::ForeignKeyViolation: ERROR:  insert or update on table "posts" violates foreign key constraint "fk_rails_5b5ddfd518"
DETAIL:  Key (user_id)=(338193910) is not present in table "users".

so just run again same command

heroku run rake db:populate_sample_data DISABLE_DATABASE_ENVIRONMENT_CHECK=1

Remove clean cache on heroku https://help.heroku.com/18PI5RSY/how-do-i-clear-the-build-cache I succeed without installing heroku-repo

heroku plugins:install heroku-repo
heroku repo:purge_cache -a appname
git commit --allow-empty -m "Purge cache"
git push heroku master

now it is renamed to heroku-build

heroku plugins:install heroku-builds
heroku builds:cache:purge -a example-app

Remove remote branch on heroku ie clear reset repository Remove all heroku remote branches using a heroku plugin https://github.com/heroku/heroku-repo#reset

heroku repo:reset

Heroku ssl https://devcenter.heroku.com/articles/ssl-endpoint#setting-up-ssl-on-heroku

heroku certs
heroku certs:info

Dump database

Dump database from production for local inspection, you can download from heroku manually or using commands:

heroku pg:backups:capture # it will create b002.dump
heroku pg:backups:download # it will download to latest.dump

Restore database

You can dump LOCAL database with pg_dump. Note that this is plain sql, but heroku dump is binary format (size is much smaller).

export DUMP_FILE=tmp/b001.dump
export DATABASE_NAME=$(rails runner 'puts ActiveRecord::Base.configurations["development"]["database"]')

# pg_dump $DATABASE_NAME > $DUMP_FILE
# we must use heroku style, replace: mypassword myuser and mydb
# PGPASSWORD=mypassword pg_dump -Fc --no-acl --no-owner -h localhost -U myuser $DATABASE_NAME > $DUMP_FILE
pg_dump -Fc --no-acl --no-owner $DATABASE_NAME > $DUMP_FILE
scp $DUMP_FILE 192.168.1.3:
ssh 192.168.1.3
sudo cp b001.dump /var/www/html/

heroku pg:backups restore --confirm move-index http://trkcam.duckdns.org/b001.dump DATABASE_URL
heroku pg:backups

Restore from local textual and binary dump


chmod a+r $DUMP_FILE

rake db:drop db:create db:migrate

# textual dump
psql $DATABASE_NAME < $DUMP_FILE

# binary dump
# this works when pg_dump version are different and `heroku pg:pull postgresql-symmetrical my_dev` does not work
sudo su postgres -c "pg_restore -d $DATABASE_NAME --clean --no-acl --no-owner -h localhost $DUMP_FILE"

Sometimes when I restore using pg_restore I lost incremental id, and I got error

ActiveRecord::StatementInvalid (PG::NotNullViolation: ERROR:  null value in column "id" violates not-null constraint

and when I see table definition there is no default nextval values for payments.id

\d users
Column          |            Type             | Collation | Nullable | Default
----------------+-----------------------------+-----------+----------+---------
 id             | integer                     |           | not null | nextval('payments_id_seq'::regclass)

\d payments
Column          |            Type             | Collation | Nullable | Default 
-------------------+--------------------------+-----------+----------+---------
 id             | integer                     |           | not null | 

Or you can use duleorlovic’s load_dump helper

To restore on heroku you need to dump with same flags (dump is binary) and push the file somewhere on internet, for example AWS S3 and than run in console

heroku pg:backups restore --confirm playcityapi https://s3.amazonaws.com/duleorlovic-test-us-east-1/b001.dump DATABASE_URL

Heroku upgrade database plan

Upgrade heroku hobby-dev na hobby-basic ($9/month max 10M rows). All plans https://elements.heroku.com/addons/heroku-postgresql

heroku addons:create heroku-postgresql:hobby-basic
# Creating heroku-postgresql:hobby-basic on ⬢ myapp... $9/month
# Database has been created and is available
#  ! This database is empty. If upgrading, you can transfer
#  ! data from another database with pg:copy
# Created postgresql-defined-42601 as HEROKU_POSTGRESQL_CHARCOAL_URL
# Use heroku addons:docs heroku-postgresql to view documentation

heroku pg:copy DATABASE_URL HEROKU_POSTGRESQL_CHARCOAL_URL
# ▸    WARNING: Destructive action
#  ▸    This command will remove all data from CHARCOAL
#  ▸    Data from DATABASE will then be transferred to CHARCOAL
#  ▸    To proceed, type myapp or re-run this command with --confirm myapp
# 
# > myapp
# Starting copy of DATABASE to CHARCOAL... done
# Copying... done

Upgrading from hobby-basic to standard-0

heroku pg:info
heroku addons:create heroku-postgresql:standard-0
# save the variable name HEROKU_POSTGRESQL_{some color}_URL
heroku maintenance:on
heroku pg:copy DATABASE_URL HEROKU_POSTGRESQL_color_URL
heroku pg:promote HEROKU_POSTGRESQL_color_URL
heroku maintenance:off
# this is not neccessary since it is updated
# heroku config:set DATABASE_URL=....url from config
heroku addons:destroy HEROKU_POSTGRESQL_color_old_URL

heroku config plugin https://github.com/xavdid/heroku-config

heroku config:pull -f .env.production 
heroku config:push --file=.env.production 

If you need to provision new database (upgrade from free to hobby) than you can use pg copy https://devcenter.heroku.com/articles/upgrading-heroku-postgres-databases#upgrading-with-pg-copy

heroku pg:copy DATABASE_URL HEROKU_POSTGRESQL_TEAL_URL
heroku pg:promote HEROKU_POSTGRESQL_TEAL_URL
heroku config # find color of old database
heroku addons:destroy HEROKU_POSTGRESQL_NAVY_URL

If you need to compile node packages than you need need custom buildpack. We could use 3th party gulp buildpacks but default node buildpack works fine.

There is also for mysql https://github.com/Shopify/heroku-buildpack-mysql or https://github.com/din-co/heroku-buildpack-mysql

devDependencies need to be renamed to dependecies since it runs node production mode (I tried to disable production mode using NPM_CONFIG_ONLY but than other thinks does not work). Imporant is NODE_MODULES_CACHE. If we (by default) cache /node_modules it will not build new version to public folder.

# deploy to heroku
heroku buildpacks:set heroku/ruby # https://github.com/heroku/heroku-buildpack-ruby
heroku buildpacks:add --index 1 heroku/nodejs # https://github.com/heroku/heroku-buildpack-nodejs

heroku buildpacks # should return  1. nodejs  2. ruby (latest wins :)

Alternativelly, we can define then in file .buildpacks and configure multi build pack heroku config:add BUILDPACK_URL=https://github.com/ddollar/heroku-buildpack-multi.git

# .buildpacks
https://github.com/heroku/heroku-buildpack-ruby
https://github.com/heroku/heroku-buildpack-nodejs

For nodejs buildpack you can define version in package.json. When deploying Ruby, it will use latest nodejs and this engines property will be ignored.

# package.json
  "engines": {
    "node": "14.x"
  }
git rm -rf public
echo '/public
/node_modules' >> .gitignore
git add .gitignore
git commit -m "Remove public folder from git repo"

echo '{
  "name": "rootApp",
  "scripts": {
  },
  "dependencies": {
    "myappAngular": "file:./client"
  },
  "cacheDirectories": [
    "client/node_modules",
    "client/bower_components"
  ]
}
' > package.json
git add package.json && git commit -m "Add package.json for nodejs buildpack detect"

cd client
sed -i "/dist: 'dist/c \  dist: '../../public'," gulp/conf.js
sed -i '/"scripts":/a \    "postinstall": "bower install && gulp build",' package.json
sed -i '/"devDependencies":/c \  "dependencies": {\
    "bower": "*",' package.json
git add . && git commit -m "Configure postinstall gulp build"
cd ..

git push heroku
heroku config # NPM_CONFIG_PRODUCTION=true NODE_ENV=production NODE_MODULES_CACHE=true
heroku open
# usefull command to test is `npm install`
# git commit --amend --allow-empty --no-edit && echo "output is saved: cat log/heroku.log" && git push heroku -f > log/heroku.log 2>&1 && heroku run bash -c 'mysql -v'

On heroku add Papertrail add-on and go to the https://papertrailapp.com/events and search for “Started GET” , save and create email alert or add internal notification

https://devcenter.heroku.com/articles/custom-domains For custom domain just add on settings your domain name and create CNAME record for www with value myapp.herokuapp.com. If you need to match all subdomains (wildcard), you can put Domain Name *.kontakt.in.rs and CNAME record for * with same value myapp.herokuapp.com. If you need to add root domain (naked, bare, zone apex) than you can’t use loopia but some other suggested domain name providers.

Deploy javascript npm required tasks

Heroku dyno puma settings

https://youtu.be/itbExaPqNAE Some Things in system = arrival rate X time spent in system so for server it is: hequests_in_system = requests per second X average_response_time (115 req/s * 0.147s = 16 request in system, so we need at leat 16 workers in same time). utilization = requests_in_system / how_many_workers for example = 115 req/s X 147ms response / 45 workers = 37%

Use 3 WEB_CONCURRENCY workers and 3-5 RAILS_MAX_THREADS (not more since each thread need connection to database, and use some on memory). https://devcenter.heroku.com/articles/deploying-rails-applications-with-the-puma-web-server#workers suggests 2-4 workers sleep also does not lock GIL (so all threads are working).

On MRI, there is a Global Interpreter Lock (GIL) that ensures only one thread can be run at any time. IO operations such as database calls, interacting with the file system, or making external http calls will not lock the GIL. Most Rails applications heavily use IO, so adding additional threads will allow Puma to process multiple threads, gaining you more throughput. `

https://devcenter.heroku.com/articles/scaling#autoscaling

Also increase database, redis and memcached connections. Heroku postgresql hobby-basic has limit of 20 connections (enought for 3x5=15)

Test using siege http://jakeyesbeck.com/2019/06/18/ruby-processes-and-threads/

# app/controllers/index_controller.rb
class IndexController < ApplicationController
  def index
    interval_sleep
    render json: { hello: :there }
  end

  def interval_sleep
    # 40ms - 200ms
    sleep(rand(2..10).to_f / 50)
  end
end
# bin/siege.sh
#! /bin/bash

CONCURRENCY=30
URL='http://localhost:3000/index'
CONTENT_TYPE='application/json'
REPS=20

siege -b --content-type $CONTENT_TYPE -c $CONCURRENCY -r $REPS $URL

# flags:
#   -b - benchmark means no gap between requests
#   -c - concurrency is number of requests to make at one time
#   -r - repititions is the number of times to run
#         the same amount of concurrent requests

htop can show memory and proccessor usage (0.4 0.5 0.6 which means last 1 min, last 5 and last 10 mins average load).

Puma threads RAILS_MAX_THREADS is important on IO blocking operations like GET requests, so greater number of threads means greater throughput, but increasing more than 5-10 threads does not have effects.

Puma workers ENV.fetch(“WEB_CONCURRENCY”) { 2 } is important for CPU intensive code but it utilizes 2x db connections and 2x memory since 2x processes is used.

Heroku memory inspect R14 Memory quota exceeded https://devcenter.heroku.com/articles/log-runtime-metrics#memory-swap

heroku labs:enable log-runtime-metrics
heroku restart

2020-11-19T10:21:34.368101+00:00 heroku[web.5]: source=web.5 dyno=heroku.30259387.5e6b3e82-4fd2-40b2-a3da-a22a1b27aa4a sample#memory_total=725.98MB sample#memory_rss=721.84MB sample#memory_cache=4.04MB sample#memory_swap=0.11MB sample#memory_pgpgin=188980pages sample#memory_pgpgout=3156pages sample#memory_quota=1024.00MB

Google app engine

It is not hard to deploy to google ap engine