2021_02 Actualización de sip 2.0b10 a 2.0b11

Las principales novedades son:

• Require la gema dotenv, instalada globalmente (instala con doas gem install dotenv)
• La rama principal ya no es master sino main.
• Se emplea una nueva convención para manejar variables de configuración como variables de ambiente del sistema operativo, inspirada en https://12factor.net/, verlas en https://github.com/pasosdeJesus/sip/blob/main/doc/convenciones.md#configuraci%C3%B3n-de-aplicac%C3%ADon-ruby-on-rails-en-variables-de-ambiente. En resumen, la configuración ya no se hace copiando varios archivos plantilla sino mediante variables de ambiente que se centralizan en el archivo .env y que se manejan con dotenv-rails en modos de desarrollo y prueba y pasando las variables explícitas en modo de producción.
• Para emplear sip 2.0b11 necesitarás crear un archivo .env que defina las variables de ambiente requeridas por sip y recomendamos que emplees el mismo mecanismo para manejar variables de configuracińo de tu aplicación o motor.
• Emplea la versión 6.1 de rails (ver https://github.com/pasosdeJesus/sip/wiki/2020_12-Actualizaci%C3%B3n-de-rails-6.0-a-rails-6.1).
• Opera con Ruby 3.0

Ayudas para emplear las nuevas convenciones en un motor o en una aplicación

• En el Gemfile cambia
  • la rama de sip (y seguramente de otros motores basados en sip) a main, por ejemplo ubicando:

    gem 'sip', # Motor generico        
     git: 'https://github.com/pasosdeJesus/sip.git'
    

    y cambiando por

    gem 'sip', # Motor generico        
      git: 'https://github.com/pasosdeJesus/sip.git', branch: 'main'
    

  • agrega la gema dotenv-rails en una sección sólo para modos development y test
  • si hace falta en la sección development agrega la gema puma
• Crea un nuevo archivo .env.plantilla en el directorio donde se ejecuta la aplicación, puedes copiar y mejorar el disponible en https://github.com/pasosdeJesus/sip/blob/main/test/dummy/.env.plantilla y mejora las instrucciones de configuración para que comiencen con:

cp .env.plantilla .env
$EDITOR .env

• Sigue las nuevas convenciones respecto a variables de configuración en el ambiente descritas en: https://github.com/pasosdeJesus/sip/blob/main/doc/convenciones.md#configuraci%C3%B3n-de-aplicac%C3%ADon-ruby-on-rails-en-variables-de-ambiente. Y pon especial atención a:
  • config/database.yml donde debes emplear las variables BD_USUARIO, BD_CLAVE, BD_DES, BD_PRUEBA y BD_PRO.
  • config/routes.rb y config/initializers/punto_montaje.rb donde debes emplear la variable RUTA_RELATIVA con el punto de montaje.
  • config/initializers/sip.rb donde debes emplear las variables SIP_RUTA_ANEXOS y SIP_RUTA_VOLCADOS.
  • config/application.rb donde debes emplear CONFIG_HOSTS, RUTA_RELATIVA, SIP_FORMATO_FECHA, SIP_RUTA_VOLCADOS, SIP_RUTA_ANEXOS y las de otros motores.
• Si falta, agrega el archivo CONTRIBUTING.md referenciando el de sip https://github.com/pasosdeJesus/sip/blob/main/CONTRIBUTING.md, pero especificando lo particular de la aplicación (por lo menos primer usuario y clave en aplicacíon).
• Prueba tu aplicación tan ampliamente como sea posible.
• Empuja tus cambios al repositorio y después cambia la rama principal a main --puede ser con las instrucciones de https://www.git-tower.com/learn/git/faq/git-rename-master-to-main/. En el caso de github hay funcionalidad que lo facilita ahora. Desde la configuración en branches permite renombrar master por main con el ícono de un lapiz. Tras este cambio en los computadores donde se use el repositorio cambiar con:

git checkout master
git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a

• Y si se trata de un motor, en las aplicaciones que usen el motor debe agregarse branch: :main