dodoo-migrator is a set of useful Odoo maintenance functions.
They are available as CLI scripts (based on dodoo), as well
as composable python functions.
Contents
Usage: dodoo-migrator [OPTIONS]
Apply migration paths specified by a descriptive yaml migration file.
Persists applied migrations within the target database.
Connects to Odoo SA's migration service and can be run idempotently to
check for results. Before uploading, can apply special before-steps. Once
results are avialable, proceeds with remaining migration steps as
specified by the migration file.
A prometheus metrics endpoint is instrumented into the script. This can be
scraped by a monitoring solution or a status page.
Options:
-f, --file FILENAME The yaml file containing the migration steps.
[default: .migrations.yaml]
-m, --mig-directory DIRECTORY A migration directory shim. Layout after
Odoo's migrationfolders within their named
module folders.Tipp: Can supply base
migration scripts.
--since PARSE Specify the version (excluded), to start
from. If not specified, start from the latest
applied version onwards.
--until PARSE Specify the the target version, to which to
migrate. If not specified, migrate up to the
latest version.
--metrics / --no-metrics Prometheus metrics endpoint for migration
progress. Can be consumed by a status page or
monitoring solution. [default: False]
--logfile FILE Specify the log file.
-d, --database TEXT Specify the database name. If present, this
parameter takes precedence over the database
provided in the Odoo configuration file.
--log-level TEXT Specify the logging level. Accepted values
depend on the Odoo version, and include
debug, info, warn, error. [default: info]
-c, --config FILE Specify the Odoo configuration file. Other
ways to provide it are with the ODOO_RC or
OPENERP_SERVER environment variables, or
~/.odoorc (Odoo >= 10) or
~/.openerp_serverrc.
--help Show this message and exit.- pypi page: https://pypi.org/project/dodoo-migrator
- code repository: https://github.com/xoe-labs/dodoo-migrator
- report issues at: https://github.com/xoe-labs/dodoo-migrator/issues
Contributors:
- Guewen Baconnier (CAMPTOCAMP)
- Leonardo Pistone (CAMPTOCAMP)
- David Arnold (XOE)
This project is maintained by XOE Corp. SAS.