diff --git a/docs/en/installation/manual_installation_production.md b/docs/en/installation/manual_installation_production.md index 1d31a7a6b..994da4bdb 100644 --- a/docs/en/installation/manual_installation_production.md +++ b/docs/en/installation/manual_installation_production.md @@ -1,8 +1,8 @@ # Manual installation for production -**WARNING:** This method is *not recommended* and not officially supported, since you should use the [installer](https://github.com/consuldemocracy/installer) instead. Use this method if the installer isn't an option and you can already deal with PostgreSQL, puma or passenger, NGNIX and SSL (with letsencrypt, for instance). +**WARNING:** This method is *not recommended* and not officially supported, since you should use the [installer](https://github.com/consuldemocracy/installer) instead. Use this method only if the installer isn't an option and you have experience configuring PostgreSQL, Puma or Passenger, NGINX, and SSL (with letsencrypt, for instance). -This guide assumes you've already [installed all the necessary packages](prerequisites.md) on your system. +This guide assumes you've already [installed all the necessary packages](prerequisites.md) on your system. Make sure to install RVM to be able to install the Ruby version required by the project, which is defined in the .ruby-version file. Also, ensure you have installed FNM to install the Node.js version defined in the .node-version file. The created directory structure herein is to be used with [capistrano](https://capistranorb.com/documentation/getting-started/structure/). @@ -21,22 +21,24 @@ mkdir -p shared/public/assets shared/public/system shared/public/ckeditor_assets ## Initial release -Extract from the repo the first release to the respective directory, and create the symbolic link of the current release (replace `` with the latest version number, like 1.3.1 or 1.4.1): +Extract from the repo the first release to the respective directory, and create the symbolic link of the current release. Be sure to replace `` with the number of the latest stable version of Consul Democracy, such as 2.1.1 or 2.2.0. To find the most recent version, visit the releases section in the [Consul Democracy repository](https://github.com/consuldemocracy/consuldemocracy/releases) ```bash +mkdir releases/first cd repo git archive | tar -x -f - -C ../releases/first cd .. ln -s releases/first current ``` -## Gems installation +## Installing dependencies -Install the gems Consul Democracy depends on: +Install the dependencies for Consul Democracy: ```bash cd releases/first bundle install --path ../../shared/bundle --without development test +fnm exec npm install cd ../.. ``` @@ -53,7 +55,7 @@ ln -s ../../../shared/config/secrets.yml cd ../../.. ``` -Edit the `shared/config/database.yml` file, filling in `username` and `password` with the data generated during the [PostgreSQL setup](debian.md#postgresql-94). +Edit the `shared/config/database.yml` file, filling in `username` and `password` with the data generated during the [PostgreSQL setup](debian.md#postgresql). We now need to generate a secret key: @@ -78,6 +80,7 @@ Create a database, load the seeds and compile the assets: ```bash cd current + bin/rake db:create RAILS_ENV=production bin/rake db:migrate RAILS_ENV=production bin/rake db:seed RAILS_ENV=production bin/rake assets:precompile RAILS_ENV=production diff --git a/docs/es/installation/manual_installation_production.md b/docs/es/installation/manual_installation_production.md index 6169e3105..26031ea63 100644 --- a/docs/es/installation/manual_installation_production.md +++ b/docs/es/installation/manual_installation_production.md @@ -1,8 +1,8 @@ # Instalación manual en producción -**AVISO:** Recomendamos *no usar* este sistema, para el que no damos soporte oficial, ya que siempre que sea posible debe utilizarse el [instalador](https://github.com/consuldemocracy/installer). Utiliza este método si usar el instalador no es una opción y si tienes experiencia configurando PostgreSQL, puma o passenger, NGNIX y SSL (con letsencrypt, por ejemplo). +**AVISO:** Recomendamos *no usar* este sistema, para el que no damos soporte oficial, ya que siempre que sea posible debe utilizarse el [instalador](https://github.com/consuldemocracy/installer). Utiliza este método solo si usar el instalador no es una opción y si tienes experiencia configurando PostgreSQL, Puma o Passenger, NGNIX y SSL (con letsencrypt, por ejemplo). -Esta guía asume que ya has [instalado todas las dependencias necesarias](prerequisites.md) en tu sistema. +Esta guía asume que ya has [instalado todas las dependencias necesarias](prerequisites.md) en tu sistema. Asegúrate de instalar RVM para poder instalar la versión de ruby necesaria para el proyecto que está definida en el fichero .ruby-version y también asegúrate de instalar FNM para poder instalar la versión de node.js definida en el fichero .node-version. La estructura de directorios que se crea a continuación está pensada para usarse con [capistrano](https://capistranorb.com/documentation/getting-started/structure/). @@ -20,22 +20,24 @@ mkdir -p shared/public/assets shared/public/system shared/public/ckeditor_assets ## Versión inicial -Crea una primera carpeta en "releases" a partir del repositorio, junto con un enlace simbólico a la versión actual (sustituye `` por el número de la última versión estable de Consul Democracy, como 1.3.1 o 1.4.1): +Crea una carpeta en _releases_ a partir del repositorio y luego genera un enlace simbólico a la versión actual. Asegúrate de sustituir `` por el número de la última versión estable de Consul Democracy, como 2.1.1 o 2.2.0. Para encontrar la versión más reciente, visita la sección de _releases_ en el [repositorio de Consul Democracy](https://github.com/consuldemocracy/consuldemocracy/releases): ```bash +mkdir releases/first cd repo git archive | tar -x -f - -C ../releases/first cd .. ln -s releases/first current ``` -## Instalación de gemas +## Instalación de dependencias -Instala las gemas de las que depende Consul Democracy: +Instala las dependencias de Consul Democracy: ```bash cd releases/first bundle install --path ../../shared/bundle --without development test +fnm exec npm install cd ../.. ``` @@ -52,7 +54,7 @@ ln -s ../../../shared/config/secrets.yml cd ../../.. ``` -Edita el fichero `shared/config/database.yml`, rellenando `username` y `password` con los datos generador durante la [configuración de PostgreSQL](debian.md#postgresql-94). +Edita el fichero `shared/config/database.yml`, rellenando `username` y `password` con los datos generador durante la [configuración de PostgreSQL](debian.md#postgresql). Ahora generamos una clave secreta: @@ -77,6 +79,7 @@ Crea una base de datos, genera los datos necesarios para que la aplicación func ```bash cd current + bin/rake db:create RAILS_ENV=production bin/rake db:migrate RAILS_ENV=production bin/rake db:seed RAILS_ENV=production bin/rake assets:precompile RAILS_ENV=production