CI Status ===
[](https://pypi.python.org/pypi/deployv) [](https://git.vauxoo.com/vauxoo/deployv/commits/master) [](https://coverage.vauxoo.com/master-master/) [](https://git.vauxoo.com/deployv/orchest/wikis/home)
DeployV ===
The main DeployV goal is to have a set of tools for working with dockerized Odoo instances as a library or command line interface using a simple json formatted config files.
It is planned that in further versions will be an [Odoo](https://www.odoo.com) integration so the whole configuration process can be done directly in the instance and deployed to the corresponding server (this would be configurable too) using [RabbitMQ](https://www.rabbitmq.com/) for messaging. This graphical interface development is done in the [Orchest](https://github.com/Vauxoo/orchest) repository.
Getting started ===
## Installing
Before installing the library you will need to have the following installed:
build-essential
python-setuptools
python-dev
libpq-dev
libffi-dev
This can be performed executing the following:
$ sudo apt-get update $ sudo apt-get install build-essential python-setuptools python-dev libpq-dev libffi-dev
All Python dependencies are listed in the requirements.txt and will be installed when you run:
$ python setup.py install
Notice that you must have docker and PostgreSQL installed on your system, if not you can install docker following the [official documentation](https://docs.docker.com/installation/ubuntulinux) and you can use the a PostgreSQL container ([vauxoo/docker-postgresql](https://hub.docker.com/r/vauxoo/docker-postgresql/)), run it:
$ docker run -d -p 127.0.0.1:5136:5432 -p 172.17.42.1:5136:5432 –name odoo_psql vauxoo/docker-postgresql:latest /entry_point start
The port 5136 is used to avoid conflict with any postgres running instance. It is attached to the docker interface and the [loopback](http://www.tldp.org/LDP/nag/node66.html) so it is accessible from the container and the host only, the –name parameter is optional and can be changed to your needs. To see a detailed description of the parameters go to [docker cli documentation page](https://docs.docker.com/reference/commandline/cli/).
Note: This have been tested with docker 1.7.1 only
## Testing the installation
In the test folder you can find a sample configuration file names config.json this file uses a [docker test image](https://hub.docker.com/r/vauxoo/odoo80-test/) that have some public repositories and Odoo 8.0.
Run the create command:
$ deployvcmd create -f /path/to/tests/config.json -l DEBUG -z /any/path
Notice that the backup must start with customer_id if you specify a directory, if you specify a specific file only then the name format does not matter.
## Basic commands
The image for the instance can be created by:
$ deployvcmd build -u git@github.com:user/app_repo.git -v 8.0
And it will create a docker image using Odoo 8.0 and will install all dependencies from the requirements.txt and oca_dependencies.txt, if you wish to build from a development branch just do:
$ deployvcmd build -u git@github.com:user-dev/app_repo.git -b my_dev_branch -v 8.0
As you can see in the test section you can easily create an Odoo instance using the command line, but also generate a backup from it:
$ deployvcmd backupdb -f /path/to/tests/config.json -z ./backup/path -d database_name_to_backup
Or you can create a backup from an instance in a container:
$ deployvcmd backupdb -n container_name -z ./backup/path -d database_name_to_backup
I will generate a compressed file in ./backup/path with a database dump, attachments and a json file with the instance branches info.
To restore the generated dump just have to execute:
$ deployvcmd restore -f /path/to/tests/config.json -z ./backup/path
Also, if you want to restore it to a dockerized instance:
$ deployvcmd restore -n container_name -z ./backup/path
This will search the best best backup to restore or if you wish to specify one:
$ deployvcmd restore -f /path/to/tests/config.json -z ./backup/path/backup_file.tar.bz2
The database name is generated automatically, but you can change this behaviour too:
$ deployvcmd restore -f /path/to/tests/config.json -z ./backup/path/backup_file.tar.bz2 -d specific_database_name
### Anonymize data This functionality is based on [Postgresql Anonymizer Extension](https://postgresql-anonymizer.readthedocs.io/en/stable/). The extension must be installed in host/container where database is located, by executing (as root user):
# apt install pgxnclient build-essential postgresql-server-dev-kk # pgxn install postgresql_anonymizer
where kk its postgresql version (according to host/container), like: 9.6, 10, 11, etc,
Also, odoo user (in database) must have superuser privilege (in order to create and activate extension, create schema and functions):
ALTER USER odoo WITH SUPERUSER;
In deactivate step, anonymization of data could be executed. For that, create a file /etc/deployv/deactivate/anon_operations.csv as indicated by internal documentation.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file deployv-0.9.226.tar.gz.
File metadata
- Download URL: deployv-0.9.226.tar.gz
- Upload date:
- Size: 124.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
09468bed870fc601ef4dbba64e877addd765db6f1c7145ad8c9ebe378f455064
|
|
| MD5 |
d80738de389e9b666b8c3e7e1428d942
|
|
| BLAKE2b-256 |
be2c14885badba009931de3f6338eaa6ac9fc25789b55966c4e50132c2695d0f
|
File details
Details for the file deployv-0.9.226-py3-none-any.whl.
File metadata
- Download URL: deployv-0.9.226-py3-none-any.whl
- Upload date:
- Size: 135.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23a5da71f46e9dadafa58a7388665b3b22842eafbe7661a4e208270746b846e9
|
|
| MD5 |
345aeefa9132267c1f8028d4f3984160
|
|
| BLAKE2b-256 |
a6c5ed75ad38e26b1ba2e49487cb310888514ccb8dd44f7e76cecdefb56567c5
|
](https://pypi.python.org/pypi/deployv){kind=link}
](https://git.vauxoo.com/vauxoo/deployv/commits/master){kind=link}
](https://coverage.vauxoo.com/master-master/){kind=link}
](https://git.vauxoo.com/deployv/orchest/wikis/home){kind=link}