Instrucciones de Despliegue

El presente documento tiene como finalidad detallar la lista de instrucciones básicas requeridas para el despliegue correcto de la aplicación en azure

Instrucciones de despliegue para la aplicación OMC- Collector-Back-Office:

1. Configurar la lista de variables dentro del key vault: Consultar la sección variables de entorno

2. Configurar la lista de parámetros para la conexión a base de datos:

Donde:

DB_HOST: Nombre del host donde está alojado el servidor Postgres
DB_NAME: Nombre de la base de datos. EJ: bd-database-DEV
IMPORTANTE: No se usa la configuración interna del connection string el app services
DB_HOST: Nombre del host donde está alojado en el servidor Postgres

Se elaboraron pruebas usando el connection string directamente del azure y no se logró la conectividad dado a que python usa una cadena de conexión específica (Ver imagen de referencia)

Sin embargo, todos los parámetros mencionados son configurables desde los app settings y los key-vault. Para mayor información por favor consultar:

https://github.com/Azure/azure-sql-database-samples/tree/master/django/django-pyodbc-azure https://stackoverflow.com/questions/43717906/how-to-connect-a-microsoft-azure-sql-server-to-django-webapp https://stackoverflow.com/questions/43630573/link-azure-connection-string-with-django-webapp

Por último, se configura la IP del app services collector-back-office dentro del firewall de la base de datos de collector-back:

3. Configurar el parámetro para las Key Vault:

Donde:

KEY_VAULT_URL: Url donde están configuradas las key vault a usar por el sistema.

4. Dentro del comando de inicio en configuración colocar: Startup.sh

Este archivo o script contiene todos los parámetros que permiten el inicio de la aplicación, los cuales son:

a. Instalación de paquetes python.
b. Instalación de librerías para la generación de los PDF.
c. Configuración de los cron jobs que corre la verificación de las alertas o pagos que se van a vencer o están vencidas.
d. Comando gunicorn de arranque de la aplicación.

Nota:

a. La configuración del cron jobs están en el archivo cron.sh y el tiempo esta expresado en segundos (86400) que representa cada 24 horas.

b. Si por algún motivo se crea el siguiente app setings SCM_DO_BUILD_DURING_DEPLOYMENT, hay que eliminarlo o colocarle el valor de False dado a que crea el site en la carpeta temp y no en el wwwroot.

6. Una vez configurados estos pasos, solicitar a Darien Technology el commit para el despliegue, lográndose ver en:

7. Para el cambio de los correos de oficinas, se debe hacer directamente por base de datos en la tabla collector_oficina como muestra la imagen:

Nota: Validar el correo de BVI si es DEV, QA o PROD

8. Para la carga de la data inicial es necesario correr el script “OMC - CollectorLoadDataScript ”, el cual contiene la data de las siguientes tablas:

a. auth_user
b. collector_jurisdiccion
c. collector _estatus
d. collector _razon
e. collector _tipoinvoice
f. collector _oficina

Nota: Se debe validar que las jurisdicciones no están repetidas.

10. Configuración del TimeZone para hora Panama:

Se debe colocar el app settings TZ con el valor America/Panama

Para verificar la hora ejecutar el comando date sobre la consola del kudu