Releases: aayartsev/odpm
4.7.0-beta
4.7.0-beta
English
4.7.0-beta is the first pre-release of the 4.7 line on branch 4.7.0-dev. For production, stay on 4.6.0 (APT/YUM stable, regular PyPI). This beta is available only in testing repos and on TestPyPI.
We ship beta so that before final 4.7.0 we can verify:
- installing from
.deband.rpmattached to this GitHub Release; - adding APT/YUM
testingand upgrading from 4.6.0; - installing via pip from the test PyPI index;
- that
odpm --versionreports 4.7.0-beta, and thatodpm plan/odpm --skip-startwork with scenario overlays, compose prefix, layered.env, and compose stack network.
What's new in this release
-
Scenario manifest overlays — optional
scenariosblock in nestedodpm.json(developer,server,ci) to overrideodoo_conf, extra composeservices,service_patches,requirements,dependencies, andhooksper scenario.ODPM_SCENARIOin.envselects the effective slice at load. ADR-011. -
Compose stack prefix — optional
ODPM_COMPOSE_PREFIXin.envrenames built-in services (acme-db,acme-odoo), the postgres volume, and the Docker Compose project name while manifest sidecars keep logicaldepends_on: ["db"]. ADR-012. -
Layered
.env—~/.odpm/.envholds shared defaults; project.envoverrides per environment (ports, prefix, custom${VAR}keys). ADR-013. -
Compose stack network — optional
ODPM_COMPOSE_NETWORK/ODPM_COMPOSE_NETWORK_EXTERNALin.envattach the full stack to one named network (managed bridge or external reverse proxy). ADR-014.
Versions (short)
| Question | Answer for beta |
|---|---|
| Which odpm version is installed? | 4.7.0-beta (odpm --version) |
| Recommended production version? | 4.6.0 (stable) |
Must I change odpm.json in my project? |
No — overlays, prefix, and network are opt-in |
Manifest with scenarios? |
Set requires_odpm: "4.7.0" (recommended) |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.7.0~beta-1_all.deb or add the APT repo (testing suite) — beta guide · stable 4.6.0 |
| Fedora 40+ | download odpm-4.7.0-beta.fc*.noarch.rpm or add the YUM repo (testing) — beta guide · stable 4.6.0 |
| pip | test PyPI index only (command below) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.7.0~beta-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.7.0-beta.fc*.noarch.rpm
# pip — test index (beta)
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.7.0-beta'
odpm --version
# expected: odpm version: 4.7.0-betaDocumentation
- Installing odpm (stable 4.6.0) — recommended for production
- Installing odpm (4.7.0-beta) — matches this pre-release
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.7.0-beta — предварительная версия odpm 4.7 перед финальным релизом 4.7.0. Для эксплуатации в production оставайтесь на 4.6.0 (APT/YUM ветка stable, обычный pip install odpm с PyPI). Beta доступна в репозиториях APT/YUM testing и через тестовый каталог PyPI.
Мы выпускаем beta, чтобы перед финальным 4.7.0 проверить:
- установку из
.debи.rpm, приложенных к этому GitHub Release; - подключение APT/YUM
testingи обновление с 4.6.0; - установку через
pipиз тестового каталога PyPI; - корректный вывод
odpm --version(4.7.0-beta); - работу
odpm planиodpm --skip-startс scenario overlays, compose prefix, layered.envи compose network.
Что нового
-
Scenario overlays в manifest — необязательный блок
scenariosв nestedodpm.jsonдля переопределенияodoo_conf,services,service_patches,requirements,dependenciesиhooksпо сценарию. -
Префикс compose-стека — необязательный
ODPM_COMPOSE_PREFIXв.envдля изоляции встроенных сервисов и имени проекта Docker Compose. -
Layered
.env— общие настройки в~/.odpm/.env, переопределения в project.env. -
Compose-сеть стека — необязательные
ODPM_COMPOSE_NETWORK/ODPM_COMPOSE_NETWORK_EXTERNALдля одной именованной сети на весь стек.
Версии (кратко)
| Вопрос | Ответ для beta |
|---|---|
| Какая версия odpm установлена? | 4.7.0-beta (odpm --version) |
| Рекомендуемая версия для production? | 4.6.0 (stable) |
Нужно ли менять odpm.json? |
Нет — overlays, prefix и network опциональны |
Manifest со scenarios? |
Укажите requires_odpm: "4.7.0" (рекомендуется) |
Установка
Сверяйте контрольную сумму по файлу SHA256SUMS из GitHub Release.
| Платформа | Способ |
|---|---|
| Debian/Ubuntu | скачайте odpm_4.7.0~beta-1_all.deb или подключите APT testing — инструкция для beta · stable 4.6.0 |
| Fedora 40+ | скачайте odpm-4.7.0-beta.fc*.noarch.rpm или подключите YUM testing — инструкция для beta · stable 4.6.0 |
| pip | только тестовый каталог (команда ниже) |
sudo apt install ./odpm_4.7.0~beta-1_all.deb
# или
sudo dnf install ./odpm-4.7.0-beta.fc*.noarch.rpm
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.7.0-beta'
odpm --version
# ожидается: odpm version: 4.7.0-betaДокументация
- Установка odpm (stable 4.6.0) — для production
- Установка odpm (4.7.0-beta) — соответствует этой предварительной версии
- Подробный список изменений для разработчиков: CHANGELOG.md
Обратная связь
Если установка или обновление не удались — сообщите в issue: укажите способ установки (deb / rpm / pip), вывод odpm --version и описание ошибки.
4.6.0
4.6.0
English
4.6.0 is the recommended version for everyday use. It replaces 4.5.0. Pre-release 4.6.0-beta checked that .deb / .rpm packages install, APT/YUM repos work, and pip install succeeds; stable is available from APT/YUM suite stable, regular PyPI (pip install odpm), and stable documentation.
What's new in this release
-
Targeted docker-compose changes — in an extended
odpm.jsonyou can patch the built-in Odoo and PostgreSQL services (ports, environment, command) without replacing the whole service block. Extra containers can setcommandandentrypoint. See odpm.json. -
Plugin compose patches — plugins may supply small compose adjustments; settings from your project's
odpm.jsontake priority. Plugins written for the previous API still load. See Plugins. -
Compose checks before start — odpm validates the generated
docker-compose.ymlstructure during prepare and reports problems early (fordeveloper,server, andciscenarios). -
Variables in compose and hooks —
${VAR}in extra services and in shell hook commands; optionaluserandttyfor auxiliary containers. See odpm.json and plugins. -
Odoo settings in git — store team settings such as
proxy_mode,workers, ordbfilterinodpm.json; they apply inside the container when odpm buildsodoo.conf, without overwriting your local file on disk. Keys managed by odpm itself cannot be overridden. See odoo.conf. -
Clearer
odpm plan— fewer false warnings when you use--plan-stricton projects that already have a materialized runtime config.
Versions (short)
| Question | Answer |
|---|---|
| Which odpm version is installed? | 4.6.0 (odpm --version) |
Must I change odpm.json in my project? |
No — existing projects keep working; the extended nested format is optional |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.6.0-1_all.deb or add the APT repo (stable suite) — stable guide |
| Fedora 40+ | download odpm-4.6.0.fc*.noarch.rpm or add the YUM repo (stable) — stable guide |
| pip | pip install odpm |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.6.0-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.6.0.fc*.noarch.rpm
# pip
pip install 'odpm==4.6.0'
odpm --version
# expected: odpm version: 4.6.0Documentation
- Installing odpm (stable) — recommended for production
- Local dev from scratch (stable) — demo project odoo_demo_project (Odoo 19.0)
- Plugins (stable)
- Archived beta: 4.6.0-beta install guide
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.6.0 — рекомендуемая версия для повседневной работы. Заменяет 4.5.0. Предварительная 4.6.0-beta помогла проверить установку из .deb и .rpm, а так же работу APT/YUM-репозиториев и работу команды pip install; стабильный выпуск доступен в ветке APT/YUM stable, через обычный pip install odpm и в документации stable.
Что нового в этой версии
-
Точечные правки docker-compose — в расширенном
odpm.jsonможно менять встроенные сервисы Odoo и PostgreSQL (порты, переменные окружения, команда запуска), не переписывая весь блок сервиса. У дополнительных контейнеров можно задатьcommandиentrypoint. См. odpm.json. -
Правки compose от плагинов — плагины могут предлагать небольшие изменения compose; настройки из
odpm.jsonвашего проекта важнее. Плагины под предыдущий API по-прежнему загружаются. См. Плагины. -
Проверка compose до запуска — при подготовке окружения odpm проверяет структуру сгенерированного
docker-compose.ymlи сообщает о проблемах заранее (сценарииdeveloper,server,ci). -
Переменные в compose и хуках —
${VAR}в дополнительных сервисах и в командах shell-хуков; при необходимости можно указать параметрыuserиttyу вспомогательных контейнеров. См. odpm.json и плагины. -
Настройки Odoo в git — параметры вроде
proxy_mode,workersилиdbfilterизodoo.confможно хранить вodpm.json; они попадут в финальный файлodoo.confвнутри контейнера, не перезаписывая ваш локальный файл на диске. Ключи, которыми управляет сам odpm, переопределить нельзя. См. odoo.conf. -
odpm planстал вести себя спокойнее — меньше ложных предупреждений при--plan-strict, если runtime-конфиг проекта уже собран.
Версии (кратко)
| Вопрос | Ответ |
|---|---|
| Какая версия odpm установлена? | 4.6.0 (odpm --version) |
Нужно ли менять odpm.json? |
Нет — существующие проекты работают как раньше; переход на расширенный вложенный формат осуществляется по желанию |
Установка
Сверяйте checksum по SHA256SUMS из GitHub Release.
| Платформа | Способ |
|---|---|
| Debian/Ubuntu | odpm_4.6.0-1_all.deb или APT stable — stable |
| Fedora 40+ | odpm-4.6.0.fc*.noarch.rpm или YUM stable — stable |
| pip | pip install odpm |
sudo apt install ./odpm_4.6.0-1_all.deb
sudo dnf install ./odpm-4.6.0.fc*.noarch.rpm
pip install 'odpm==4.6.0'
odpm --version
# ожидается: odpm version: 4.6.0Документация
- Установка odpm (stable)
- Локальная разработка с нуля (stable)
- Плагины (stable)
- Архив beta: 4.6.0-beta
- CHANGELOG.md
Обратная связь
Если установка или обновление не удались — issue: способ установки (deb / rpm / pip), вывод odpm --version, описание ошибки.
4.6.0-beta
4.6.0-beta
English
4.6.0-beta is the first pre-release of the 4.6 debt-closure line on branch 4.6.0-dev. For production, stay on 4.5.0 (APT/YUM stable, regular PyPI). This beta is available only in testing repos and on TestPyPI.
We ship beta so that before final 4.6.0 we can verify:
- installing from
.deband.rpmattached to this GitHub Release; - adding APT/YUM
testingand upgrading from 4.5.0; - installing via pip from the test PyPI index;
- that
odpm --versionreports 4.6.0-beta, and thatodpm plan/odpm --skip-startwork with manifest v2service_patches, plugin API 1.1, and compose validation.
What's new in this release
-
Compose service patches (D2) — manifest v2
service_patchesandmerge_services_with_patchesto patch built-inodoo/ Postgres without full service replace; sidecarcommand/entrypointfor extra services (ADR-009). -
Config hub phase 2 (D3) — narrowed
BootstrapHandle;manifest_view/repo_odpm_jsononHostProjectContext; plan/prepare coupling guards (ADR-003 amendment). -
Plugin API 1.1 (D4) — load-time version check; optional
compose_service_patcheson compose plugins; nested dependencyservices/service_patchesinherit (host wins). -
Compose validation + golden snapshots (D5) — structural
compose/validate.py;compose.validateprepare step; regression fixtures per scenario (developer/server/ci). -
Ops / docs hygiene (D1) — post-deploy Pages verify (
verify_pages_deploy.sh); legacyservices_ru.mdredirect.
Versions (short)
| Question | Answer for beta |
|---|---|
| Which odpm version is installed? | 4.6.0-beta (odpm --version) |
| Recommended production version? | 4.5.0 (stable) |
Must I change odpm.json in my project? |
No — flat v1 projects keep working; manifest v2 / service_patches remain opt-in |
| Plugin API | 1.1 supported; 1.0 plugins still load |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.6.0~beta-1_all.deb or add the APT repo (testing suite) — beta guide · stable 4.5.0 |
| Fedora 40+ | download odpm-4.6.0-beta.fc*.noarch.rpm or add the YUM repo (testing) — beta guide · stable 4.5.0 |
| pip | test PyPI index only (command below) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.6.0~beta-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.6.0-beta.fc*.noarch.rpm
# pip — test index (beta)
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.6.0-beta'
odpm --version
# expected: odpm version: 4.6.0-betaDocumentation
- Installing odpm (stable 4.5.0) — recommended for production
- Installing odpm (4.6.0-beta) — matches this pre-release
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.6.0-beta — предварительная версия odpm 4.6 перед финальным релизом 4.6.0. Для эксплуатации в production оставайтесь на 4.5.0 (APT/YUM ветка stable, обычный pip install odpm с PyPI). Beta доступна в репозиториях APT/YUM testing и через тестовый каталог PyPI.
Мы выпускаем beta, чтобы перед финальным 4.6.0 проверить следующее:
- установку из
.debи.rpm, приложенных к этому GitHub Release; - подключение APT/YUM
testingи обновление с уже установленной 4.5.0; - установку через
pipиз тестового каталога PyPI; - корректный вывод
odpm --version(4.6.0-beta); - работу
odpm planиodpm --skip-startна типичных проектах.
Что нового в этой версии
-
Точечные правки docker-compose — в расширенном
odpm.jsonможно изменить отдельные параметры встроенных сервисов Odoo и Postgres, не переписывая весь блок сервиса. Для дополнительных контейнеров можно задать команду запуска и точку входа. -
Надёжнее план и подготовка проекта — odpm чаще читает настройки из одного согласованного контекста; снижен риск скрытых связей между этапами
planи подготовкой окружения. -
Расширения (плагины) — поддерживается обновлённый API 1.1; плагины для API 1.0 по-прежнему загружаются. Плагин может предложить правки docker-compose; настройки из зависимостей проекта подмешиваются с приоритетом вашего
odpm.json. -
Проверка docker-compose перед применением — odpm сверяет сгенерированный compose с ожидаемой структурой, чтобы ошибки конфигурации обнаруживались раньше.
Версии (кратко)
| Вопрос | Ответ для beta |
|---|---|
| Какая версия odpm установлена? | 4.6.0-beta (odpm --version) |
| Рекомендуемая версия для production? | 4.5.0 (stable) |
Нужно ли менять odpm.json? |
Нет — прежний формат работает; расширенные возможности подключаются по желанию |
Установка
Сверяйте контрольную сумму по файлу SHA256SUMS из GitHub Release.
| Платформа | Способ |
|---|---|
| Debian/Ubuntu | скачайте odpm_4.6.0~beta-1_all.deb или подключите APT testing — инструкция для beta · stable 4.5.0 |
| Fedora 40+ | скачайте odpm-4.6.0-beta.fc*.noarch.rpm или подключите YUM testing — инструкция для beta · stable 4.5.0 |
| pip | только тестовый каталог (команда ниже) |
sudo apt install ./odpm_4.6.0~beta-1_all.deb
# или
sudo dnf install ./odpm-4.6.0-beta.fc*.noarch.rpm
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.6.0-beta'
odpm --version
# ожидается: odpm version: 4.6.0-betaДокументация
- Установка odpm (stable 4.5.0) — для production
- Установка odpm (4.6.0-beta) — соответствует этой предварительной версии
- Подробный список изменений для разработчиков: CHANGELOG.md
Обратная связь
Если установка или обновление не удались — сообщите в issue: укажите способ установки (deb / rpm / pip), вывод odpm --version и описание ошибки.
4.5.0
4.5.0
English
4.5.0 is the first stable release of the 4.5 line on branch 4.5-dev. It supersedes 4.4.3 as the recommended production version. Pre-release 4.5.0-beta verified packaging, docs channels, and integration gates; stable uses APT/YUM suite stable, production PyPI, and docs alias stable.
What's new in this release
-
Plugins 2.0 — stable extension API 1.0,
post_clonehooks, plan preview for hooks and compose fragments, project-local plugins under.odpm/plugins/. -
Structured YAML compose — host
ruamel.yamlengine merges manifest and plugin service fragments deterministically (compose output stable vs 4.4 for typical projects). -
Mandatory integration gates — every PR to
4.5-devruns compose-smoke and HTTP smoke (Mailpit fixture); weekly jobs cover golden-path, CI image build, and deb install smoke. -
Full host gettext coverage — user-facing CLI, plan, and prepare messages go through
_()/plan_msg(); CI job i18n blocks missing Russian catalog entries. -
Scenario base Dockerfile profiles — developer full, server medium, CI ci base images (Debian 12/13); slimmer CI base without browser/IDE stack. First run after upgrade may rebuild the base image once (
odoo_image_nameincludes profile suffix). -
Config hub slimming — plan, prepare, and runtime read typed
host_ctx/PipelinePortsinstead of a monolithicConfigwhere possible (ADR-003).
Versions (short)
| Question | Answer |
|---|---|
| Which odpm version is installed? | 4.5.0 (odpm --version) |
Must I change odpm.json in my project? |
No — flat v1 projects keep working; manifest v2 remains opt-in |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.5.0-1_all.deb or add the APT repo (stable suite) — stable guide |
| Fedora 40+ | download odpm-4.5.0.fc*.noarch.rpm or add the YUM repo (stable) — stable guide |
| pip | pip install odpm (production PyPI) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.5.0-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.5.0.fc*.noarch.rpm
# pip — production
pip install 'odpm==4.5.0'
odpm --version
# expected: odpm version: 4.5.0Documentation
- Installing odpm (stable) — recommended for production
- Local dev from scratch (stable) — demo project odoo_demo_project (Odoo 19.0)
- Plugins (stable)
- Archived beta: 4.5.0-beta install guide
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.5.0 — первый stable-релиз линии 4.5 (ветка 4.5-dev). Заменяет 4.4.3 как рекомендуемую production-версию. Pre-release 4.5.0-beta проверил packaging, docs и integration-гейты; stable использует APT/YUM suite stable, production PyPI и alias docs stable.
Что нового
-
Плагины 2.0 — стабильный extension API 1.0, хуки
post_clone, шаги plan для hooks и compose-фрагментов, локальные плагины в.odpm/plugins/. -
Структурный YAML compose — host-движок на
ruamel.yamlдетерминированно мержит manifest и plugin services (типичный compose-вывод совместим с 4.4). -
Обязательные integration-гейты — каждый PR в
4.5-devпроходит compose-smoke и HTTP smoke; weekly jobs — golden-path, сбор CI-образа, deb smoke. -
Полное gettext-покрытие host — пользовательские строки CLI, plan и prepare через
_()/plan_msg(); CI job i18n ловит пропуски в ru_RU каталоге. -
Профили base Dockerfile по сценарию — developer full, server medium, CI ci (Debian 12/13); CI base без browser/IDE. После апгрейда возможна однократная пересборка base image (суффикс профиля в
odoo_image_name). -
Утоньшение Config hub — plan/prepare/runtime читают
host_ctx/PipelinePortsвместо монолитногоConfigгде возможно (ADR-003).
Версии (кратко)
| Вопрос | Ответ |
|---|---|
| Какая версия odpm установлена? | 4.5.0 (odpm --version) |
Нужно ли менять odpm.json? |
Нет — flat v1 проекты работают; manifest v2 по-прежнему opt-in |
Установка
Сверяйте checksum по SHA256SUMS из GitHub Release.
| Платформа | Способ |
|---|---|
| Debian/Ubuntu | odpm_4.5.0-1_all.deb или APT stable — stable |
| Fedora 40+ | odpm-4.5.0.fc*.noarch.rpm или YUM stable — stable |
| pip | pip install odpm (production PyPI) |
sudo apt install ./odpm_4.5.0-1_all.deb
sudo dnf install ./odpm-4.5.0.fc*.noarch.rpm
pip install 'odpm==4.5.0'
odpm --version
# ожидается: odpm version: 4.5.0Документация
- Установка odpm (stable)
- Локальная разработка с нуля (stable)
- Плагины (stable)
- Архив beta: 4.5.0-beta
- CHANGELOG.md
Обратная связь
Если установка или обновление не удались — issue: способ установки (deb / rpm / pip), вывод odpm --version, описание ошибки.
4.5.0-beta
4.5.0-beta
English
4.5.0-beta is the first pre-release of the 4.5 line on branch 4.5-dev. For production, stay on 4.4.3 (APT/YUM stable, regular PyPI). This beta is available only in testing repos and on TestPyPI.
We ship beta so that before final 4.5.0 we can verify:
- installing from
.deband.rpmattached to this GitHub Release; - adding APT/YUM
testingand upgrading from 4.4.3; - installing via pip from the test PyPI index;
- that
odpm --versionreports 4.5.0-beta, and thatodpm plan/odpm --skip-startwork with plugins, manifest v2, and the new integration smoke gates.
What's new in this release
-
Plugins 2.0 — stable extension API 1.0,
post_clonehooks, plan preview for hooks and compose fragments, project-local plugins under.odpm/plugins/. -
Structured YAML compose — host
ruamel.yamlengine merges manifest and plugin service fragments deterministically (compose output stable vs 4.4 for typical projects). -
Mandatory integration gates — every PR to
4.5-devruns compose-smoke and HTTP smoke (Mailpit fixture); weekly jobs cover golden-path, CI image build, and deb install smoke. -
Full host gettext coverage — user-facing CLI, plan, and prepare messages go through
_()/plan_msg(); CI job i18n blocks missing Russian catalog entries. -
Scenario base Dockerfile profiles — developer full, server medium, CI ci base images (Debian 12/13); slimmer CI base without browser/IDE stack. First run after upgrade may rebuild the base image once (
odoo_image_nameincludes profile suffix). -
Config hub slimming — plan, prepare, and runtime read typed
host_ctx/PipelinePortsinstead of a monolithicConfigwhere possible (ADR-003).
Versions (short)
| Question | Answer for beta |
|---|---|
| Which odpm version is installed? | 4.5.0-beta (odpm --version) |
| Recommended production version? | 4.4.3 (stable) |
Must I change odpm.json in my project? |
No — flat v1 projects keep working; manifest v2 remains opt-in |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.5.0~beta-1_all.deb or add the APT repo (testing suite) — beta guide · stable 4.4.3 |
| Fedora 40+ | download odpm-4.5.0-beta.fc*.noarch.rpm or add the YUM repo (testing) — beta guide · stable 4.4.3 |
| pip | test PyPI index only (command below) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.5.0~beta-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.5.0-beta.fc*.noarch.rpm
# pip — test index (beta)
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.5.0-beta'
odpm --version
# expected: odpm version: 4.5.0-betaDocumentation
- Installing odpm (stable 4.4.3) — recommended for production
- Installing odpm (4.5.0-beta) — matches this pre-release
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.5.0-beta — первая beta линии 4.5 (ветка 4.5-dev). Для production оставайтесь на 4.4.3 (APT/YUM stable, обычный PyPI). Beta доступна только в репозиториях testing и на тестовом каталоге PyPI.
Мы выпускаем beta, чтобы перед финальным 4.5.0 проверить:
- установку из
.debи.rpmиз этого GitHub Release; - подключение APT/YUM
testingи обновление с 4.4.3; - установку через pip из тестового каталога PyPI;
- вывод
odpm --version(4.5.0-beta) и работуodpm plan/odpm --skip-startс плагинами, manifest v2 и новыми integration smoke-гейтами.
Что нового
-
Плагины 2.0 — стабильный extension API 1.0, хуки
post_clone, шаги plan для hooks и compose-фрагментов, локальные плагины в.odpm/plugins/. -
Структурный YAML compose — host-движок на
ruamel.yamlдетерминированно мержит manifest и plugin services (типичный compose-вывод совместим с 4.4). -
Обязательные integration-гейты — каждый PR в
4.5-devпроходит compose-smoke и HTTP smoke; weekly jobs — golden-path, сбор CI-образа, deb smoke. -
Полное gettext-покрытие host — пользовательские строки CLI, plan и prepare через
_()/plan_msg(); CI job i18n ловит пропуски в ru_RU каталоге. -
Профили base Dockerfile по сценарию — developer full, server medium, CI ci (Debian 12/13); CI base без browser/IDE. После апгрейда возможна однократная пересборка base image (суффикс профиля в
odoo_image_name). -
Утоньшение Config hub — plan/prepare/runtime читают
host_ctx/PipelinePortsвместо монолитногоConfigгде возможно (ADR-003).
Версии (кратко)
| Вопрос | Ответ для beta |
|---|---|
| Какая версия odpm установлена? | 4.5.0-beta (odpm --version) |
| Рекомендуемая production-версия? | 4.4.3 (stable) |
Нужно ли менять odpm.json? |
Нет — flat v1 проекты работают; manifest v2 по-прежнему opt-in |
Установка
Сверяйте checksum по SHA256SUMS из GitHub Release.
| Платформа | Способ |
|---|---|
| Debian/Ubuntu | odpm_4.5.0~beta-1_all.deb или APT testing — beta · stable 4.4.3 |
| Fedora 40+ | odpm-4.5.0-beta.fc*.noarch.rpm или YUM testing — beta · stable 4.4.3 |
| pip | только тестовый индекс (команда ниже) |
sudo apt install ./odpm_4.5.0~beta-1_all.deb
# или
sudo dnf install ./odpm-4.5.0-beta.fc*.noarch.rpm
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.5.0-beta'
odpm --version
# ожидается: odpm version: 4.5.0-betaДокументация
- Установка odpm (stable 4.4.3) — для production
- Установка odpm (4.5.0-beta) — эта pre-release
- CHANGELOG.md
Обратная связь
Если установка или обновление не удались — issue: способ установки (deb / rpm / pip), вывод odpm --version, описание ошибки.
4.4.3
4.4.3
English
4.4.3 is a stable patch release on 4.4-dev. It supersedes 4.4.2 as the recommended production version. Pre-release 4.4.3-beta verified packaging and docs channels; stable uses APT/YUM suite stable, production PyPI, and docs alias stable.
What's new in this release
-
Clearer
odpm planwarnings — plan checks and compose preview rely only on your project settings inodpm.jsonand lock files, not on odpm’s internal configuration; fewer misleading warnings when you have not changed the project. -
Optional sync of git pins into
odpm.json— afterodpm --update-lock, add--sync-manifest-locks(developer scenario) to copy collected pins from.odpm/deps.lock.jsoninto thelocks.gitsection ofodpm.json. Without the flag,odpm planreminds you that the manifest file was not updated. -
Easier to see where git dependency pins come from — when the environment is prepared, the log states whether pins are taken from
locks.gitinodpm.jsonor from.odpm/deps.lock.json; warnings about drift between those sources are available in your UI language. -
Plan boundary cleanup (maintainer) — lock plan warnings and compose preview evaluate paths use clearer host/manifest boundaries; contract tests guard against regressions.
Versions (short)
| Question | Answer |
|---|---|
| Which odpm version is installed? | 4.4.3 (odpm --version) |
Must I change odpm.json in my project? |
No — if the project already worked, you do not need to touch odpm_version: "4.0" |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.4.3-1_all.deb or add the APT repo (stable suite) — stable guide |
| Fedora 40+ | download odpm-4.4.3.fc*.noarch.rpm or add the YUM repo (stable) — stable guide |
| pip | pip install odpm (production PyPI) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.4.3-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.4.3.fc*.noarch.rpm
# pip — production
pip install 'odpm==4.4.3'
odpm --version
# expected: odpm version: 4.4.3Documentation
- Installing odpm (stable) — recommended for production
- Local dev from scratch (stable) — demo project odoo_demo_project (Odoo 19.0)
- Dependency lock and manifest sync (stable)
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.4.3 — stable patch-релиз на 4.4-dev. Заменяет 4.4.2 как рекомендуемую production-версию. Pre-release 4.4.3-beta проверил каналы packaging и docs; stable использует APT/YUM suite stable, production PyPI и alias docs stable.
Что нового в этой версии
-
Понятнее предупреждения в
odpm plan— проверка плана и превью compose опираются только на настройки вашего проекта вodpm.jsonи lock-файлах, а не на внутреннюю конфигурацию odpm; меньше ложных сигналов, если вы сами проект не меняли. -
Синхронизация git-блокировок в
odpm.json— по желанию — послеodpm --update-lockможно добавить флаг--sync-manifest-locks(сценарий developer): тогда разделlocks.gitвodpm.jsonобновится из собранного.odpm/deps.lock.json. Без флагаodpm planнапомнит, что файл manifest не менялся. -
Видно, откуда берутся версии git-зависимостей — при подготовке окружения в лог пишется, используются ли пины из
locks.gitвodpm.jsonили из.odpm/deps.lock.json; предупреждения о расхождении между этими источниками выводятся на языке интерфейса. -
Граница plan-слоя (для maintainer) — предупреждения lock/plan и compose preview используют более чёткие границы host/manifest; контрактные тесты защищают от регрессий.
О версиях (кратко)
| Вопрос | Ответ |
|---|---|
| Какая версия odpm установлена? | 4.4.3 (odpm --version) |
Нужно ли менять odpm.json в своём проекте? |
Нет, если проект уже работал — odpm_version: "4.0" трогать не обязательно |
Установка
Сверяйте контрольную сумму по файлу SHA256SUMS в этом GitHub Release.
| Платформа | Как установить |
|---|---|
| Debian/Ubuntu | odpm_4.4.3-1_all.deb или APT (suite stable) — stable |
| Fedora 40+ | odpm-4.4.3.fc*.noarch.rpm или YUM (stable) — stable |
| pip | pip install odpm (production PyPI) |
sudo apt install ./odpm_4.4.3-1_all.deb
sudo dnf install ./odpm-4.4.3.fc*.noarch.rpm
pip install 'odpm==4.4.3'
odpm --version
# ожидается: odpm version: 4.4.3Документация
- Установка odpm (stable)
- Локальная разработка с нуля (stable)
- deps.lock и синхронизация manifest (stable)
- CHANGELOG.md
Обратная связь
Если установка или обновление не сработали — создайте issue: укажите, как ставили (deb / rpm / pip), вывод odpm --version и что пошло не так.
4.4.3-beta
4.4.3-beta
English
4.4.3-beta is a pre-release before the final 4.4.3 stable. For production, stay on 4.4.2 (APT/YUM stable, regular PyPI). This beta is available only in testing repos and on TestPyPI.
We ship beta so that before final 4.4.3 we can verify:
- installing from
.deband.rpmattached to this GitHub Release; - adding APT/YUM
testingand upgrading from 4.4.2; - installing via pip from the test PyPI index;
- that
odpm --versionreports 4.4.3-beta, and thatodpm plan/odpm --update-lockwork, including the new--sync-manifest-locksflag.
Installing beta on a test machine helps catch issues before the final release.
What's new in this release
-
Clearer
odpm planwarnings — plan checks and compose preview rely only on your project settings inodpm.jsonand lock files, not on odpm’s internal configuration; fewer misleading warnings when you have not changed the project. -
Optional sync of git pins into
odpm.json— afterodpm --update-lock, add--sync-manifest-locks(developer scenario) to copy collected pins from.odpm/deps.lock.jsoninto thelocks.gitsection ofodpm.json. Without the flag,odpm planreminds you that the manifest file was not updated. -
Easier to see where git dependency pins come from — when the environment is prepared, the log states whether pins are taken from
locks.gitinodpm.jsonor from.odpm/deps.lock.json; warnings about drift between those sources are available in your UI language.
Versions (short)
| Question | Answer for beta |
|---|---|
| Which odpm version is installed? | 4.4.3-beta (odpm --version) |
| Recommended production version? | 4.4.2 (stable) |
Must I change odpm.json in my project? |
No — if the project already worked, you do not need to touch it |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.4.3~beta-1_all.deb or add the APT repo (testing suite) — beta guide · stable 4.4.2 |
| Fedora 40+ | download odpm-4.4.3-beta.fc*.noarch.rpm or add the YUM repo (testing) — beta guide · stable 4.4.2 |
| pip | test PyPI index only (command below) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.4.3~beta-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.4.3-beta.fc*.noarch.rpm
# pip — test index (beta)
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.4.3-beta'
odpm --version
# expected: odpm version: 4.4.3-betaDocumentation
- Installing odpm (stable 4.4.2) — recommended for production
- Installing odpm (4.4.3-beta) — matches this pre-release
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.4.3-beta — предварительная (beta) версия перед финальным выпуском 4.4.3. Для production оставайтесь на 4.4.2 (APT/YUM stable, обычный PyPI). Beta доступна только в репозиториях testing и на тестовом каталоге PyPI.
Мы выпускаем beta, чтобы перед финальным 4.4.3 проверить следующее:
- установку из
.debи.rpmиз этого GitHub Release; - подключение APT/YUM
testingи обновление с 4.4.2; - установку через pip из тестового каталога PyPI;
- вывод
odpm --version(4.4.3-beta) и работуodpm plan/odpm --update-lock, в том числе с новым флагом--sync-manifest-locks.
Если вы поставите beta на тестовую машину — это поможет поймать проблемы до финального релиза.
Что нового в этой версии
-
Понятнее предупреждения в
odpm plan— проверка плана и превью compose опираются только на настройки вашего проекта вodpm.jsonи lock-файлах, а не на внутреннюю конфигурацию odpm; меньше ложных сигналов, если вы сами проект не меняли. -
Синхронизация git-блокировок в
odpm.json— по желанию — послеodpm --update-lockможно добавить флаг--sync-manifest-locks(сценарий developer): тогда разделlocks.gitвodpm.jsonобновится из собранного.odpm/deps.lock.json. Без флагаodpm planнапомнит, что файл manifest не менялся. -
Видно, откуда берутся версии git-зависимостей — при подготовке окружения в лог пишется, используются ли пины из
locks.gitвodpm.jsonили из.odpm/deps.lock.json; предупреждения о расхождении между этими источниками выводятся на языке интерфейса.
О версиях (кратко)
| Вопрос | Ответ для beta |
|---|---|
| Какая версия odpm установлена? | 4.4.3-beta (odpm --version) |
| Рекомендуемая версия для production? | 4.4.2 (stable) |
Нужно ли менять odpm.json в своём проекте? |
Нет, если проект уже работал — файл трогать не обязательно |
Установка
Сверяйте контрольную сумму по файлу SHA256SUMS в этом GitHub Release.
| Платформа | Как установить |
|---|---|
| Debian/Ubuntu | скачать odpm_4.4.3~beta-1_all.deb или подключить APT (suite testing) — beta · stable 4.4.2 |
| Fedora 40+ | скачать odpm-4.4.3-beta.fc*.noarch.rpm или подключить YUM (testing) — beta · stable 4.4.2 |
| pip | только тестовый каталог PyPI (см. команду ниже) |
# Debian/Ubuntu — из скачанного файла
sudo apt install ./odpm_4.4.3~beta-1_all.deb
# Fedora — из скачанного файла (под вашу версию fc*)
sudo dnf install ./odpm-4.4.3-beta.fc*.noarch.rpm
# pip — тестовый каталог (для beta)
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.4.3-beta'
odpm --version
# ожидается: odpm version: 4.4.3-betaДокументация
- Установка odpm (stable 4.4.2) — рекомендуется для production
- Установка odpm (4.4.3-beta) — соответствует этому pre-release
- Подробный список изменений для разработчиков: CHANGELOG.md
Обратная связь
Если установка или обновление не сработали — создайте issue: укажите, как ставили (deb / rpm / pip), вывод odpm --version и что пошло не так.
4.4.2
4.4.2
English
4.4.2 is the first stable release of the 4.4 line on 4.4-dev. It supersedes 4.3.0 as the recommended production version. Pre-release 4.4.2-beta tested packaging and docs channels; stable uses APT/YUM suite stable, production PyPI, and docs alias stable.
What's new in this release
-
One version number for every install method — 4.4.2 in apt/dnf, pip, and
odpm --version; no mismatched digits across channels. -
pip install odpmon PyPI — stable tags publish to pypi.org; pre-releases stay on TestPyPI. -
Validate project settings before startup —
odpm manifest validatefinds errors inodpm.jsonearly, without a full Docker environment bring-up. -
Lock file vs manifest drift — visible before startup — when commits in
locks.git(odpm.json) and.odpm/deps.lock.jsondiffer,odpm planprints a warning in the terminal (Warningsblock); during environment prepare the same message goes to the log. Execution is not blocked: canonical source islocks.git; runodpm --update-lockto sync the on-disk file. -
Upgrade to the extended settings format — optional — existing projects with the familiar
odpm.jsonkeep working; migrate withodpm manifest migratewhen needed (run without--writefirst to review the diff). -
Extra docker-compose services from project settings — e.g. Mailpit test mail for Odoo email debugging; configured in
odpm.jsonwithout hand-editing compose files. -
Documentation in Russian and English with versioned site — stable docs for production; archived 4.3 and beta docs remain in the version selector.
-
Secrets for CI image builds — bake secrets into the image when building for continuous integration (
ODPM_BAKE_SECRETS=1) if the runner cannot mount password files.
Versions (short)
| Question | Answer |
|---|---|
| Which odpm version is installed? | 4.4.2 (odpm --version) |
Must I change odpm.json in my project? |
No — if the project already worked, you do not need to touch odpm_version: "4.0" |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.4.2-1_all.deb or add the APT repo (stable suite) — stable guide |
| Fedora 40+ | download odpm-4.4.2.fc*.noarch.rpm or add the YUM repo (stable) — stable guide |
| pip | pip install odpm (production PyPI) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.4.2-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.4.2.fc*.noarch.rpm
# pip — production
pip install 'odpm==4.4.2'
odpm --version
# expected: odpm version: 4.4.2Documentation
- Installing odpm (stable) — recommended for production
- Local dev from scratch (stable) — demo project odoo_demo_project (Odoo 19.0)
- Extensions and extra services (stable)
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.4.2 — первый stable-релиз линии 4.4 на 4.4-dev. Заменяет 4.3.0 как рекомендуемую production-версию. Pre-release 4.4.2-beta проверил каналы packaging и docs; stable использует APT/YUM suite stable, production PyPI и alias docs stable.
Что нового в этой версии
-
Один номер версии для всех способов установки — 4.4.2 в apt/dnf, pip и
odpm --version; расхождений между каналами нет. -
pip install odpmна PyPI — stable-теги публикуются на pypi.org; pre-release остаются на TestPyPI. -
Проверка настроек проекта до запуска —
odpm manifest validateнаходит ошибки вodpm.jsonзаранее, без полного поднятия Docker. -
Расхождения lock-файла и manifest — видны до запуска — при несовпадении
locks.gitи.odpm/deps.lock.jsonodpm planвыводит предупреждение; при prepare то же в логе. Канон —locks.git; выровнять файл —odpm --update-lock. -
Переход на расширенный формат настроек — по желанию — старые проекты с
odpm.jsonработают как раньше;odpm manifest migrate(сначала без--write). -
Дополнительные сервисы docker-compose из
odpm.json— например Mailpit для отладки почты Odoo. -
Документация RU/EN с версионированием на сайте — stable для production; архив 4.3 и beta в переключателе версий.
-
Секреты для CI-сборки образа —
ODPM_BAKE_SECRETS=1, если runner не монтирует файлы с паролями.
О версиях (кратко)
| Вопрос | Ответ |
|---|---|
| Какая версия odpm установлена? | 4.4.2 (odpm --version) |
Нужно ли менять odpm.json? |
Нет, если проект уже работал — odpm_version: "4.0" трогать не обязательно |
Установка
Сверяйте контрольную сумму по SHA256SUMS в этом GitHub Release.
| Платформа | Как установить |
|---|---|
| Debian/Ubuntu | odpm_4.4.2-1_all.deb или APT (suite stable) — stable |
| Fedora 40+ | odpm-4.4.2.fc*.noarch.rpm или YUM (stable) — stable |
| pip | pip install odpm (production PyPI) |
sudo apt install ./odpm_4.4.2-1_all.deb
sudo dnf install ./odpm-4.4.2.fc*.noarch.rpm
pip install 'odpm==4.4.2'
odpm --version
# ожидается: odpm version: 4.4.2Документация
- Установка odpm (stable)
- Локальная разработка с нуля (stable)
- Расширения и дополнительные сервисы (stable)
- CHANGELOG.md
Обратная связь
Если установка не сработала — issue: способ установки, odpm --version, описание проблемы.
4.4.2-beta
4.4.2-beta
English
4.4.2-beta is a pre-release before the final 4.4.2 stable. The feature set matches what we plan for stable; only the “beta” label in the version number and install channels differ (see below).
We ship beta to verify that packages build, install, and upgrade without surprises. Installing beta on a test machine helps catch issues before the final release.
What's new in this release
-
One version number for every install method — 4.4.2-beta is used (final release: 4.4.2) in apt/dnf, pip, and
odpm --version; no more mismatched digits across channels. -
pip install is back in the release process — for beta the package goes to TestPyPI; after final 4.4.2 — regular
pip install odpmon pypi.org. -
Validate project settings before startup —
odpm manifest validatefinds errors inodpm.jsonearly, without a full Docker environment bring-up. -
Lock file vs manifest drift — visible before startup — when commits in
locks.git(odpm.json) and.odpm/deps.lock.jsondiffer,odpm planprints a warning in the terminal (Warningsblock); during environment prepare the same message goes to the log. Execution is not blocked: canonical source islocks.git; runodpm --update-lockto sync the on-disk file. -
Upgrade to the extended settings format — optional — existing projects with the familiar
odpm.jsonkeep working; migrate withodpm manifest migratewhen needed (run without--writefirst to review the diff). -
Extra docker-compose services from project settings — e.g. Mailpit test mail for Odoo email debugging; configured in
odpm.jsonwithout hand-editing compose files. -
Documentation in Russian and English with the same structure — easier to find install, first run, and IDE debugging sections.
-
Secrets for CI image builds — bake secrets into the image when building for continuous integration (
ODPM_BAKE_SECRETS=1) if the runner cannot mount password files.
Versions (short)
| Question | Answer for beta |
|---|---|
| Which odpm version is installed? | 4.4.2-beta (odpm --version) |
Must I change odpm.json in my project? |
No — if the project already worked, you do not need to touch odpm_version: "4.0" |
Install
Verify checksums using SHA256SUMS from this GitHub Release.
| Platform | How to install |
|---|---|
| Debian/Ubuntu | download odpm_4.4.2~beta-1_all.deb or add the APT repo (testing suite) — beta guide · stable 4.3.0 |
| Fedora 40+ | download odpm-4.4.2-beta.fc*.noarch.rpm or add the YUM repo (testing) — beta guide · stable 4.3.0 |
| pip | TestPyPI only (command below) |
# Debian/Ubuntu — from downloaded file
sudo apt install ./odpm_4.4.2~beta-1_all.deb
# Fedora — from downloaded file (match your fc* version)
sudo dnf install ./odpm-4.4.2-beta.fc*.noarch.rpm
# pip — test index (beta)
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.4.2-beta'
odpm --version
# expected: odpm version: 4.4.2-betaDocumentation
- Installing odpm (stable 4.3.0) — recommended for production
- Installing odpm (4.4.2-beta) — matches this pre-release
- Local dev from scratch (4.4.2-beta) — demo project odoo_demo_project (Odoo 19.0)
- Extensions and extra services (4.4.2-beta)
- Full changelog for developers: CHANGELOG.md
Feedback
If install or upgrade failed — open an issue: say how you installed (deb / rpm / pip), paste odpm --version output, and what went wrong.
Русский
4.4.2-beta — предварительная (beta) версия перед финальным выпуском 4.4.2. Состав функций тот же, что планируется в stable; отличается только пометка «beta» в номере версии и каналах установки (см. ниже).
Мы выпускаем beta, чтобы проверить: пакеты собираются, устанавливаются и обновляются без сюрпризов. Если вы поставите beta на тестовую машину — это поможет поймать проблемы до финального релиза.
Что нового в этой версии
-
Один номер версии для всех способов установки — используется 4.4.2-beta (в финальном релизе — 4.4.2) и в apt/dnf, и в pip, и в выводе
odpm --version; расхождений между каналами больше нет. -
Установка через pip снова встроена в процесс релиза — для beta пакет попадает на тестовый каталог PyPI; после финального 4.4.2 — в обычный
pip install odpmна pypi.org. -
Проверка настроек проекта до запуска — команда
odpm manifest validateнаходит ошибки в файлеodpm.jsonзаранее, без полного поднятия окружения Docker. -
Расхождения между lock-файлом и manifest — видны до запуска — если коммиты в
locks.git(odpm.json) и в.odpm/deps.lock.jsonне совпадают,odpm planвыводит предупреждение в терминале (блокWarnings); при подготовке окружения то же попадает в лог. Работа не прерывается: канон —locks.git; чтобы выровнять файл на диске —odpm --update-lock. -
Переход на расширенный формат настроек — по желанию — старые проекты с привычным
odpm.jsonработают как раньше; при необходимости можно аккуратно перевести файл командойodpm manifest migrate(сначала без--write, посмотреть diff). -
Дополнительные сервисы в docker-compose из настроек проекта — например, тестовая почта Mailpit для отладки писем Odoo; подключается через описание в
odpm.json, без ручной правки compose-файлов. -
Документация на русском и английском с одинаковой структурой — проще найти раздел про установку, первый запуск и отладку в IDE.
-
Секреты для CI-сборки образа — при сборке образа для непрерывной интеграции можно «запечь» секреты в образ (переменная
ODPM_BAKE_SECRETS=1), если на runner нельзя монтировать файлы с паролями.
О версиях (кратко)
| Вопрос | Ответ для beta |
|---|---|
| Какая версия odpm установлена? | 4.4.2-beta (odpm --version) |
Нужно ли менять odpm.json в своём проекте? |
Нет, если проект уже работал — поле odpm_version: "4.0" трогать не обязательно |
Установка
Сверяйте контрольную сумму по файлу SHA256SUMS в этом GitHub Release.
| Платформа | Как установить |
|---|---|
| Debian/Ubuntu | скачать odpm_4.4.2~beta-1_all.deb или подключить APT (suite testing) — beta · stable 4.3.0 |
| Fedora 40+ | скачать odpm-4.4.2-beta.fc*.noarch.rpm или подключить YUM (testing) — beta · stable 4.3.0 |
| pip | только тестовый PyPI (см. команду ниже) |
# Debian/Ubuntu — из скачанного файла
sudo apt install ./odpm_4.4.2~beta-1_all.deb
# Fedora — из скачанного файла (под вашу версию fc*)
sudo dnf install ./odpm-4.4.2-beta.fc*.noarch.rpm
# pip — тестовый каталог (для beta)
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ \
'odpm==4.4.2-beta'
odpm --version
# ожидается: odpm version: 4.4.2-betaДокументация
- Установка odpm (stable 4.3.0) — рекомендуется для production
- Установка odpm (4.4.2-beta) — соответствует этому pre-release
- Локальная разработка с нуля (4.4.2-beta) — демо-проект odoo_demo_project (Odoo 19.0)
- Расширения и дополнительные сервисы (4.4.2-beta)
- Подробный список изменений для разработчиков: CHANGELOG.md
Обратная связь
Если установка или обновление не сработали — создайте issue: укажите, как ставили (deb / rpm / pip), вывод odpm --version и что пошло не так.
4.3.0
4.3.0
English
Stable release of the 4.3 product line (promoted from 4.3-rc1).
Highlights
- Faster Odoo platform cloning — shallow clone by branch, commit, or limited depth (saves up to ~40 minutes on large histories). See Git repository links and
deps.lock.json. uvon Debian 12+ in container images instead of plainpip— much faster package installs (up to ~10×). See developer scenario.- Configurable Odoo platform source — custom git URL when not set defaults to official Odoo GitHub. See Custom Odoo platform repo and
odoo_git_linkin odpm.json. - Dry-run (
odpm plan) — preview what will change before a full run. See Command-line options. - Multiple debugger backends — VS Code / Cursor and PyCharm (Attach to DAP and Debug Server). See IDE debugging.
${VAR}substitution in manifest — environment variables in settings (especially useful forfile://paths). See odpm.json,.envvariables, Git links.- Secrets inside the container — mount JSON secrets for Odoo modules. See Local secrets.
- CI image build and
ciscenario — baked runtime image alongsidedeveloperandserver. See ci scenario. - Database state v1 —
.odpm/database/last_run.jsonfingerprints PostgreSQL configuration, drift detection,odpm database status/ensure-role, legacy adoption baseline. See Database state. - Full user documentation (MkDocs, RU + EN). See Documentation hub.
- Binary packages —
.deband.rpmon GitHub Releases; APT/YUM repos for upgrades. See Installing odpm.
Since 4.3-rc1
- Database state v1 with drift resolution and legacy PostgreSQL adoption.
- Fix
--db-dropwhen the Odoo database owner differs from the application role.
Version note: release 4.3.0; the odpm.json manifest format (odpm_version) and odpm --version remain on the 4.0 compatibility line.
Install
| Platform | Package |
|---|---|
| Debian/Ubuntu | odpm_4.3.0-1_all.deb |
| Fedora 41+ | odpm-4.3.0-1.fc41.noarch.rpm (or odpm-4.3.0-1.*.noarch.rpm on your distro) |
Verify checksums with SHA256SUMS from this release.
# Debian/Ubuntu
sudo apt install ./odpm_4.3.0-1_all.deb
# Fedora
sudo dnf install ./odpm-4.3.0-1*.noarch.rpmDocumentation
- Installing odpm (all platforms)
- This release: Debian / Ubuntu (.deb) · Fedora / RHEL (.rpm)
- Documentation hub (EN) · Local dev from scratch
- Archived 4.3 line: 4.3.0 docs
- Full changelog: CHANGELOG.md
Русский
Стабильный релиз линии 4.3 (после 4.3-rc1).
Основные новшества
- Ускорено клонирование платформы Odoo — shallow clone по ветке, коммиту или ограниченной глубине (экономия до ~40 минут).
uvна Debian 12+ в образах контейнера вместоpip— до ~10× быстрее установка пакетов. См. сценарий developer.- Настраиваемый источник платформы Odoo — свой git URL; по умолчанию официальный GitHub Odoo. См. Свой репозиторий платформы.
- Dry-run (
odpm plan) — предпросмотр изменений до полного запуска. См. CLI. - Несколько backend'ов отладчика — VS Code и PyCharm. См. Отладка в IDE.
- Подстановка
${VAR}в manifest — переменные окружения в настройках. См. odpm.json. - Секреты внутри контейнера — JSON-секреты для модулей Odoo. См. Локальные секреты.
- Сборка CI-образа и сценарий
ci. См. сценарий ci. - Database state v1 — снимок конфигурации PostgreSQL, drift,
odpm database status/ensure-role, adoption для legacy-кластеров. См. Database state. - Полная документация (MkDocs, RU + EN). См. Документация.
- Бинарные пакеты —
.debи.rpmна GitHub Releases; APT/YUM-репозитории. См. Установка odpm.
С 4.3-rc1
- Database state v1 с разрешением drift и adoption legacy PostgreSQL.
- Исправлен
--db-drop, когда владелец БД Odoo отличается от роли приложения.
Релиз 4.3.0; формат odpm.json (odpm_version) и odpm --version остаются на линии 4.0.
Установка
| Платформа | Пакет |
|---|---|
| Debian/Ubuntu | odpm_4.3.0-1_all.deb |
| Fedora 41+ | odpm-4.3.0-1.fc41.noarch.rpm |
Сверяйте checksum по SHA256SUMS из этого релиза.
# Debian/Ubuntu
sudo apt install ./odpm_4.3.0-1_all.deb
# Fedora
sudo dnf install ./odpm-4.3.0-1*.noarch.rpmДокументация
- Установка odpm (все платформы)
- Этот релиз: Debian / Ubuntu (.deb) · Fedora / RHEL (.rpm)
- Документация (RU) · Локальная разработка с нуля
- Архив линии 4.3: docs 4.3.0
- Полный список изменений: CHANGELOG-RU.MD