Skip to content

Latest commit

 

History

History

connector_rancher

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
components
components
 
 
data
data
 
 
models
models
 
 
security
security
 
 
static/description
static/description
 
 
tests
tests
 
 
views
views
 
 
wizards
wizards
 
 
README.rst
README.rst
 
 
__init__.py
__init__.py
 
 
__manifest__.py
__manifest__.py
 
 

README.rst

License: AGPL-3

Rancher Connector

This module allows for you to synchronize Odoo and Rancher.

This is a beta module, and we do not recommend that you use it in production.

Object Import Export Delete
Environment Yes No No
Host Yes No No
Stack Yes Yes Yes
Service Yes No No
Container Yes No No
Catalog Templates Yes No No

Installation

To install this module, you need to:

  1. Install gdapi-python using your preferred Python package management method
  2. Download connector and its dependencies to your Odoo addons path.
  3. Follow queue_job install instructions.
  4. Install this module (connector_rancher).
  5. Deploy a Docker/Rancher secret containing the secret_key that will be used to access Rancher. You can also simply create a file somewhere containing the key.

Configuration

To configure this module, you need to:

  1. Go to Connectors => [Rancher] Backends
  2. Create a new backend. The file path for the secret that was created in the Installation section should go in Secret Path.
  3. Restart Odoo. This is a required step for the asynchronous queue, and can be done at any time after install. If you're missing data and haven't restarted, this is the problem.

Usage

Rancher data can be seen in the Infrastructure application menus.

For the most part, everything is read-only.

Deploy Applications

Rancher is still the recommended way of deploying applications, but it is still possible to deploy them from Odoo as well. The primary purpose for this workflow is to allow for a developer to create stacks based on actions within Odoo.

You can deploy an application stack using Rancher catalog entries by going to the Applications Menu in the Infrastructure app. Find an application you want to deploy, then use the Deploy Application link in the action menu to show the deployment wizard:

Deploy Wizard

Fill the options out as you typically would in Rancher. The Docker and Rancher compose files are also exposed on their respective tabs - should you feel the need to edit those manually.

Click Deploy and your stack will provision in Rancher.

Known Issues

  • Data imports are quite dumb and should be optimized to reduce duplications.
  • Due to above dumbness, data imports aren't happening as often as they should.
  • Selection options should be represented in application deployer, instead of plain text.
  • Once OCA/product-attribute#309 is merged, product_uom_technology should be removed from this repo.
  • Once OCA/server-tools#1098 is merged, infrastructure should be removed from this repo.

Road Map

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 smash it by providing detailed and welcomed feedback.

Credits

Contributors

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

Maintainer

LasLabs Inc.

This module is maintained by LasLabs Inc.