Saltar a contenido

Instalar Etendo - Guía interactiva

Visión general

IMPORTANTE: ESTA ES UNA VERSIÓN BETA

Está en desarrollo activo y puede contener funcionalidades inestables o incompletas. Úsela bajo su propia responsabilidad. El comportamiento del módulo puede cambiar sin previo aviso. No la utilice en entornos de producción.

Utilice el Sistema de configuración interactiva para instalar y configurar Etendo. El asistente le guía por cada ajuste, aplica valores predeterminados seguros y realiza cambios solo después de que usted los confirme.

Beneficios clave:

  • Guía paso a paso con ayuda en línea para cada propiedad.
  • La entrada sensible (contraseñas, tokens) se detecta y se oculta.
  • Los ajustes se agrupan por categoría (Base de datos, Seguridad, Aplicación, etc.).
  • Validación integrada y un paso de confirmación antes de aplicar cambios.
  • Copias de seguridad automáticas de los archivos de configuración existentes antes de las actualizaciones.
  • Configuración más rápida y con menos errores en comparación con la edición manual.

Requisitos

Antes de comenzar, es necesario disponer de:

Proceso de instalación interactiva

Preparar el entorno

Elija el formato de instalación y prepare los archivos base:

  1. Clone el proyecto Etendo Base en el directorio /opt:

    Terminal
    cd /opt/
git clone https://github.com/etendosoftware/etendo_base.git EtendoERP

  2. Vaya al directorio de instalación:

    Terminal
    cd /opt/EtendoERP

  3. Añada las credenciales de GitHub al archivo gradle.properties:

    gradle.properties
    githubUser=<username>
githubToken=<*******>

  4. Expanda Etendo Base:

    Terminal
    ./gradlew expand

  1. Clone el proyecto Etendo Base en el directorio /opt:

    Terminal
    cd /opt/
git clone https://github.com/etendosoftware/etendo_base.git EtendoERP

  2. Vaya al directorio de instalación:

    Terminal
    cd /opt/EtendoERP

  3. Añada las credenciales de GitHub al archivo gradle.properties:

    gradle.properties
    githubUser=<username>
githubToken=<*******>

  4. Descomente la dependencia del core en build.gradle:

    build.gradle
    implementation('com.etendoerp.platform:etendo-core:<version>')

  1. Clone el proyecto Etendo Base en el directorio /opt:

    Terminal
    cd /opt/
git clone https://github.com/etendosoftware/etendo_base.git EtendoERP

  2. Vaya al directorio de instalación:

    Terminal
    cd /opt/EtendoERP

  3. Añada las credenciales de GitHub al archivo gradle.properties:

    gradle.properties
    githubUser=<username>
githubToken=<*******>

  4. Añada la dependencia del bundle Platform Extensions:

    build.gradle
    dependencies {
    implementation ('com.etendoerp:platform.extensions:2.6.0') // 2.6.0 o superior.
}

  5. Expanda Etendo Base:

    Terminal
    ./gradlew expand

Iniciar la configuración interactiva

Inicie el asistente de configuración interactiva:

Terminal
./gradlew setup -Pinteractive=true --console=plain

Será posible ver el menú principal de configuración:

🎛️  Configuración interactiva - Menú principal
============================================================

📋 Elija una opción de configuración:

1️⃣  Configuración predeterminada (usar valores actuales/predeterminados)
2️⃣  Configuración por grupos:
   📦 a. all - Configurar todos los grupos
   📋 b. Configuración de base de datos
   📋 c. Ajustes de seguridad
   📋 d. Ajustes de la aplicación
3️⃣  Salir sin guardar

🎯 Seleccione una opción:

Configurar propiedades

Al seleccionar un grupo de configuración, se le guiará por cada propiedad, por ejemplo:

📋 Configuración de base de datos
==================================================

🔧 Propiedad: bbdd.host
   ℹ️  Nombre de host o dirección IP del servidor de base de datos
   Valor actual: localhost
✏️  Nuevo valor: [Enter para mantener el actual, o escriba un nuevo valor]

🔧 Propiedad: bbdd.port
   ℹ️  Número de puerto del servidor de base de datos
   Valor actual: 5432
✏️  Nuevo valor: [Enter para mantener el actual, o escriba un nuevo valor]

🔧 Propiedad: bbdd.password
   ℹ️  Contraseña de conexión a la base de datos
   Valor actual: 
🔐 Nuevo valor (oculto): [La entrada de contraseña está oculta]

Consejos de configuración de propiedades

  • Pulse Enter para mantener el valor actual/predeterminado.
  • Escriba nuevos valores para sobrescribir los valores predeterminados.
  • Las propiedades sensibles (contraseñas, tokens) ocultarán su entrada.
  • Las propiedades obligatorias deben tener un valor para continuar.

Revisar el resumen de configuración

Antes de aplicar los cambios, se mostrará un resumen completo:

📊 Resumen de configuración
============================================================

📋 Configuración de base de datos:
   🔧 bbdd.host = localhost
   🔧 bbdd.port = 5432
   🔧 bbdd.password = ********

📋 Ajustes de seguridad:
   🔧 githubToken = ********
   🔧 nexusPassword = ********

📋 Ajustes de la aplicación:
   🔧 context.name = etendo

📊 Total: 6 propiedades configuradas
🔐 Incluye 3 propiedades sensibles (mostradas enmascaradas)

✅ ¿Confirmar configuración? (Y/N):

Lista de verificación de revisión

  • Todas las propiedades obligatorias tienen valores.
  • Los detalles de conexión a la base de datos son correctos.
  • Las credenciales de GitHub/Nexus están configuradas correctamente.
  • El nombre de contexto de la aplicación es el deseado.

Completar la instalación

Después de confirmar la configuración:

  1. Las propiedades se guardan en gradle.properties (con copia de seguridad automática).
  2. La configuración tradicional se ejecuta automáticamente.
  3. La instalación continúa con los ajustes configurados.

Complete el proceso de instalación:

Terminal
# Installation
./gradlew install smartbuild

# Start Tomcat
sudo /etc/init.d/tomcat start
Terminal
# Dependencies
./gradlew dependencies

# Installation
./gradlew install smartbuild

# Start Tomcat
sudo /etc/init.d/tomcat start
Terminal
# Launch Docker services
./gradlew resources.up

# Installation
./gradlew install smartbuild

Acceder a su instalación

Abra el navegador y navegue a:

  • Instalación estándar: https://<Public server IP>/<Context Name>
  • Desarrollo local: http://localhost:8080/etendo

Características avanzadas

Volver a ejecutar la configuración interactiva

Es posible ejecutar la configuración interactiva de nuevo en cualquier momento:

Terminal
./gradlew setup -Pinteractive=true --console=plain

Esto:

  • Mostrará los valores actuales de configuración.
  • Permitirá al usuario modificar cualquier ajuste.
  • Creará nuevas copias de seguridad antes de aplicar los cambios.

Modo depuración

Para la resolución de problemas, habilite la salida de depuración:

Terminal
./gradlew setup -Pinteractive=true --debug --console=plain

Configuración de propiedades de módulos personalizados

Si su proyecto incluye módulos personalizados con un archivo config.gradle, sus propiedades de configuración se añaden automáticamente a la configuración interactiva. Los nombres de las propiedades se conservan exactamente tal y como se declaran en config.gradle, y se admiten claves personalizadas en gradle.properties.

Info

Visite la Guía del desarrollador para obtener detalles sobre la Configuración interactiva para módulos personalizados.

This work is licensed under CC BY-SA 2.5 ES by Futit Services S.L.