Configuración de la aplicación:

Siguiendo las recomendaciones en the twelve factor app Cacao Accounting puede leer la configuración desde variables del entorno, la configuración requerida es:

# Requeridas
$CACAO_DB          # URI para conectarse a la base de datos.
$CACAO_KEY         # Llave única para una ejecución segura.
# Opcionales
$CACAO_USER        # Identificador del usuario administrador.
                   # Si no se establece se usa "cacao" por defecto.
$CACAO_PWD         # Contraseña del usuario administrador.
                   # Si no se establece se usa "cacao" por defecto.
$CACAO_THREADS     # Numero de hilos para el servidor WSGI.
                   # si no se establece se estable a 4 por defecto.
$CACAO_PORT        # Puerto para servir la aplicacion a utilizar.
                   # Si no se especifica se utiliza 8080 por defecto.
$FLASK_ENV         # Modo de ejecución del proyecto puede ser "development" o "production"
                   # Si no se especifica se utiliza "production" por defecto.
                   # Referencias:
                   #  - https://flask.palletsprojects.com/en/2.0.x/config/
$PYTHON_CPU_COUNT  # En entornos basados en contenedores se utilizan nucles de CPU
                   # por defecto, puede establecer un valor por defecto, puede
                   # establecer otro valor estableciendo esta variable de entorno.
$CACHE_REDIS_URL   # URL para utilizar REDIS/VALKEY como cache
                   # Ejemplo: CACHE_REDIS_URL=redis://localhost:6379/0

Establecer variables del entorno requeridas:

En Linux se puede configurar Cacao Accounting ejecutando:

# Para configurar Cacao Accounting en Linux ejecutar:
export CACAO_DB=DATABASE_CONNECTION_URI
export CACAO_KEY=SECRETKEY

En Windows ejecutar:

setx CACAO_DB "DATABASE_CONNECTION_URI"
setx CACAO_KEY "SECRETKEY"

En un Dockerfile o en un archivo Docker compose se pueden configurar de la siguiente forma:

ENV CACAO_ACCOUNTING=True
ENV CACAO_DB=DATABASE_CONNECTION_URI
ENV CACAO_KEY=SECRETKEY

Conexion a la base de datos

Cacao Accounting puede funcionar con SQLite, MySQL, Postgresql y en buena teoría con MariaDB pero no realizamos pruebas automaticas con este motor de bases de datos:

SQLite:

No se requiere software adicional para trabajar con SQLite, sin embargo no se recomienda para entornos multi usuarios:

La linea de conección es por ejemplo:

sqlite://cacaoaccounting.db

MySQL:

Para funcionar con MySQL asegurece de tener instalado el driver apropiado:

pip install cryptography pymysql

La linea de conección es por ejemplo:

mysql+pymysql://ususario:contraseña@servidor:puerto/database

mysql+pymysql://cacao:cacao@localhost:3306/cacao

Postgresql:

Para funcionar con Postgresql asegurece de tener instalado el driver apropiado:

pip install psycopg2-binary

La linea de conección es por ejemplo:

postgresql+psycopg2://usuario:contraseña@servidor:puerto/database

postgresql+psycopg2://cacao:cacao@localhost:5432/cacao

MS SQL Server:

Para funcionar con MS SQL Server asegurece de tener instalado el driver de python apropiado, adicionalmente debe configurar el cliente de ODBC para su sistema operativo.

pip install pyodbc

La linea de conección es por ejemplo:

mssql+pyodbc://usuario:contraseña@servidor:puerto/database?driver=DRIVER

mssql+pyodbc://SA:cacao+SQLSERVER2019@localhost:1433/cacao?driver=ODBC+Driver+17+for+SQL+Server

En el ejemplo anterior se usa la version 17 del cliente ODBS para SQL Server