Update ubuntu local installation instructions

So now we install a specific version of Node.js and use the packages
required for Ubuntu 24.04.
This commit is contained in:
taitus
2024-07-22 17:31:46 +02:00
committed by Javi Martín
parent 0a3cabd8c8
commit 7845c7f78d
2 changed files with 35 additions and 27 deletions

View File

@@ -1,4 +1,4 @@
# Configuration for development and test environments (Ubuntu 18.04) # Configuration for development and test environments (Ubuntu 24.04)
## System update ## System update
@@ -23,7 +23,7 @@ Ruby versions packaged in official repositories are not suitable to work with Co
First, we need to install Ruby's development dependencies: First, we need to install Ruby's development dependencies:
```bash ```bash
sudo apt install libssl-dev autoconf bison build-essential libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm5 libgdbm-dev sudo apt install libssl-dev autoconf bison build-essential libyaml-dev libreadline-dev zlib1g-dev libncurses-dev libffi-dev libgdbm-dev
``` ```
The next step is installing a Ruby version manager, like rbenv: The next step is installing a Ruby version manager, like rbenv:
@@ -33,14 +33,21 @@ wget -qO- https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-installer
source ~/.bashrc source ~/.bashrc
``` ```
## Node.js ## CMake and pkg-config
To compile the assets, you'll need a JavaScript runtime. Node.js is the preferred option. In order to compile some of the project dependencies, we need CMake and pkg-config:
Run the following command on your terminal:
```bash ```bash
sudo apt install nodejs sudo apt install cmake pkg-config
```
## Node.js version manager
To compile the assets, you'll need a JavaScript runtime. Node.js is the preferred option. To install Node.js, we will install a Node.js version manager, like NVM:
```bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
``` ```
## PostgreSQL ## PostgreSQL
@@ -65,15 +72,12 @@ Install Imagemagick:
sudo apt install imagemagick sudo apt install imagemagick
``` ```
## ChromeDriver ## Chrome or Chromium
To run E2E integration tests, we use Selenium along with Headless Chrome. In order to run the system tests, we need to install Chrome or Chromium.
To get it working, install the chromium-chromedriver package and make sure it's available on your shell's PATH:
```bash ```bash
sudo apt install chromium-chromedriver sudo apt install chromium-browser
sudo ln -s /usr/lib/chromium-browser/chromedriver /usr/local/bin/
``` ```
Now you're ready to go [get Consul Democracy installed](local_installation.md)! Now you're ready to go [get Consul Democracy installed](local_installation.md)!

View File

@@ -1,4 +1,4 @@
# Configuración para los entornos de desarrollo y pruebas (Ubuntu 18.04) # Configuración para los entornos de desarrollo y pruebas (Ubuntu 24.04)
## Actualización de sistema ## Actualización de sistema
@@ -23,7 +23,7 @@ Las versiones de Ruby empaquetadas en repositorios oficiales no son aptas para t
En primer lugar, necesitamos los siguiente paquetes para poder instalar Ruby: En primer lugar, necesitamos los siguiente paquetes para poder instalar Ruby:
```bash ```bash
sudo apt install libssl-dev autoconf bison build-essential libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm5 libgdbm-dev sudo apt install libssl-dev autoconf bison build-essential libyaml-dev libreadline-dev zlib1g-dev libncurses-dev libffi-dev libgdbm-dev
``` ```
A continuación instalaremos un gestor de versiones de Ruby, como rbenv: A continuación instalaremos un gestor de versiones de Ruby, como rbenv:
@@ -33,14 +33,21 @@ wget -qO- https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-installer
source ~/.bashrc source ~/.bashrc
``` ```
## Node.js ## CMake y pkg-config
Para compilar los archivos estáticos (JS, CSS, imágenes, etc.), es necesario un _runtime_ de JavaScript. Node.js es la opción recomendada. Para compilar algunas de las dependencias del proyecto, necesitamos CMake y pkg-config:
Ejecuta en tu terminal:
```bash ```bash
sudo apt install nodejs sudo apt install cmake pkg-config
```
## Gestor de versiones de Node.js
Para compilar los archivos estáticos (JS, CSS, imágenes, etc.), es necesario un _runtime_ de JavaScript. Node.js es la opción recomendada. Para instalar Node.js, instalaremos un gestor de versiones de Node.js, como NVM:
```bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
``` ```
## PostgreSQL ## PostgreSQL
@@ -51,7 +58,7 @@ Instala postgresql y sus dependencias de desarrollo con:
sudo apt install postgresql libpq-dev sudo apt install postgresql libpq-dev
``` ```
Para el correcto funcionamiento de Consul Democracy, necesitas confgurar un usuario para tu base de datos. Como ejemplo, crearemos un usuario llamado "consul": Para el correcto funcionamiento de Consul Democracy, necesitas configurar un usuario para tu base de datos. Como ejemplo, crearemos un usuario llamado "consul":
```bash ```bash
sudo -u postgres createuser consul --createdb --superuser --pwprompt sudo -u postgres createuser consul --createdb --superuser --pwprompt
@@ -65,15 +72,12 @@ Instala Imagemagick:
sudo apt install imagemagick sudo apt install imagemagick
``` ```
## ChromeDriver ## Chrome o Chromium
Para realizar pruebas de integración, usamos Selenium junto a Headless Chrome. Para poder ejecutar los tests de sistema, necesitaremos tener instalado Chrome o Chromium.
Para poder utilizarlo, instala el paquete chromium-chromedrive y asegúrate de que se encuentre enlazado en algún directorio que esté en la variable de entorno PATH:
```bash ```bash
sudo apt install chromium-chromedriver sudo apt install chromium-browser
sudo ln -s /usr/lib/chromium-browser/chromedriver /usr/local/bin/
``` ```
¡Ya estás listo para [instalar Consul Democracy](local_installation.md)! ¡Ya estás listo para [instalar Consul Democracy](local_installation.md)!