CONSUL
Latest
Search…
⌃K

Heroku

Instalación manual

Este tutorial asume que ya has conseguido clonar CONSUL en tu máquina y conseguir que funcione.
  1. 1.
    En primer lugar, necesitas crear una cuenta en Heroku si no lo has hecho ya.
  2. 2.
    Instala Heroku CLI e inicia sesión con:
heroku login
  1. 1.
    Accede a tu repositorio de CONSUL y crea una instancia
cd consul
heroku create your-app-name
Puedes añadir --region eu si quieres utilizar servidores europeos en lugar de los estadounidenses.
Si your-app-name no existe aún, Heroku creará tu aplicación.
  1. 1.
    Crea la base de datos con
heroku addons:create heroku-postgresql
Ahora deberías tener acceso a una base de datos Postgres vacía cuya dirección se guardó automáticamente como una variable de entorno llamada DATABASE_URL. CONSUL se conectará automáticamente a ella durante la instalación.
  1. 1.
    (No es necesario) Crea un archivo con el nombre heroku.yml en la raíz del proyecto y añade el siguiente código
build:
languages:
- ruby
packages:
- imagemagick
run:
web: bundle exec rails server -e ${RAILS_ENV:-production}
  1. 1.
    Ahora, genera una clave secreta y guárdala en la variable de entorno SECRET_KEY_BASE de la siguinte manera
heroku config:set SECRET_KEY_BASE=$(rails secret)
Añade también la dirección de tu servidor:
heroku config:set SERVER_NAME=myserver.address.com
Es necesario que la aplicación sepa dónde se almacenan las variables de configuración añadiendo un enlace a las variables de entorno en config/secrets.yml
production:
secret_key_base: <%= ENV["SECRET_KEY_BASE"] %>
server_name: <%= ENV["SERVER_NAME"] %>
y añade este archivo en el repositorio comentando la línea correspondiente en el .gitignore.
#/config/secrets.yml
¡Recuerda no añadir el archivo si tienes información sensible en él!
  1. 1.
    Ahora ya puedes subir tu aplicación utilizando:
git push heroku your-branch:master
  1. 1.
    No funcionará de inmediato porque la base de datos no contiene las tablas necesarias. Para crearlas, ejecuta
heroku run rake db:migrate
heroku run rake db:seed
Si quieres añadir los datos de prueba en la base de datos, mueve gem 'faker', '~> 1.8.7' fuera del group :development y ejecuta:
heroku config:set DATABASE_CLEANER_ALLOW_REMOTE_DATABASE_URL=true
heroku config:set DATABASE_CLEANER_ALLOW_PRODUCTION=true
heroku run rake db:dev_seed
  1. 1.
    Ahora tu aplicación debería estar ya opertaiva. Puedes abrirla con
heroku open
También puedes arrancar la consola en heroku utilizando
heroku console --app your-app-name
  1. 1.
    Heroku no permite guardar imágenes o documentos en sus servidores, por lo que es necesario configurar un nuevo espacio de almacenamiento.
Consulta nuestra guía de S3 para más detalles sobre la configuración de Paperclip con S3.

Configurar Sendgrid

Añade el complemento (add-on) de SendGrid en Heroku. Esto creará una cuenta de SendGrid para la aplicación con ENV["SENDGRID_USERNAME"] y ENV["SENDGRID_PASSWORD"].
Añade el siguiente código a config/secrets.yml, en la sección production::
mailer_delivery_method: :smtp
smtp_settings:
:address: "smtp.sendgrid.net"
:port: 587
:domain: "heroku.com"
:user_name: ENV["SENDGRID_USERNAME"]
:password: ENV["SENDGRID_PASSWORD"]
:authentication: "plain"
:enable_starttls_auto: true
Importante: Activa un "worker dyno" para que se envíen los correos electrónicos.

Opcional (pero recomendado):

Instalar rails_12factor y especificar la versión de Ruby

Instalar rails_12factor sólo es útil si utilizas una versión de CONSUL anterior a la 1.0.0. La última versión utiliza Rails 5 que ya incluye los cambios.
Como nos recomienda Heroku, puedes añadir la gema rails_12factor y especificar la versión de Ruby a utilizar. Puedes hacerlo añadiendo:
gem 'rails_12factor'
ruby 'x.y.z'
en el archivo Gemfile_custom, donde x.y.z es la versión definida en el fichero .ruby-version del repositorio de CONSUL. No olvides ejecutar
bundle install
para generar el Gemfile.lock antes de añadir los cambios y subirlos al servidor.

Utilizar Puma como servidor web

Heroku recomienda utilizar Puma para mejorar el rendimiento de la aplicación.
Si quieres permitir más concurrencia, descomenta la siguiente linea:
workers ENV.fetch("WEB_CONCURRENCY") { 2 }
Puedes encontrar una explicación para diferentes configuraciones en el siguiente tutorial de Heroku.
Por último hay que cambiar la tarea web para usar Puma cambiándola en el archivo heroku.yml con el siguiente código:
web: bundle exec puma -C config/puma.rb

Añadir variables de configuración desde el panel de control

Las versiones gratuita y hobby de Heroku no son suficientes para ejecutar una aplicación como CONSUL. Para optimizar el tiempo de respuesta y asegurarte de que la aplicación no se quede sin memoria, puedes cambiar el número de "workers" e hilos que utiliza Puma.
La configuración recomendada es un "worker" y tres hilos. Puedes configurarlo ejecutando estos dos comandos:
heroku config:set WEB_CONCURRENCY=1
heroku config:set RAILS_MAX_THREADS=3
También es recomendable configurar las siguientes variables:
heroku config:set RAILS_SERVE_STATIC_FILES=enabled
heroku config:set RAILS_ENV=production
Last modified 1yr ago