Contenedores¶
Información general¶
Cada compilación está aislada dentro de su propio contenedor (un contenedor de espacio de nombres de Linux).
La base es un sistema Ubuntu en donde se instalan todas las dependencias necesarias de Odoo y sus paquetes comunes útiles.
Si su proyecto necesita dependencias adicionales de Python, o lanzamientos más recientes, colóquelas en un archivo requirements.txt
en su rama principal. La plataforma se encargará de instalar las dependencias en sus contenedores. La documentación sobre especificadores de requisitos pip puede ayudarle a redactar su archivo requirements.txt
. Revise el archivo requirements.txt de Odoo para visualizar un ejemplo concreto.
También se consideran los archivos requirements.txt
en los submódulos. La plataforma busca los archivos requirements.txt
en todas las carpetas con módulos de Odoo: no en la carpeta del módulo, sino en su carpeta principal.
Estructura del directorio¶
Como los contenedores están basados en Ubuntu, la estructura de su directorio sigue el estándar de jerarquía del sistema de archivos de Linux. En la información general del árbol de sistema de archivos de Ubuntu puede encontrar la explicación de los directorios principales.
A continuación se encuentran los directorios correspondientes de Odoo.sh:
.
├── home
│ └── odoo
│ ├── src
│ │ ├── odoo Odoo Community source code
│ │ │ └── odoo-bin Odoo server executable
│ │ ├── enterprise Odoo Enterprise source code
│ │ ├── themes Odoo Themes source code
│ │ └── user Your repository branch source code
│ ├── data
│ │ ├── filestore database attachments, as well as the files of binary fields
│ │ └── sessions visitors and users sessions
│ └── logs
│ ├── install.log Database installation logs
│ ├── odoo.log Running server logs
│ ├── update.log Database updates logs
│ └── pip.log Python packages installation logs
└── usr
├── lib
│ ├── python2.7
│ └── dist-packages Python 2.7 standard libraries
│ ├── python3
│ └── dist-packages Python 3 standard libraries
│ └── python3.5
│ └── dist-packages Python 3.5 standard libraries
├── local
│ └── lib
│ ├── python2.7
│ │ └── dist-packages Python 2.7 third-party libraries
│ └── python3.5
│ └── dist-packages Python 3.5 third-party libraries
└── usr
└── bin
├── python2.7 Python 2.7 executable
└── python3.5 Python 3.5 executable
Se instala Python 2.7 y 3.5 en los contenedores, pero:
Si su proyecto está configurado para usar Odoo 10.0, el servidor de Odoo se ejecuta con Python 2.7.
Si su proyecto está configurado para usar Odoo 11.0 o superior, el servidor de Odoo se ejecuta con Python 3.5.
Shell de la base de datos¶
Al acceder a un contenedor con el shell, puede acceder a la base de datos con psql.
odoo@odoo-addons-master-1.odoo.sh:~$ psql
psql (9.5.2, server 9.5.11)
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.
odoo-addons-master-1=>
Advertencia: use transacciones (BEGIN…COMMIT/ROLLBACK) para cada declaración sql que produzca cambios (UPDATE, DELETE, ALTER, etc.), en especial en su base de datos de producción.
El mecanismo de transacción es su red de seguridad en caso de que ocurra un error, solo debe revertir sus cambios para restaurar su base de datos a un estado anterior.
Por ejemplo, tal vez olvidó establecer su condición WHERE.
odoo-addons-master-1=> BEGIN;
BEGIN
odoo-addons-master-1=> UPDATE res_users SET password = '***';
UPDATE 457
odoo-addons-master-1=> ROLLBACK;
ROLLBACK
En ese caso, puede revertir para anular los cambios no deseados que hizo por accidente y volver a escribir la declaración:
odoo-addons-master-1=> BEGIN;
BEGIN
odoo-addons-master-1=> UPDATE res_users SET password = '***' WHERE id = 1;
UPDATE 1
odoo-addons-master-1=> COMMIT;
COMMIT
Sin embargo, no olvide confirmar o revertir su transacción después de hacerla. Las transacciones abiertas pueden bloquear registros en sus tablas y puede que su base de datos en ejecución espere hasta que se liberen, lo que causa una pausa indefinida en su servidor.
Además, cuando sea posible, utilice sus bases de datos de prueba para probar sus declaraciones, esto proporciona una red de seguridad adicional.
Ejecutar un servidor de Odoo¶
Puede iniciar una instancia de servidor de Odoo desde el shell del contenedor. No podrá acceder a ella con un navegador, pero puede:
Usar el shell de Odoo.
$ odoo-bin shell
>>> partner = env['res.partner'].search([('email', '=', 'asusteK@yourcompany.example.com')], limit=1)
>>> partner.name
'ASUSTeK'
>>> partner.name = 'Odoo'
>>> env['res.partner'].search([('email', '=', 'asusteK@yourcompany.example.com')], limit=1).name
'Odoo'
Instalar un módulo.
$ odoo-bin -i sale --without-demo=all --stop-after-init
Actualizar un módulo.
$ odoo-bin -u sale --stop-after-init
Ejecutar las pruebas de un módulo.
$ odoo-bin -i sale --test-enable --log-level=test --stop-after-init
En los comandos anteriores, el argumento:
--without-demo=all
evita que los datos de demostración se carguen en todos los módulos.--stop-after-init
cerrará de inmediato la instancia del servidor tras completar las operaciones que le pidió.
Hay más opciones disponibles, estas se describen en la documentación de la interfaz de línea de comandos.
En los registros (~/logs/odoo.log) puede encontrar la ruta de complementos que Odoo.sh utiliza para ejecutar su servidor. Busque «odoo: addons paths»:
2018-02-19 10:51:39,267 4 INFO ? odoo: Odoo version 16.0
2018-02-19 10:51:39,268 4 INFO ? odoo: Using configuration file at /home/odoo/.config/odoo/odoo.conf
2018-02-19 10:51:39,268 4 INFO ? odoo: addons paths: ['/home/odoo/data/addons/16.0', '/home/odoo/src/user', '/home/odoo/src/enterprise', '/home/odoo/src/themes', '/home/odoo/src/odoo/addons', '/home/odoo/src/odoo/odoo/addons']
Tenga precaución, en particular con su base de datos de producción. Las operaciones que realice al ejecutar esta instancia de servidor de Odoo no están aisladas y los cambios serán efectivos en la base de datos. Siempre haga sus pruebas en sus bases de datos de prueba.
Depuración de bugs en Odoo.sh¶
La depuración de bugs de una compilación de Odoo.sh no es muy diferente a alguna otra aplicación de Python. Este artículo solo explica las especificaciones y limitaciones de la plataforma de Odoo.sh, además, asume que ya sabe cómo usar un depurador.
Nota
Si aún no sabe cómo depurar bugs de una aplicación de Python, hay varios cursos introductorios que puede encontrar en internet con facilidad.
Puede usar pdb
, pudb
o ipdb
para depurar los bugs de su código de Odoo.sh. Como el servidor se ejecuta fuera de un shell, no puede activar el depurador desde el backend de su instancia de Odoo ya que el depurador necesita un shell para funcionar.
En cada contenedor se instala pdb de forma predeterminada.
Si desea usar pudb o ipdb, debe instalarlos antes.
Para hacerlo, tiene dos opciones:
de forma temporal (solo en la compilación actual):
$ pip install pudb --user
o
$ pip install ipdb --user
de forma permanente si agrega
pudb
oipdb
al archivorequirements.txt
de su proyecto.
Luego edite el código en el que desea activar el depurador y agregue lo siguiente:
import sys
if sys.__stdin__.isatty():
import pdb; pdb.set_trace()
La condición sys.__stdin__.isatty()
detecta si está ejecutando Odoo desde un shell.
Guarde el archivo y ejecute el shell de Odoo:
$ odoo-bin shell
Por último, a través del shell de Odoo, puede activar el código, función o método que desea depurar.