Skip to content

Instalaciones de Help Buttons#

En GNU/Linux#

Referencias seguidas:

Para realizar la instalación de Ruby on Rails (RoR) en Debian o derivados (Ubuntu) existen los siguientes requisitos:

  • RVM
  • PostgreSQL
  • Nodejs
  • Yarn

Instalación de RVM (Ruby Version Manager)#

Instalamos los paquetes del sistema operativo requeritos por RVM: 

sudo apt install -y git-core subversion gnupg2 curl

Añadimos la firma del repositorio de RVM que se puede encontrar en su página oficial:

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Instalamos la versión estable de RVM:

curl -sSL https://get.rvm.io | bash -s stable --ruby

Este comando instala las últimas versiones estables de rvm, ruby y rails. Al ejecutarlo se devuelve muchos mensajes por pantalla.

Una vez finalizado este proceso, RVM nos dice que ejecutemos el siguiente comando o que reiniciemos las shells abiertas. También ejecutaremos este comando en caso de obtener un error diciendo que no se ha encontrado el comando bundle bash: bundle: command not found

source /home/$USER/.rvm/scripts/rvm

Se comprueba la configuración de rvm mediante la siguiente orden:

type rvm | head -n 1

La cual nos devolverá que rvm is a function. En caso de no ser así, rvm no está configurado adecuadamente. En tal caso habrá que consultar la documentación en https://rvm.io/rvm/install y solicitar ayuda.

A continuación, comprobamos los comandos: rvm, ruby, irb, gem.

rvm list
ruby -v
irb -v
gem -v

Instalación de la versión de ruby del proyecto#

Bundle es una gema de ruby que lleva la cuenta e instala las diferentes versiones de las gemas que necesitamos. Ya tenemos el entorno instalado y disponible para trabajar con él.

Al intentar instalar el bundle con el comando a continuación, seguramente nos encontremos con un error Your Ruby version is Y.Y.Y, but your Gemfile specified X.X.X.

bundle install

Para resolverlo, se necesita instalar y usar la versión X.X.X. adecuada. 

rvm install X.X.X
rvm use X.X.X

Si volvemos a ejecutar el comando bundle install nos aparecerá otro error indicando que falta instalar la base de datos PostgreSQL.

Instalación y configuración de PostgreSQL#

Se instalan los paquetes necesarios para la instalación de PostgreSQL:

sudo apt install postgresql postgresql-contrib libpq-dev -y

Se levantan el servicio con:

systemctl start postgresql
systemctl enable postgresql

Se abre una consola en PostgreSQL para modificar la contraseña del usuario postgres:

sudo -i -u postgres psql

Se introduce el siguiente mandato para cambiar la contraseña:

\password postgres

A continuación, se crea un nuevo usuario de PostgreSQL llamado rails_dev con privilegios para crear una base de datos with createdb y una contraseña aq1234567890 (se recomienda cambiarla por otra más robusta, a poder ser generada con KeePassXC o BitWarden)

create role hb_dev with createdb login password 'aq1234567890';

Se muestran los usuarios de PostgreSQL con:

\du

Escribe exit para salir de la consola de PostgreSQL.

Volvemos a ejecutar bundle install para continuar con la instalación.

bundle install

Termina la ejecución sin errores. El siguiente paso será instalar Nodejs y Yarn.

Instalación de Nodejs y Yarn#

Primero instalamos las herramientas de desarrollo para compilar C.

sudo apt install gcc g++ make

Se instalan los repositorios de Nodejs 14 a través del siguiente comando:

curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -

Se instala nodejs mediante la siguiente orden:

sudo apt-get install -y nodejs

Se comprueba la instalación de nodejs y npm con:

node -v
npm -v

Se añade la firma y los repositorios de yarn mediante:

curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

Instalamos yarn:

sudo apt update && sudo apt install yarn

Ejecución del proyecto#

Hb-backend#

Creamos el archivo de configuración de la base de datos config/database.yml con vim o nano (se recomienda nano en caso de no saber utilizar vim):

vim config/database.yml

Por defecto, no existirá este fichero porque se incluye en el .gitgignore. Por lo tanto, se puede coger una plantilla y añadir las siguientes secciones o añadir el documento entero como se expone un poco más abajo: - En la sección development, añade la configuración de PostgreSQL:

development:
  <<: *default
  database: test_project_development
  username: hb_dev
  password: aq1234567890
  host: localhost
  port: 5432
  • En la sección testing, añade la configuración de PostgreSQL:
test:
  <<: *default
  database: test_project_test
  host: localhost
  port: 5432
  username: hb_dev
  password: aq1234567890

Un ejemplo del archivo final de config/database.yml será el siguiente:

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

development:
  <<: *default
  database: test_project_development
  username: hb_dev
  password: aq1234567890
  host: localhost
  port: 5432

test:
  <<: *default
  database: test_project_test
  username: hb_dev
  password: aq1234567890
  host: localhost
  port: 5432

production:
  <<: *default
  database: test_project_production
  username: test_project
  password: <%= ENV['TEST_PROJECT_DATABASE_PASSWORD'] %>

Guarda los cambios y sal del editor.

Lo siguiente será generar el esquema de la base de datos PostgreSQL ejecutando:

rake db:setup

O alternativamente:

rails db:setup
rails db:migrate

Por último, levanta el servidor en local y accede a la dirección http://localhost:3000/.

rails s

Hb-frontend#

Instalamos ember glabalmente: 

npm install -g ember-cli

En caso de obtener un error relaciondo con permisos de acceso npm ERR! Error: EACCES,, cambiamos el propietario de la carpeta node_modules de root al usuario actual para poder acceder al directorio:

sudo chown -R $USER /usr/lib/node_modules

Instalamos las depencias del front:

npm install

Se sirve el frontend y se accede desde el navegador a la url http://localhost:4200/:

ember s

Posibles errores durante la instalación#

Command not found#

  • Bundle: Si al ejecutar bundle install nos devuelve el error bash: bundle: command not found será necesario volver a ejecutar:
source /home/$USER/.rvm/scripts/rvm
  • Rails: Si al ejecutar rails db:setup nos devuelve el error bash: rails: command not found será necesario volver a ejecutar:
source /home/$USER/.rvm/scripts/rvm
  • ember: Si al ejecutar ember -v nos devuelve el error bash: ember: command not found será necesario volver a ejecutar:
export PATH=node_modules/.bin:$PATH

Añadirlo al PATH para tener una solución permanente. Por ejemplo, si se está utilizando bash como consola, se podrá incluir los comandos como últimas líneas en el archivo .bashrc y posteriormente aplicar los cambios con source .bashrc.

Ruby version#

Al intentar instalar el bundle con el comando a continuación, seguramente nos encontremos con un error Your Ruby version is Y.Y.Y, but your Gemfile specified X.X.X.

bundle install

Para resolverlo, se necesita instalar y usar la versión X.X.X. adecuada. 

rvm install X.X.X
rvm use X.X.X