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 consiste en crear una copia del repositorio de otra persona en tu propia cuenta. Esto te permite hacer cambios en el repositorio sin afectar a la versión original.

Cuando bifurcas un repositorio, creas tu propia copia de este, con todos los archivos y carpetas del repositorio original. A continuación, puedes modificar los archivos de tu copia y confirmar los cambios, igual que harías con cualquier otro repositorio.

La ventaja de bifurcar un repositorio es que puedes hacer cambios en el código sin afectar a la versión original. Esto es útil cuando quieres experimentar con nuevas funciones o corregir errores en el código de otra persona. También puedes usar el repositorio bifurcado como punto de partida para tu proyecto y hacer los cambios que necesites.

Una vez que hayas hecho cambios en el repositorio bifurcado, puedes enviar una solicitud de incorporación de cambios al propietario del repositorio original para pedirle que fusione tus cambios con su repositorio. Este es un enfoque habitual en los proyectos de código abierto para aceptar contribuciones de otros desarrolladores. Además, es una excelente manera de involucrarte en la comunidad y mejorar tus habilidades de programación.

Subir un commit

Cuando modificas uno o varios archivos en un repositorio de Git en tu ordenador local, esos cambios se consideran sin confirmar. Es decir, Git sabe que se han hecho cambios, pero todavía no se han guardado ni registrado oficialmente.

Para guardar esos cambios y añadirlos al repositorio de Git, debes crear un commit. Un commit es una instantánea de los cambios que hiciste en los archivos en un momento concreto. Registra qué cambios se hicieron, quién los hizo y cuándo.

Una vez que has creado un commit, puedes subirlo a un repositorio remoto, como uno alojado en GitHub. Subir un commit significa enviar los cambios que hiciste en el commit desde tu repositorio local al repositorio remoto para que otras personas puedan verlos y usarlos.

En resumen, subir un commit significa enviar los cambios que has hecho en los archivos de tu repositorio de Git desde tu ordenador local a un repositorio remoto. Es una forma de compartir tus cambios con otras personas y colaborar en un proyecto.

Fusionar una rama

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

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