consul/grecia
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update macOS local installation instructions

Browse Source
This commit is contained in:
taitus
2024-08-06 19:27:19 +02:00
committed by Javi Martín
parent 996885b8c8
commit e46fc35d31
8 changed files with 82 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/es/installation/local_installation.md
View File

@@ -39,6 +39,8 @@ cp config/database.yml.example config/database.yml
6. Configura las credenciales de base de datos con tu usuario `consul` en tu nuevo fichero `database.yml`
Nota: este paso no es necesario si estás utilizando un usuario de base de datos sin contraseña y el mismo nombre de usuario que tu usuario de sistema, que es el comportamiento por defecto en macOS.
```bash
nano config/database.yml
```

89
docs/es/installation/macos.md
View File

@@ -1,55 +1,56 @@
# Configuración para los entornos de desarrollo y pruebas (Mac OS X)
# Configuración para los entornos de desarrollo y pruebas (macOS Sonoma 14.6)
## Homebrew
Homebrew es un gestor de paquetes para OS X muy popular. Es recomendable usarlo pues facilita enormemente la instalación de algunos de los paquetes necesarios.
Homebrew es un gestor de paquetes para macOS muy popular. Es recomendable usarlo pues facilita enormemente la instalación de algunos de los paquetes necesarios.
Puedes encontrar las instrucciones de instalación en: [brew.sh](http://brew.sh)
## XCode y XCode Command Line Tools
## Git
Para utilizar git necesitarás instalar *Xcode* (está en la Mac App Store) y las *Xcode Command Line Tools* (se instalan desde el menú de Xcode).
Puedes instalar git:
## Git y Github
Puedes descargar git desde: [git-scm.com/download/mac](https://git-scm.com/download/mac)
```bash
brew install git
```
## Gestor de versiones de Ruby
OS X ya viene con una versión preinstalada de ruby, pero es bastante vieja y en nuestro caso no nos sirve. Una de las formas de instalar Ruby es a través de rbenv. Las instrucciones de instalación están en su GitHub y son bastante claras:
[github.com/rbenv/rbenv](https://github.com/rbenv/rbenv)
## Node.js
Para compilar los archivos estáticos (JS, CSS, imágenes, etc.), es necesario un _runtime_ de JavaScript. OS X viene con un _runtime_ integrado llamado `Apple JavaScriptCore` pero Node.js es la opción recomendada.
Para instalar Node, puedes usar [n](https://github.com/tj/n)
Ejecuta el siguiente comando en tu terminal:
macOS ya viene con una versión preinstalada de ruby, pero necesitamos una versión más reciente. Una de las formas de instalar Ruby es a través de un gestor de versiones de Ruby como [rbenv](https://github.com/rbenv/rbenv):
```bash
curl -L https://git.io/n-install | bash -s -- -y lts
brew install rbenv
rbenv init
source ~/.zprofile
```
Y este instalará automáticamente la versión LTS (_Long Term Support_, inglés para "Soporte a largo plazo") más reciente de Node en tu directorio `$HOME` (Este comando hace uso de [n-install](https://github.com/mklement0/n-install))
## CMake y pkg-config
## PostgreSQL (>=9.4)
Para compilar algunas de las dependencias del proyecto, necesitamos CMake y pkg-config:
```bash
brew install postgres
brew install cmake pkg-config
```
Una vez instalado es necesario *inicializar* la instalación:
## Gestor de versiones de Node.js
Para compilar los archivos estáticos (JS, CSS, imágenes, etc.), es necesario un _runtime_ de JavaScript. macOS viene con un _runtime_ integrado llamado `Apple JavaScriptCore` pero Node.js es la opción recomendada. Para instalar Node.js, instalaremos un gestor de versiones de Node.js, como NVM:
```bash
initdb /usr/local/var/postgres
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.zprofile
```
## PostgreSQL
```bash
brew install postgresql
```
Ahora vamos a configurar algunos aspectos del usuario por defecto. Primero iniciamos el servidor de postgres con:
```bash
postgres -D /usr/local/var/postgres
brew services start postgresql
```
Llegados a este punto se supone que tenemos postgres correctamente instalado y se nos habrá creado un usuario por defecto (cuyo nombre es nuestro nombre de usuario), y que (todavía) no tiene contraseña.
@@ -68,36 +69,20 @@ En el caso de que quieras asignarte una contraseña puedes hacerlo desde la cons
ALTER USER tu_nombre_usuario WITH PASSWORD 'tu_contraseña';
```
Ahora vamos a crear el usuario *consul*, que es el que utiliza la aplicación. Ejecuta sobre la consola de postgres:
```sql
CREATE ROLE consul WITH PASSWORD '000';
ALTER ROLE consul WITH SUPERUSER;
ALTER ROLE consul WITH login;
```
Si en algún momento durante la instalación de PostgreSQL y sospechas que te has equivocado y deseas desinstalarlo y volver a empezar desde cero:
```bash
brew uninstall postgres
```
También tendrás que borrar el siguiente directorio para que no de conflictos cuando intentes volver a instalarlo (fuente: [gist.github.com/lxneng/741932](https://gist.github.com/lxneng/741932)):
```bash
rm -rf /usr/local/var/postgres
```
## ChromeDriver
```bash
brew install chromedriver
```
## Imagemagick
Instala Imagemagick:
```bash
brew install imagemagick
```
Ahora que ya tenemos todas las dependencias instalado podemos proceder con la [instalación de Consul Democracy](local_installation.md)
## Chrome o Chromium
Para poder ejecutar los tests de sistema, necesitaremos tener instalado Chrome o Chromium.
```bash
brew install google-chrome
```
¡Ya estás listo para [instalar Consul Democracy](local_installation.md)!

2
docs/es/installation/prerequisites.md
View File

@@ -2,5 +2,5 @@
* [Ubuntu Linux](ubuntu.md)
* [Debian Linux](debian.md)
* [MacOS](macos.md)
* [macOS](macos.md)
* [Windows](windows.md)