Primeros pasos

Componentes principales

Al trabajar con Odoo.sh, es importante comprender los componentes principales involucrados:

Aunque están todos interconectados, cada uno desempeña un rol distinto en el desarrollo y la implementación de las aplicaciones de Odoo. Juntos, forman un flujo de trabajo integral desde el desarrollo del código hasta su uso empresarial en producción.

Repositorio de GitHub

Un repositorio de GitHub es como una carpeta en tu computadora que contiene todos los archivos y carpetas de un proyecto específico. La diferencia es que se almacena en GitHub y varias personas desde distintas computadoras pueden acceder a él y editarlo.

En otras palabras, un repositorio de GitHub es un lugar donde puedes almacenar los archivos de tu proyecto y compartirlos con otras personas para que colaboren contigo, realicen cambios y contribuyan a tu proyecto. También registra todos los cambios de tu proyecto a lo largo del tiempo, así puedes volver fácilmente a una versión anterior si es necesario.

Además, GitHub ofrece muchas funciones para ayudarte a gestionar tu proyecto, como el seguimiento de incidencias, las solicitudes de extracción y las revisiones de código. Es una herramienta poderosa para gestionar y colaborar en proyectos de software, y es ampliamente utilizada por desarrolladores de todo el mundo. Es un espacio con control de versiones donde se almacena el código fuente de las aplicaciones de Odoo. Registra cada cambio, permite la colaboración y puede ser público o privado.

Captura de pantalla de un ejemplo de un repositorio de GitHub.

Proyecto de Odoo.sh

Un proyecto de Odoo.sh es una plataforma como servicio (PaaS) que se integra con GitHub y permite optimizar el desarrollo, las pruebas y la implementación de las aplicaciones de Odoo. Incluye herramientas como respaldos automáticos, entornos de prueba y flujos de integración continua.

Captura de pantalla de un ejemplo de un proyecto de Odoo.sh.

Base de datos de Odoo

Una base de datos de Odoo almacena todos los datos operativos utilizados y generados por las aplicaciones de Odoo, como registros comerciales, configuraciones y datos de usuarios.

Captura de pantalla de ejemplo de una base de datos de Odoo.

Tipos de usuarios

Odoo.sh involucra distintos tipos de usuarios, cada uno con una función específica en el ciclo de vida del proyecto:

  • Usuarios de GitHub: desarrolladores con acceso al repositorio de GitHub vinculado al proyecto de Odoo.sh. Tener acceso al repositorio no convierte automáticamente a alguien en colaborador del proyecto de Odoo.sh.

  • Colaboradores de Odoo.sh: personas que gestionan el proyecto de Odoo.sh. Cada colaborador debe estar vinculado a un usuario de GitHub. Sin embargo, los colaboradores no son lo mismo que los usuarios de la base de datos.

  • Usuarios de la base de datos: usuarios finales de la base de datos de Odoo implementada. Interactúan con el sistema en producción, pero no participan en el desarrollo ni en la gestión del proyecto.

Conceptos técnicos

Al trabajar con Odoo.sh, también es importante comprender varios conceptos técnicos:

Bifurcar un repositorio

Bifurcar un repositorio en GitHub es cuando creas una copia del repositorio de otra persona en tu propia cuenta. Esto te permite hacer cambios en el repositorio sin afectar la versión original.

Cuando bifurcas un repositorio, creas tu propia copia de este con todos los archivos y carpetas del repositorio original. Luego puedes hacer cambios en los archivos de tu copia del repositorio y hacer commit de ellos, igual que lo harías con cualquier otro repositorio.

La ventaja de bifurcar un repositorio es que puedes hacer cambios en el código sin afectar la versión original, lo cual es útil cuando quieres experimentar con nuevas funciones o corregir errores en el código de alguien más. También puedes usar el repositorio bifurcado como punto de partida para tu proyecto y hacer los cambios según sea necesario.

Una vez que hayas hecho cambios en el repositorio bifurcado, puedes enviar un pull request al propietario del repositorio original para pedirle que fusione tus cambios en su repositorio. Este es un método común en los proyectos de código abierto para aceptar contribuciones de otros desarrolladores y puede ser una excelente manera de involucrarte en la comunidad y mejorar tus habilidades de programación.

Hacer push de un commit

Cuando haces cambios en un archivo o en varios archivos dentro de un repositorio de Git en tu computadora local, esos cambios se consideran sin confirmar. En otras palabras, Git sabe que se hicieron cambios, pero aún no se han guardado ni registrado oficialmente.

Para guardar esos cambios y agregarlos al repositorio de Git, necesitas crear un commit. Un commit es una instantánea de los cambios que hiciste en los archivos en un momento específico. Registra qué cambios se hicieron, quién los hizo y cuándo.

Una vez que hayas creado un commit, puedes hacer push a un repositorio remoto, como uno alojado en GitHub. Hacer push de un commit significa enviar los cambios que hiciste en el commit desde tu repositorio local hacia el repositorio remoto para que otros puedan verlos y usarlos.

En resumen, hacer push de un commit significa enviar los cambios que hiciste en los archivos de tu repositorio de Git desde tu computadora local hacia un repositorio remoto. Es una forma de compartir tus cambios con otros y colaborar en un proyecto.

Fusionar una rama

Fusionar una rama en otra es el proceso de combinar los cambios realizados en una rama con la otra. Por ejemplo, supongamos que creaste una rama nueva llamada feature-branch para trabajar en una nueva función para tu proyecto. Una vez que hayas terminado de hacer cambios en esta rama, puedes fusionar esos cambios de vuelta en la rama principal (a menudo llamada rama master o main).

Cuando fusionas una rama, Git examina los cambios en ambas ramas e intenta combinarlos. Si hay algún conflicto entre los cambios realizados en las dos ramas, Git te pedirá que lo resuelvas antes de completar la fusión (a nivel de código).