Continuous integration scenario (ci)

AI-translated from Russian.

The ODPM_SCENARIO=ci variable prepares a ready-made Docker image of the project: platform sources, addons, Python environment, and configuration are baked into the image; Odoo directories are not mounted from the build machine disk.

Purpose

The build engineer or automation pipeline gets a reproducible artifact: the same code and the same pinned git revisions described in odpm.json and .odpm/deps.lock.json. After the build, the image can be published to a registry and deployed to stands using tools already adopted in the organization.

odpm does not replace GitHub Actions, GitLab CI, or orchestrators — it provides an image build command and a consistent way to run Odoo with the same parameters as the developer and administrator.

Environment behavior

Area	How it works
Image	Created with odpm --build-image (available only in this scenario).
Sources	Inside the image, no host mount.
Python environment	Built during image build, not recreated on every up.
Debugger	None.
Module secrets	Host mount disabled. Optional bake into image: ODPM_BAKE_SECRETS=1 with --build-image — see local secrets, ADR-002.
Version pinning	Strict check of .odpm/deps.lock.json; version incompatibilities in nested manifests — error.
Python warnings in logs	Same as server: PYTHONWARNINGS is not filtered — DeprecationWarning from docutils on Odoo startup remain in build and container output. Account for this in CI logs and image smoke tests.

Typical pipeline

git push → build machine
  → ODPM_SCENARIO=ci
  → odpm --skip-start
  → odpm --build-image [--image-tag registry/project:tag]
  → publish image
  → deploy (your tools)

Checklist

1. In git: odpm.json and committed .odpm/deps.lock.json.
2. On the build machine: Docker, odpm, .env with ODPM_SCENARIO=ci.
3. Before merge: odpm plan --strict — exit code 1 on unexpected changes.
4. Verification: HTTP 200 on /web after docker compose up.

Command examples

export ODPM_SCENARIO=ci
odpm --skip-start
# optional: odpm --secrets-file /secure/ephemeral.json --skip-start
export ODPM_BAKE_SECRETS=1   # bake module secrets into image when secrets.json exists
odpm --build-image --image-tag myregistry/client-odoo:19.0
docker compose up -d
odpm -d test_db -i --odoo-bin --stop-after-init

Non-interactive initialization:

export ODPM_SCENARIO=ci
export ODOO_PROJECTS_DIR=/data/odoo_projects
export BACKUP_DIR=/data/backups
odpm --init https://github.com/aayartsev/odoo_demo_project.git --branch 19.0 --skip-start

See non-interactive runs.