Skip to main content

dodoo migrator script

Project description

License: LGPL-3

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.


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.

  -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
  --help                         Show this message and exit.





This project is maintained by XOE Corp. SAS.


Future (?)

  • More tests

  • Metrics endpoint (to scrape progress/status)

0.6.7 (2019-05-31)

  • Talk to odoo upgrade service

0.6.5 (2019-05-05)

  • Simplify repo structure

  • Fix package namespace issues

0.6.3 (2019-05-04)

  • Add pre & post scripts

  • Fix mig namespaced odoo module

0.6.2 (2019-04-15)

  • Fix pyyaml verion incompatibilities

0.6.1 (2019-04-11)

  • Fix migration folder overlay & add tests

0.6.0 (2019-01-24)

  • Refactor to dodoo plugin

0.5.2 (2018-12-05)

  • Add addons-path option

0.5.1 (2018-11-04)

  • Dummy release (pypi)

0.5.0 (2018-11-04)

  • First dodoo release

0.0.1 (2018-10-23)

  • First port of marabunta

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dodoo-migrator-0.6.7.tar.gz (76.8 kB view hashes)

Uploaded source

Built Distribution

dodoo_migrator-0.6.7-py2.py3-none-any.whl (62.8 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page