Archivo .env

Para ejecutar la versión dockerizada de la plataforma Navixy, el .env archivo es el archivo de configuración principal. Contiene parámetros importantes como credenciales de la base de datos, nombres de dominio, carpeta de trabajo de instalación de la plataforma y otros.

El .env archivo se usa principalmente durante la instalación inicial de la plataforma. Sin embargo, si necesita cambiar algo en la configuración de una plataforma existente, también deberá modificar este archivo.

Todos los parámetros en este archivo están comentados para una mejor comprensión de con qué se está tratando. Información adicional sobre estos parámetros se describe en las secciones siguientes.

Si cambia cualquier configuración mientras la instancia ya se está ejecutando, los cambios no se aplican de forma instantánea. Debe reinicializar toda la instancia para que surtan efecto. Para hacerlo, desde la carpeta principal de la plataforma (navixy-package), ejecute el comando: docker compose up -d Esto recreará los contenedores con la nueva configuración.

UID y GID

Estos son parámetros de servicio usados únicamente en la etapa de compilación de la plataforma. No necesita cambiarlos.

WORKDIR

Este es un parámetro que indica el directorio de trabajo de la plataforma: donde se almacenan la base de datos y todos los archivos de servicio. Es necesario asegurar este directorio para evitar la pérdida de datos de negocio.

Valor predeterminado de este parámetro: WORKDIR=./work.

Esto significa que /work directorio dentro de la compilación descomprimida de Navixy se utiliza. Si el directorio no existe, se creará.

Si es necesario, puede colocar el directorio de trabajo en cualquier lugar de su sistema. Para ello, especifique la ruta completa al directorio. Ejemplos:

• /home/admin/work

• /usr/local/navixy

Asegúrese de darle al directorio un nombre claro para no eliminarlo por error.

navixy_username

Este es el nombre de usuario usado para el acceso a la base de datos. Siempre es navixy, no lo cambie.

navixy_passwd

Esta es la contraseña para el usuario de la base de datos navixy . Por defecto, este valor está vacío y se le solicita que especifique la contraseña de su elección. Se recomienda generar automáticamente una contraseña robusta, pero la elección es suya; puede especificar lo que desee.

No cambie esta contraseña después de que la base de datos esté creada y la plataforma desplegada.

service_domain

Este es el dominio principal de su instancia de la plataforma. Se utiliza para:

• Acceso a la interfaz de usuario.

• Activación de dispositivos.

En caso de que esté utilizando una instalación de un solo dominio (sin dominios separados para API y panel de administración), este dominio también se usará para:

• Acceso a la API mediante el enlace service_domain/api

• Acceso al panel de administración mediante el enlace service_domain/panel

Esto también puede ser una dirección IP de su servidor si no va a utilizar un nombre de dominio para su servicio.

api_domain

Este parámetro es opcional y se usa sólo para instalaciones de tres dominios.

Aquí debe especificar el nombre de dominio utilizado para acceder a la API de su plataforma.

panel_domain

Este también es un parámetro opcional utilizado para instalaciones de tres dominios.

Aquí debe especificar el nombre de dominio utilizado para acceder al panel de administración de su plataforma.

le_enabled

Este parámetro activa la emisión automática y la reemisión posterior del certificado SSL de Let's Encrypt.

Está true por defecto. Esto significa que cuando despliegue la plataforma, Certbot se configurará y se encargará de la emisión automática de certificados SSL para sus dominios. De este modo, no tendrá que preocuparse por comprar certificados de terceros. La instancia se configurará para estar protegida con SSL.

Si desea usar su propio certificado SSL en lugar de Let's Encrypt, cambie este parámetro a false.

le_email

Esta es la dirección de correo electrónico para recibir información sobre el funcionamiento de Certbot, como caducidad del certificado, revocación del certificado y problemas que puedan impedir la reemisión del certificado.

Por defecto, este parámetro está vacío. Se recomienda que especifique una dirección de correo válida para no perder notificaciones importantes sobre la protección SSL de su sitio web.

redirect_to_https

Esta configuración permite redirigir las solicitudes desde http a https. Si su plataforma está configurada para usar protección SSL y alguien intenta usar una URL que comience con http, se activará una redirección automática a https .

Si el parámetro está desactivado (false) entonces no se producirá ninguna redirección y el sitio web no se abrirá.

Este parámetro es aplicable sólo si la protección SSL está habilitada y el certificado SSL está instalado.

service_ssl_cert and service_ssl_key

Si no tiene previsto usar Let's Encrypt y desea utilizar su propio certificado SSL, debe colocar el certificado para su dominio y su clave privada en el directorio: WORKDIR/nginx/ssl.

Asegúrese de cambiar el le_enabled parámetro a false antes de aplicar cualquier cambio en esta sección. No puede usar sus propios certificados para la plataforma cuando certbot está en ejecución.

Después de que el certificado y la clave estén en su lugar, debe especificar sus nombres de archivo en los parámetros correspondientes de la configuración. Tenga en cuenta que no necesita especificar rutas. Ejemplo:

service_ssl_cert=my_domain_com.crt
service_ssl_key=my_domain_com.key

MYSQL_RANDOM_ROOT_PASSWORD

Este parámetro habilita la generación de una contraseña aleatoria para el usuario root de MySQL. El valor predeterminado es true.

El parámetro se usa sólo durante la inicialización inicial de la base de datos al instalar la plataforma. En reinicios y actualizaciones posteriores de la plataforma no hace nada, y la contraseña permanece igual.

Si prefiere establecer una contraseña root específica para MySQL, cambie el valor a false y proceda al siguiente parámetro.

MYSQL_ROOT_PASSWORD

Aquí especifique la contraseña root para MySQL.

Este parámetro se aplica sólo cuando MYSQL_RANDOM_ROOT_PASSWORD está activado a false. De lo contrario, el valor se ignora.

skip_db_update

Este parámetro deshabilita la actualización de la base de datos cuando el contenedor navixy-standalone-db se inicia. Se utiliza con fines de prueba; no necesita cambiar el valor predeterminado (false) durante el uso regular de la plataforma.