pasosdeJesus/msip

View on GitHub
doc/requisitos.md

Summary

Maintainability
Test Coverage
# Requisitos

* Recomendamos emplear la distribución adJ 7.5 del sistema operativo OpenBSD,
  que ya incluye configurada la pila de software que presentamos a 
  continuación.
  Puedes consultar sobre el uso de Ruby on Rails en adJ en
  <https://pasosdejesus.org/doc/usuario_adJ/conf-programas.html#ruby>
* Ruby versión >= 3.3.3
* Ruby on Rails >= 7.1.3
* PostgreSQL >= 16.2 con extensión `unaccent` disponible y posibilidad
  de crearle un usuario con permisos para crear bases de datos
* `node.js` >= 18.10.1 y `coffescript` instalado globalmente 
  (i.e.  `doas npm install -g coffee-script`)
* Una cuenta en el sistema operativo para desarrollo, esta cuenta 
  debe tener permiso de usar al menos 1024M en RAM y para abrir al menos 
  2048 archivos.  
  Para asegurarlo, en adJ como superusuario pon un valor alto al 
  máximo de archivos que el kernel puede abrir
  simultáneamente en la variable de configuración `kern.maxfiles`, por
  ejemplo 32568 en `/etc/sysctl.conf`, y en la clase de la cuenta de desarrollo
  (en `/etc/login.conf`) que al menos diga
  `:datasize-cur=1024M:` y  `:openfiles-cur=2048:`  --recuerda ejecutar
  `cap_mkdb /etc/login.conf` después de modificar `/etc/loginf.conf`
* `yarn` instalado globalmente
  ```
  doas npm install -g yarn
  ```
* Gema `dotenv` instalada globalmente i.e `doas gem install dotenv`
* Gema `foreman` instalada globalmente i.e `doas gem install foreman`
* Recomendado usar `bundler` para mantener gemas en un
  directorio de la forma `/var/www/bundler-miusuario`, ejecutando:
  ```
  doas mkdir /var/www/bundler-$USER
  doas chown $USER:www /var/www/bundler-$USER
  bundle config path /var/www/bundler-$USER/
  ```
  o asegurando que el archivo ~/.bundle/config contiene:
  ```
  ---
  BUNDLE_PATH: "/var/www/bundler-miusuario/"
  ```
* Recomendamos emplear `zsh`, `tmux` y `vim` con los archivos de configuración
  e instrucciones disponibles en
  <https://gitlab.com/pasosdeJesus/adJ/-/blob/main/arboldd/usr/local/share/adJ/archconf/README.md>