mintsystem/odoo

Mint System Odoo 镜像文档

镜像概述

Mint System Odoo 镜像是对官方Odoo镜像的改进版本，基于特定修订版本构建，确保构建可重复性。该镜像优化了包管理、配置方式、插件处理等核心功能，同时集成多种开发与运维工具，适合Odoo应用的部署、测试及日常管理。

核心功能与特性

• 高效包管理：使用uv管理Python依赖，pnpm管理Node依赖
• 灵活配置：通过环境变量管理odoo.conf配置，无需手动修改配置文件
• 插件处理：支持从Git仓库克隆插件，自动检测嵌套模块文件夹
• 数据库集成：会话信息可存储于数据库，支持指定模块初始化数据库
• 安全运行：无需root权限即可运行容器
• 工具集成：内置https://github.com/acsone/manifestoo%E5%92%8Chttps://github.com/acsone/click-odoo-contrib%E5%B7%A5%E5%85%B7
• 镜像优化：通过多阶段构建和文件清理减小镜像体积
• 健康检查：内置健康检查机制，确保容器运行状态
• 测试支持：可运行模块测试并生成代码覆盖率报告

源码与更新日志

• 源码：https://github.com/Mint-System/Odoo-Build/tree/main/images/odoo/
• 更新日志：<[***]>

支持的标签

• 19.0.20251008、19.0
• 18.0.20251008、18.0
• 17.0.20251008、17.0
• 16.0.20251008、16.0

使用方法

该镜像支持基础配置与高度自定义配置，可通过环境变量灵活调整。

最小配置

以下是最小化compose.yml配置示例：

yml
services:
  odoo:
    container_name: odoo
    image: mintsystem/odoo:18.0.20251008
    depends_on:
      - db
    environment:
      PGHOST: db
      PGUSER: odoo
      PGPASSWORD: odoo
    ports:
      - "127.0.0.1:8069:8069"
    volumes:
      - odoo-data:/var/lib/odoo
  db:
    container_name: db
    image: postgres:14-alpine
    environment:
      POSTGRES_USER: odoo
      POSTGRES_PASSWORD: odoo
      PGDATA: /var/lib/postgresql/data/pgdata
    volumes:
      - db-data:/var/lib/postgresql/data/pgdata
volumes:
  odoo-data:
  db-data:

自定义配置

以下compose.yml展示完整自定义配置选项：

yml
services:
  odoo:
    container_name: odoo
    image: mintsystem/odoo:18.0.20251008
    depends_on:
        db:
            condition: service_healthy
    environment:
      PGHOST: db
      PGUSER: odoo
      PGPASSWORD: odoo
      PGPORT: 5432
      DB_NAME: odoo
      DB_MAXCONN: 128
      PGSSLMODE: verify-ca
      PGSSLROOTCERT: /mnt/postgres-secret/ca.crt
      SMTP_SERVER: mail.infomaniak.com
      SMTP_PORT: 587
      SMTP_SSL: True
      SMTP_USER: odoo@yourcompany.com
      SMTP_PASSWORD: **
      EMAIL_FROM: odoo@yourcompany.com
      MAIL_BOUNCE_ALIAS: bounce
      MAIL_CATCHALL_ALIAS: reply
      MAIL_CATCHALL_DOMAIN: yourcompany.com
      MAIL_DEFAULT_FROM: odoo
      MAIL_ALIAS_DOMAIN: yourcompany.com
      ODOO_MAIL_SMTP_HOST: mail.infomaniak.com
      ODOO_MAIL_SMTP_PORT: 587
      ODOO_MAIL_SMTP_ENCRYPTION: starttls
      ODOO_MAIL_SMTP_FROM_FILTER: odoo@yourcompany.com
      ODOO_MAIL_IMAP_HOST: mail.infomaniak.com
      ODOO_MAIL_IMAP_PORT: 993
      ODOO_MAIL_IMAP_SSL: True
      ODOO_MAIL_USERNAME: odoo@yourcompany.com
      ODOO_MAIL_PASSWORD: **
      GIT_SSH_PUBLIC_KEY: "ssh-ed25519 BBBBC3NzaC1lZDI1NTE5BBBBIDR9Ibi0mATjCyx1EYg594oFkY0rghtgo+pnFHOvAcym Mint-System-Project-MCC@github.com"
      GIT_SSH_PRIVATE_KEY: "LS0tLS1CRUdJTiBPUEVOU1NIIFBSSVZBVEUgS0VZLS0tLQpiM0JsYm5OemFDMXJaWGt0ZGpFQUFBQUFCRzV2Ym1VQUFBQUVibTl1WlFBQUFBQUFBQUFCQUFBQU13QUFBQXR6YzJndFpXClF5TlRVeE9RQUFBQ0EwZlNHNHRKZ0U0d3NzZFJHSU9mZUtCWkdOSzRJYllLUHFaeFJ6cndITXBnQUFBS2k1WkJhRnVXUVcKaFFBQUFBdHpjMmd0WldReU5UVXhPUUFBQUNBMGZTRzR0SmdFNHdzc2RSR0lPZmVLQlpTks0SWJZS1BxWnhSenJ3SE1wZwowQkFnTT0KLS0tLS1FTkQgT1BFTlNTSCBQUklWQVRFIEtFWS0tLS0tCg=="
      GITHUB_USERNAME: bot-mintsys
      GITHUB_PAT: **
      GITLAB_URL: https://gitlab.com
      GITLAB_USERNAME: bot-mintsys
      GITLAB_PAT: **
      FORGEJO_URL: https://codeberg.org
      FORGEJO_USERNAME: bot-mintsys
      FORGEJO_PAT: **
      ADDONS_GIT_REPOS: "git@github.com:Mint-System/Odoo-Apps-Server-Tools.git#16.0,git@github.com:OCA/server-tools.git#16.0"
      ODOO_ADDONS_PATH: /mnt/addons/,/mnt/enterprise/,/mnt/oca/,/mnt/themes/
      ODOO_DATABASE: "16.0"
      ODOO_INIT_LOGIN: odoo
      ODOO_INIT_PASSWORD: **
      ODOO_INIT_LANG: de_CH
      ODOO_INIT_ADDONS: server_environment_ir_config_parameter
      RUNNING_ENV: production
      WITHOUT_DEMO: False
      PYTHON_INSTALL: prometheus-client
      SERVER_WIDE_MODULES: session_db,module_change_auto_install
      SESSION_DB_URI: postgres://odoo:odoo@db/16.0
      PROXY_MODE: False
      LOG_LEVEL: debug
      MAX_CRON_THREADS: 4
      LIST_DB: True
      LOG_DB: True
      LOG_HANDLER: [':INFO']
      LOGFILE: None
      ADMIN_PASSWD: **
      DB_FILTER: ^%d$
      WORKERS: 4
      LIMIT_REQUEST: 16384
      LIMIT_TIME_CPU: 300
      LIMIT_TIME_REAL: 600
      LIMIT_MEMORY_HARD: 2684354560
      LIMIT_MEMORY_SOFT: 2147483648
      LIMIT_MEMORY_HARD_GEVENT: 1048579
      LIMIT_MEMORY_SOFT_GEVENT: 1048576
      MODULE_AUTO_INSTALL_DISABLED: odoo_test_xmlrunner
      AUTO_UPDATE_MODULES: True
      TEST_ADDONS_DIR: /mnt/oca/partner-contact
      TEST_INCLUDE: partner_firstname
      TEST_EXCLUDE: partner_fax
      AUTO_UPDATE_TRANSLATIONS: True
      AUTO_UPDATE_MODULES_LIST: True
      ADDITIONAL_ODOO_RC: "syslog = True"
      IR_CONFIG_PARAMETER: "web.base.url = https://odoo.example.com"
    ports:
      - "127.0.0.1:8069:8069"
    volumes:
      - odoo-data:/var/lib/odoo
      - ./addons:/mnt/addons
      - ./oca:/mnt/oca
      - ./enterprise:/mnt/enterprise
      - ./themes:/mnt/themes
  db:
    container_name: db
    image: postgres:14-alpine
    environment:
      POSTGRES_USER: odoo
      POSTGRES_PASSWORD: odoo
      PGDATA: /var/lib/postgresql/data/pgdata
    volumes:
      - db-data:/var/lib/postgresql/data/pgdata
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U odoo -d $ODOO_DATABASE"]
      interval: 5s
      timeout: 5s
      retries: 5
volumes:
  odoo-data:
  db-data:

生命周期

该镜像设计了完整的生命周期管理，包括初始化、启动、执行、分析和测试阶段。

初始化

容器启动前可通过以下脚本初始化数据库和插件：

• 下载Odoo企业版模块：

  bash
  docker compose exec odoo download-git-archive
  

• 克隆插件仓库：

  bash
  docker compose exec odoo clone-git-addons
  

• 初始化Odoo数据库：

  bash
  docker compose exec odoo init-db
  

启动

容器启动时，entrypoint.sh脚本将自动执行以下步骤：

1. 调用aggregate-git-repos克隆模块仓库
2. 执行template-odoo-rc生成odoo.conf配置文件
3. 通过set-addons-path组装插件路径
4. 运行install-python-packages安装Python依赖
5. 等待数据库就绪
6. 若启用，执行update-modules更新模块
7. 若启用，执行update-modules-list更新模块列表
8. 若启用，执行update-translations更新翻译
9. 启动Odoo服务

执行

容器运行中可执行以下操作管理模块：

• 安装模块：

  bash
  docker compose exec odoo init-module partner_firstname
  

• 更新指定模块：

  bash
  docker compose exec odoo update-module partner_firstname
  

• 更新所有模块：

  bash
  docker compose exec odoo update-modules
  

• 更新模块列表：

  bash
  docker compose exec odoo update-modules-list
  

• 更新翻译：

  bash
  docker compose exec odoo update-translations
  

分析

使用内置manifestoo工具查询模块清单文件，例如列出所有模块：

bash
docker exec odoo bash -c "manifestoo --select-found list --separator=,"

测试

执行以下步骤运行模块测试并生成覆盖率报告：

1. 准备测试环境：

   bash
   docker exec odoo setup-tests
   

2. 运行测试：

   bash
   docker exec odoo run-tests
   

环境变量配置

数据库连接

SMTP服务器

邮件系统参数

邮件服务器配置（数据库级）

模块仓库配置

插件路径

数据库初始化

| 变量名 | 描述