Update manual installation instructions
This commit is contained in:
@@ -1,8 +1,8 @@
|
|||||||
# Manual installation for production
|
# 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/).
|
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
|
## Initial release
|
||||||
|
|
||||||
Extract from the repo the first release to the respective directory, and create the symbolic link of the current release (replace `<latest_consuldemocracy_stable_version>` 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 `<latest_consuldemocracy_stable_version>` 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
|
```bash
|
||||||
|
mkdir releases/first
|
||||||
cd repo
|
cd repo
|
||||||
git archive <latest_consuldemocracy_stable_version> | tar -x -f - -C ../releases/first
|
git archive <latest_consuldemocracy_stable_version> | tar -x -f - -C ../releases/first
|
||||||
cd ..
|
cd ..
|
||||||
ln -s releases/first current
|
ln -s releases/first current
|
||||||
```
|
```
|
||||||
|
|
||||||
## Gems installation
|
## Installing dependencies
|
||||||
|
|
||||||
Install the gems Consul Democracy depends on:
|
Install the dependencies for Consul Democracy:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd releases/first
|
cd releases/first
|
||||||
bundle install --path ../../shared/bundle --without development test
|
bundle install --path ../../shared/bundle --without development test
|
||||||
|
fnm exec npm install
|
||||||
cd ../..
|
cd ../..
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -53,7 +55,7 @@ ln -s ../../../shared/config/secrets.yml
|
|||||||
cd ../../..
|
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:
|
We now need to generate a secret key:
|
||||||
|
|
||||||
@@ -78,6 +80,7 @@ Create a database, load the seeds and compile the assets:
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd current
|
cd current
|
||||||
|
bin/rake db:create RAILS_ENV=production
|
||||||
bin/rake db:migrate RAILS_ENV=production
|
bin/rake db:migrate RAILS_ENV=production
|
||||||
bin/rake db:seed RAILS_ENV=production
|
bin/rake db:seed RAILS_ENV=production
|
||||||
bin/rake assets:precompile RAILS_ENV=production
|
bin/rake assets:precompile RAILS_ENV=production
|
||||||
|
|||||||
@@ -1,8 +1,8 @@
|
|||||||
# Instalación manual en producción
|
# 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/).
|
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
|
## 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 `<latest_consul_stable_version>` 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 `<latest_consul_stable_version>` 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
|
```bash
|
||||||
|
mkdir releases/first
|
||||||
cd repo
|
cd repo
|
||||||
git archive <latest_consul_stable_version> | tar -x -f - -C ../releases/first
|
git archive <latest_consul_stable_version> | tar -x -f - -C ../releases/first
|
||||||
cd ..
|
cd ..
|
||||||
ln -s releases/first current
|
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
|
```bash
|
||||||
cd releases/first
|
cd releases/first
|
||||||
bundle install --path ../../shared/bundle --without development test
|
bundle install --path ../../shared/bundle --without development test
|
||||||
|
fnm exec npm install
|
||||||
cd ../..
|
cd ../..
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -52,7 +54,7 @@ ln -s ../../../shared/config/secrets.yml
|
|||||||
cd ../../..
|
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:
|
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
|
```bash
|
||||||
cd current
|
cd current
|
||||||
|
bin/rake db:create RAILS_ENV=production
|
||||||
bin/rake db:migrate RAILS_ENV=production
|
bin/rake db:migrate RAILS_ENV=production
|
||||||
bin/rake db:seed RAILS_ENV=production
|
bin/rake db:seed RAILS_ENV=production
|
||||||
bin/rake assets:precompile RAILS_ENV=production
|
bin/rake assets:precompile RAILS_ENV=production
|
||||||
|
|||||||
Reference in New Issue
Block a user