Primeros pasos

Componentes principales

When working with Odoo.sh, it is important to understand the main components involved:

While they are all interconnected, each one plays a distinct role in the development and deployment of Odoo applications. Together, they form a cohesive pipeline from code development to a live business use.

GitHub repository

A GitHub repository is like a folder on your computer that contains all the files and folders for a specific project. The difference is that it’s stored on GitHub and can be accessed and edited by multiple people on different computers.

In other words, a GitHub repository is a place where you can store your project’s files and share them with others, so they can collaborate with you, make changes, and contribute to your project. It also tracks all changes to your project over time, so you can easily roll back to a previous version if needed.

Additionally, GitHub offers many features to help you manage your project, such as issue tracking, pull requests, and code reviews. It’s a powerful tool for managing and collaborating on software projects, and is widely used by developers around the world. a version-controlled space where the Odoo applications” source code is stored. It tracks every change, supports collaboration, and can be either public or private.

Ejemplo de un repositorio de GitHub

Odoo.sh project

An Odoo.sh project is a Platform as a Service (PaaS) that integrates with GitHub and enables streamlined development, testing, and deployment of Odoo applications. It includes tools such as automated backups, staging environments, and continuous integration pipelines.

Ejemplo de un proyecto de Odoo.sh

Base de datos de Odoo

An Odoo database stores all the operational data used and generated by Odoo applications, such as business records, configurations, and user data.

Ejemplo de una base de datos de Odoo

Tipos de usuario

Odoo.sh involucra diferentes tipos de usuarios, cada uno con un rol específico en el ciclo de vida del proyecto:

  • GitHub users: developers with access to the GitHub repository linked to the Odoo.sh project. Access to the repository does not automatically make someone a collaborator on the Odoo.sh project.

  • Odoo.sh collaborators: individuals managing the Odoo.sh project. Each collaborator must be linked to a GitHub user. However, collaborators are not the same as database users.

  • Database users: end-users of the deployed Odoo database. They interact with the live system but are not involved in development or project management.

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).