Migrate OCA module to XX.0¶

The OCA has a migration guide for every major version.

This document show how to a module migration happens with the help of Odoo Build.

Prepare¶

Set env vars.

source_version=18.0
target_version=19.0
repo=account-analytic
module=product_analytic
user_org=Mint-System

Migrate¶

Prepare the migration branch for the module.

task prepare-migration-brach "$repo" "$module" "$source_version"

Migrate the module.

task migrate-module "$repo/$module"

Follow migration guide to update the module:

Start the Odoo environment and install the module.

task init-module "oca/$repo/$module"

Run the module tests.

task test-module "oca/$repo/$module"

Commit the migration.

task run-pre-commit "oca/$repo"
task status-git-folder "oca/$repo"
task stage-git-folder "oca/$repo"
task commit-git-folder "oca/$repo" "[MIG] $module: Migration to $target_version"

Submit¶

Push to remote.

git push "${user_org:l}"

Create a pull request

gh repo set-default origin
gh pr create \
  --repo "OCA/${repo}" \
  --head "${user_org}:${target_version}-mig-${module}" \
  --base "${target_version}" \
  --title "[${target_version}][MIG] ${module}: Migration to ${target_version}" \
  --body "Standard migration from ${source_version} to ${target_version}." \
  --web

Once submitted check the runboat checks.

Backlinks

🔗 Prozesse Odoo - Migration OCA Module

📝 Edit on GitHub · 🔷 Open in Obsidian