camptocamp/odoo-project

docker-odoo-project

镜像概述和主要用途

本镜像作为Odoo项目的基础镜像。单独使用时不具备功能，因为其不包含任何Odoo代码。需通过继承本镜像并在Dockerfile中添加项目代码来使用。项目必须遵循特定结构，可参考示例。详见变更日志。

核心功能和特性

• 提供Odoo项目运行的基础环境配置
• 声明数据卷用于Odoo文件存储
• 默认暴露Odoo服务端口
• 支持通过环境变量配置Odoo参数和迁移行为

配置说明

数据库主机

数据库主机默认为db。

数据卷

声明卷/data/odoo，用于存储Odoo的文件存储（该路径在openerp.cfg中设置）。

暴露端口

默认暴露8069和8072端口。

环境变量

MIGRATE

MIGRATE取值为True或False，决定是否启动迁移工具marabunta。默认启动迁移。

MARABUNTA_MODE

在Marabunta版本中，可声明额外执行模式（如demo或full），用于选择迁移时执行的操作和加载的附加组件。典型使用场景：

• 在基础模式（始终执行）下安装附加组件集
• 在demo模式下加载数据摘要（用于测试实例）
• 在full模式下加载完整数据集（用于集成和生产服务器）

测试服务器可设置MARABUNTA_MODE=demo，生产服务器设置MARABUNTA_MODE=full。

MARABUNTA_ALLOW_SERIE

默认情况下，Marabunta不允许一次执行多个版本升级，因为若代码版本（如9.2.0）与迁移脚本版本（如9.1.0）不一致，可能存在风险。生产服务器通常只需从N-1升级到N版本，此限制适用；但开发或测试服务器可能需要连续运行所有迁移脚本，此时可设置MARABUNTA_ALLOW_SERIE=True。

MARABUNTA_FORCE_VERSION

开发或测试迁移时，可通过MARABUNTA_FORCE_VERSION=<version>强制升级特定版本。

DEMO

DEMO取值为True或False，决定Odoo是否加载演示数据。仅在数据库创建时生效。

LOCAL_USER_ID

容器内默认用户ID为9001。使用主机卷时，该ID会用于在主机文件系统写入文件。9001通常在主机系统中不存在，可避免与实际用户冲突。若需使用主机系统用户ID，可设置LOCAL_USER_ID，使容器与主机共享该ID，确保主机卷中创建的文件用户一致。

Odoo配置选项

Odoo的主要配置选项可通过环境变量设置，变量名与配置选项名相同（大写形式），例如workers对应WORKERS。完整列表可参考9.0/etc/openerp.cfg.tmpl。

大多数变量可在docker-compose文件中设置，以适应不同环境，但ADDONS_PATH必须在项目的Dockerfile中设置，例如：

dockerfile
ENV ADDONS_PATH=/opt/odoo/local-src,/opt/odoo/external-src/server-tools,/opt/odoo/src/addons

在Dockerfile中设置此值可确保其在构建时集成，保持各环境一致性。此外，可在项目Dockerfile中添加其他ENV变量，自定义项目的默认配置值。

使用场景和适用范围

适用于构建Odoo项目的开发、测试和生产环境，尤其适合需要标准化基础配置、迁移流程和用户权限管理的场景。

使用方法

1. 继承本镜像创建项目Dockerfile
2. 在项目Dockerfile中添加Odoo代码和依赖
3. 配置ADDONS_PATH等必要环境变量
4. 根据环境需求设置其他环境变量（如MARABUNTA_MODE、DEMO等）
5. 构建并运行项目镜像