Primeros pasos¶
Componentes principales¶
Al trabajar con Odoo.sh, es importante comprender los componentes principales implicados:
Aunque todos están interconectados, cada uno desempeña una función distinta en el desarrollo y despliegue de las aplicaciones de Odoo. Juntos, forman un flujo cohesionado desde el desarrollo del código hasta el uso en producción.
Repositorio de GitHub¶
Un repositorio de GitHub es como una carpeta de tu ordenador que contiene todos los archivos y carpetas de un proyecto concreto. La diferencia es que se almacena en GitHub y varias personas pueden acceder a él y editarlo desde diferentes ordenadores.
En otras palabras, un repositorio de GitHub es un lugar donde puedes almacenar los archivos de tu proyecto y compartirlos con otros 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, por lo que puedes volver fácilmente a una versión anterior si es necesario.
Además, GitHub ofrece numerosas funciones para ayudarte a gestionar tu proyecto, como el seguimiento de problemas, las solicitudes de extracción (pull requests) y las revisiones de código. Es una herramienta potente para gestionar proyectos de software y colaborar en ellos, 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, facilita la colaboración y puede ser público o privado.
Proyecto de Odoo.sh¶
Un proyecto de Odoo.sh es una plataforma como servicio (PaaS) que se integra con GitHub y permite un desarrollo, pruebas y despliegue optimizados de las aplicaciones de Odoo. Incluye herramientas como copias de seguridad automatizadas, entornos de prueba y flujos de integración continua.
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 usuario.
Tipos de usuario¶
Odoo.sh involucra diferentes tipos de usuarios, cada uno con un rol específico en el ciclo de vida del proyecto:
Usuarios de GitHub: desarrolladores con acceso al repositorio de GitHub vinculado al proyecto de Odoo.sh. El 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 desplegada. 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 entender 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).