104 lines
No EOL
4.6 KiB
Markdown
104 lines
No EOL
4.6 KiB
Markdown
# LOCAL ENVIRONMENT FOR ODOO DEVELOPERS
|
|
## GUÍA PARA DESARROLLADORES - REV. 30/11/2024
|
|
|
|
### PREPARACIÓN DE AMBIENTE LOCAL PARA DESARROLLADORES
|
|
|
|
#### Instalación del DEVELOPER TOOLS
|
|
|
|
(Pendiente)
|
|
|
|
#### Configuración de Perfil de Desarrollador
|
|
|
|
(Pendiente)
|
|
|
|
#### Crear carpeta para el ambiente de desarrollo
|
|
|
|
Si eres parte del equipo de desarrollo de **MR DEVELOPERS**, se recomienda fuertemente que a nivel de la carpeta **$HOME** crees una carpeta **developers** que será la carpeta raiz de los diferentes proyectos de desarrollo.
|
|
|
|
$ mkdir $HOME/developers
|
|
|
|
Nota: **Si está conectado a algunos de los servidores de desarrollo vía ssh, puede que esta carpeta ya este creada.**
|
|
|
|
#### Instalación de herramientas básicas y de gestión de contenedores
|
|
|
|
Instalará wget, curl, git, python3 + python3-pip (si no están instalados previamente) y podman (si no está previamente instalado o docker)
|
|
|
|
$ bin/bootstrap.sh
|
|
|
|
Nota: Este comando requiere **privilegios de superusuario**, asegurese de tener permisos de **root** o contacte con su administrador. Actualmente, solo para distribuciones Debian. Solo se requiere si no se han instalado pre-requisitos previamente. **Si está conectado a algunos de los servidores de desarrollo vía ssh, este paso no es necesario.**
|
|
|
|
### PREPARACIÓN DE AMBIENTE LOCAL PARA DESARROLLADORES ODOO
|
|
|
|
#### Crear estrucutra para ambiente de desarrollo Odoo
|
|
|
|
Dentro de la carpeta **$HOME/developers**, vas a descargar el proyecto base en la carpeta **odoo**
|
|
|
|
$ cd $HOME/developers
|
|
$ git clone git@git.rosero.one:OPENTECH/odoo.git
|
|
|
|
Nota: Requieres acceso vpn a infraestructura de desarrolladores, estar registrado como desarrollador en la plataforma git (gitea) y credencial ssh para acceso al repositorio para poder descargar el proyecto.
|
|
|
|
#### Instalación y/o Actualización de Odoo Packs
|
|
|
|
Dependiendo del perfil de permisos del desarrollador y del tipo de proyecto, se podrán descargar packs que son conjuntos de módulos odoo que puede ser utilizados para ampliar las funcionalidades de un proyecto odoo:
|
|
|
|
##### Extra Pack
|
|
|
|
El extra pack contiene módulos odoo que pueden ser requeridos por un proyecto para resolver requerimientos muy puntuales. Para instalarlo:
|
|
|
|
$ bin/pack_extras.sh [--help] [--version] [--odoo <n>]
|
|
|
|
##### Voip Pack
|
|
|
|
El voip pack contiene módulos odoo que se requieren cuando se necesita hacer alguna integración con porveedores o sistemas de voip. Para instalarlo:
|
|
|
|
$ bin/pack_voip.sh [--help] [--version] [--odoo <n>]
|
|
|
|
##### SaaS Pack
|
|
|
|
El mr-erp saas pack es nuestra plataforma de servicios odoo saas. Para instalarlo:
|
|
|
|
$ bin/pack_saas.sh [--help] [--version] [--odoo <n>]
|
|
|
|
##### l10n Pack
|
|
|
|
El l10n pack corresponde a los módulos de internacionalización o adecuación a la trpicalización por país. Para instalarlo:
|
|
|
|
$ bin/pack_l10n.sh [--help] [--version] [--odoo <n>]
|
|
|
|
### GESTIONANDO AMBIENTE LOCAL PARA UN PROYECTO ODOO
|
|
|
|
#### Creación de estructura de un proyecto odoo nuevo
|
|
|
|
Crea la estructura de carpetas y copia los archivos de gestión requeridos para un nuevo proyecto o actualiza un proyecto existente. Donde <proyecto> representa la carpeta que contendra el proyecto odoo. Si el parametro --odoo se omite, se utilizará la versión de odoo definida por defecto.
|
|
|
|
$ cd $HOME/developers/odoo
|
|
$ bin/project.sh <proyecto> [--help] [--version] [--odoo <n>]
|
|
|
|
#### Configurando el ambiente local de desarrollo de un proyecto odoo
|
|
|
|
Este comando permite la creación del archivo .env y contiene los parametros de configuración del ambiente de desarrollo del proyecto. Este archivo es de uso local y especifico para cada ambiente de desarrollador, por lo cual en el .gitignore se omite el envio al repositorio remoto.
|
|
|
|
$ cd $HOME/developers/odoo
|
|
$ bin/configure.sh <proyecto> [--help] [--version]
|
|
|
|
#### Inicializando contenedor odoo local para desarrollo
|
|
|
|
Este comando crea o actualiza el contenedor odoo base a ser utilizado con las librerias y paquetes preconfigurados requeridos, según definido en el archivo .env y en el archivo build/Dockerfile.
|
|
|
|
$ cd $HOME/developers/odoo/<proyecto>
|
|
$ ../bin/builder.sh [--help] [--version]
|
|
|
|
Nota: ES útil cuando no se cuenta con conexión a internet para descargar la imagen preconfigurada. Es saludable correr este proceso antes de iniciar a hacer uso de la instancia la primera vez.
|
|
|
|
### Ejecutando demonios de arranque de instancia local de Odoo
|
|
|
|
#### Arranque de instancia de odoo local para desarrollo
|
|
$ ./up.sh
|
|
|
|
Nota: En este punto deberia poder ir a https://localhost:101[puerto_definido]
|
|
|
|
#### Baja ordenada de instancia de odoo local para desarrollo
|
|
$ ./down.sh
|
|
|
|
Nota: Solo debe ejecutarse si hay una instancia activa del proyecto |