Skip to main content

Manage Odoo instances with relevant information

Project description

Beta License: AGPL-3 coopdevs/odoo-addons

This Odoo module provides a comprehensive solution for managing project instances, their deployment schedules, and associated components such as processes, modules, troubleshooting documentation, project roles, server information, and commercial data. All instances, processes, and modules are classified by the Odoo version.

Features

  • Create and manage project instances, classified by Odoo version, and organize them by stages.

  • Schedule and manage deployment events for project instances, including the start time, duration, and description, with automatic calculation of the next available deployment window and a wizard to create calendar events.

  • Manage processes, associate them with project instances, and track related modules, all classified by Odoo version.

  • Manage odoo modules, including their name, Odoo and own version, and associate them with processes.

  • Get installed modules and their versions from a requirements file.

  • Import real runtime payloads from URL or pasted JSON and process them asynchronously.

  • Track synchronization runs with status, timestamps, errors, and payload/summary snapshots.

  • Compare expected Git databases vs real server databases and surface drift warnings.

  • Analyze module/package inconsistencies (DB vs package, DB vs PyPI, missing package/module, pyenv vs requirements).

  • Bootstrap new instances from selected processes using the dedicated bootstrap wizard.

  • Auto-apply deduplicated process modules and keep highest detected module versions on the instance.

  • Generate and download deployment artifacts (requirements.txt and modules.yaml) from instance modules.

  • Troubleshooting tab for storing helpful documentation, such as postmortems, specific configurations, and more.

  • Assign users to different project roles within each project instance.

  • Display server information for each project instance.

  • Manage commercial data related to project instances.

Usage

  • For Real Payload Sync to work, install and run the server-side payload generator on each managed server:

    https://git.coopdevs.org/coopdevs/sysadmin/monitoring/odoo-instance-api

    This service produces the JSON payload consumed by this module.

  • To allow a user to access this module, we must activate the permission. To do that, go to Settings - Users and Companies - Users, and select your user. Activate the checkbox “Odoo Instance User” and save changes.

Publishing Release Candidates to PyPI

Odoo’s manifest validator strictly requires the "version" key to be purely numeric (e.g., 18.0.1.0.0). Because of this, do not add the rc suffix directly to your __manifest__.py.

Instead, leave the manifest clean and use the ODOO_PYPI_VERSION environment variable to safely inject the rc suffix during the build process.

1. Build the package

Run the build command while passing your target release candidate version:

  • Linux / macOS:

    ODOO_PYPI_VERSION="18.0.1.0.0rc1" <command-to-build-the-package>

2. Upload to PyPI

Once built, upload the specific release candidate files using twine:

python -m twine upload dist/*rc*

Table of contents

Changelog

18.0.1.0.0rc1 (2026-05-18)

Features

  • Migration to Odoo 18.

  • Add Odoo 18 core modules app data (data/odoo18_core_modules_app_data.xml).

  • Add script (generate_modules_data.py) to generate XML for Odoo core modules directly from manifests.

  • Add Catalan and Spanish (ca / es) translation files and a full translation template (i18n/odoo_instance.pot).

  • Add process bootstrap wizard with state management, completion tracking, and HTML previews for generated requirements.txt and modules.yaml deployment artifacts.

  • Auto-apply process modules on created instances with technical-name deduplication and highest-version selection.

  • Add helpdesk_mgmt and mail to module dependencies.

Bugfixes

  • Use Markup for message_body in message_post calls (Odoo 18 requirement).

  • Fix kanban view to use t-out instead of deprecated t-esc.

  • Remove password attribute from auth fields (security hardening).

  • Fix button visibility for artifact generation actions based on instance state.

  • Improve search in OdooInstanceModuleVersion and add active instance check in RealPayloadImportWizard.

Refactoring / Tooling

  • Replace flake8 with ruff linter in pre-commit configuration.

  • Add deduplication test suite for shared modules across processes.

  • Add accessibility role attributes to alert div elements.

16.0.3.0.0 (2026-03-25)

Features

  • Add a process bootstrap wizard to create instances directly from selected functional processes.

  • Auto-apply process modules on created instances with technical-name deduplication and highest-version selection.

  • Add generated deployment artifacts for bootstrapped instances (requirements.txt and modules.yaml) with metadata and downloadable files.

  • Add dedicated menu/action access for the bootstrap flow and include the wizard view in module data.

16.0.2.0.0 (2026-03-25)

Features

  • Add real server payload synchronization (manual JSON or URL) with asynchronous processing.

  • Add sync run tracking model (odoo.instance.sync.run) with payload/summary snapshots and cleanup cron.

  • Add server-focused monitoring fields on instances: sync status, duration, runtime python version, drift counters.

  • Add module issue analysis model (odoo.instance.module.issue) and dedicated views for update/drift categories.

  • Add database source split (git vs server) plus comparison model to highlight name drift.

  • Add new Odoo version seeds (17.0, 18.0, 19.0, 20.0) in version data.

  • Add Odoo 16 core modules app data file (data/odoo16_core_modules_app_data.xml).

16.0.1.0.0 (2024-07-11)

Features

  • Migration to Odoo 16

14.0.1.2.1 (2023-08-04)

Features

  • Add cron to update instances info

14.0.1.2.0 (2023-08-04)

Features

  • Add functional configurations section to store UI-managed configurations

Misc

  • Move ‘Deploy window’ configuration to ‘Misc’ tab

14.0.1.2.0 (2023-04-26)

Features

  • Manage databases

14.0.1.1.1 (2023-04-25)

Bugfixes

  • Upcrate module versions

  • Show installed module versions only in instance view

14.0.1.1.0 (2023-04-25)

Features

  • Handle odoo releases

14.0.1.0.1 (2023-04-25)

Features

  • Improved UX: Searches, filters, grouping…

Bugfixes

  • Removed forgotten debug statementes

14.0.1.0.0 (2023-04-24)

Features

  • Rename models and split logic in files

14.0.0.2.0 (2023-04-24)

Features

  • Add instance relations to project and res.partner

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Coopdevs

Maintainers

This module is part of the coopdevs/odoo_instance project.

You are welcome to contribute.

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

odoo_addon_odoo_instance-18.0.1.0.0rc3.tar.gz (157.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

odoo_addon_odoo_instance-18.0.1.0.0rc3-py3-none-any.whl (185.8 kB view details)

Uploaded Python 3

File details

Details for the file odoo_addon_odoo_instance-18.0.1.0.0rc3.tar.gz.

File metadata

File hashes

Hashes for odoo_addon_odoo_instance-18.0.1.0.0rc3.tar.gz
Algorithm Hash digest
SHA256 2190f078b3f928714749b318e748a16db2e84a588ee8b8dd9154c03b827187aa
MD5 6ff33e62349531adaad951134d916d89
BLAKE2b-256 03f05f7f4504d16b42dea742d34b24ca3bdbdce8b22d6e84f06f63367b88003e

See more details on using hashes here.

File details

Details for the file odoo_addon_odoo_instance-18.0.1.0.0rc3-py3-none-any.whl.

File metadata

File hashes

Hashes for odoo_addon_odoo_instance-18.0.1.0.0rc3-py3-none-any.whl
Algorithm Hash digest
SHA256 aa70e816b55f481611993c0b2ba68f811a08e2bf44563e3a3493ffe9d3fbc025
MD5 2c65896713c8babfde8cf7d3caaf54a4
BLAKE2b-256 985ff25e0bfae41a001f095197b259d07f548ba298038ba8f2e9d090e20fc77d

See more details on using hashes here.

Supported by

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