容器¶

概述¶

每个构建版本都隔离在其自己的容器（Linux 命名空间容器）中。

基础是一个Ubuntu系统，其中安装了Odoo所有必需的依赖项以及常见的有用包。

如果您的项目需要额外的 Python 依赖项，或者需要更多最新版本，您可以在分支根目录中定义一个 requirements.txt 文件，列出这些依赖项。平台会将这些依赖项安装到您的容器中。pip requirements specifiers <https://pip.pypa.io/en/stable/reference/pip_install/#requirement-specifiers>`_ 文档可以帮助你编写 requirements.txt 文件。如需具体示例，请查看 Odoo <https://github.com/odoo/odoo/blob/17.0/requirements.txt>`_ 的 requirements.txt 文件。

子模块的：file：requirements.txt 文件也被考虑在内。该平台在包含Odoo模块的每个文件夹中查找：file：`requirements.txt`文件：不是在模块文件夹本身，而是在其父文件夹中。

目录结构¶

由于容器是基于Ubuntu的，因此它们的目录结构遵循linux文件系统层次结构标准。“Ubuntu 的文件系统树概述<https://help.ubuntu.com/community/LinuxFilesystemTreeOverview#Main_directories>”_ 解释了主目录。

以下是 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

Python 2.7 和 3.5 都安装在容器中。然而：

如果您的项目配置为使用Odoo 10.0，则Odoo服务器将与Python 2.7一起运行。
如果您的项目配置为使用Odoo 11.0或更高版本，则Odoo服务器将与Python 3.5一起运行。

数据库外壳¶

使用 shell 访问容器时，可以使用 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=>

请注意！ 使用事务 (BEGIN…COMMIT/ROLLBACK) 来处理每一个会导致更改的 sql 语句（UPDATE、DELETE、ALTER…），尤其是正式运行数据库。

交易机制是您在发生错误时的安全网。您只需回滚更改即可将数据库还原到其以前的状态。

例如，您可能会忘记设置 WHERE 条件。

odoo-addons-master-1=> BEGIN;
BEGIN
odoo-addons-master-1=> UPDATE res_users SET password = '***';
UPDATE 457
odoo-addons-master-1=> ROLLBACK;
ROLLBACK

在这种情况下，您可以回滚以还原您刚刚错误地执行的不需要的更改，并重写语句：

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

但是，不要忘记在完成事务后提交或回滚事务。打开的事务可能会锁定表中的记录，并且正在运行的数据库可能会等待它们被释放。它可能导致服务器无限期挂起。

此外，如果可能，请先使用临时数据库来测试语句。它为您提供了额外的安全网。

运行 Odoo 服务器¶

您可以从容器 shell 启动 Odoo 服务器实例。您将无法使用浏览器从外部世界访问它，但您可以例如：

使用 Odoo shell，

$  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'

装载新的模块

$  odoo-bin -i sale --without-demo=all --stop-after-init

更新模块，

$  odoo-bin -u sale --stop-after-init

运行模块的测试，

$  odoo-bin -i sale --test-enable --log-level=test --stop-after-init

在上面的命令中，参数为：

“–without-demo=all”阻止加载所有模块的演示数据
“—在初始化后停止”将在服务器实例完成您请求的操作后立即将其关闭。

还有更多选项，详见:doc:CLI 文档</developer/reference/cli>。

您可以在日志（~/logs/odoo.log）中找到 Odoo.sh 用于运行服务器的插件路径。查找“odoo：插件路径”：

2018-02-19 10:51:39,267 4 INFO ? odoo: Odoo version 17.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/17.0', '/home/odoo/src/user', '/home/odoo/src/enterprise', '/home/odoo/src/themes', '/home/odoo/src/odoo/addons', '/home/odoo/src/odoo/odoo/addons']

Be careful, especially with your production database. Operations that you perform running this Odoo server instance are not isolated: Changes will be effective in the database. Always, make your tests in your staging databases.

在 Odoo.sh 中调试¶

调试 Odoo.sh 生成与另一个 Python 应用没有什么不同。本文仅介绍 Odoo.sh 平台的特性和限制，并假定您已经知道如何使用调试器。

注解

如果您还不知道如何调试Python应用程序，则可以在Internet上轻松找到多个入门课程。

您可以使用“pdb”，“pudb”或“ipdb”在 Odoo.sh 调试代码。由于服务器在 shell 外部运行，因此您无法直接从 Odoo 实例后端启动调试器，因为调试器需要一个 shell 才能运行。

“pdb <https://docs.python.org/3/library/pdb.html>”_ 默认安装在每个容器中。
如果你想使用`pudb <https://pypi.org/project/pudb/>`_或`ipdb <https://pypi.org/project/ipdb/>`_，你必须先安装它。

为此，您有两种选择：
- 临时（仅在当前版本中）：
  $ pip install pudb --user
  或
  $ pip install ipdb --user
- 永久：将“pudb”或“ipdb”添加到项目“要求.txt”文件中。

然后编辑要触发调试器的代码并添加以下内容：

import sys
if sys.__stdin__.isatty():
    import pdb; pdb.set_trace()

条件：code：`sys.__stdin__.isatty（）`是一个黑客，可以检测你是否从shell运行Odoo。

保存文件，然后运行 Odoo Shell：

$ odoo-bin shell

最后，*通过*Odoo Shell，您可以触发要调试的代码/函数/方法。

Edit on GitHub