Primeiros passos¶
Componentes principais¶
Ao trabalhar com o Odoo.sh, é importante entender os principais componentes envolvidos:
Embora todos estejam interconectados, cada um desempenha um papel distinto no desenvolvimento e na implantação de aplicativos Odoo. Juntos, eles formam um pipeline coeso, do desenvolvimento do código até o uso em produção pela empresa.
Repositório do GitHub¶
Um repositório do GitHub é como uma pasta no seu computador que contém todos os arquivos e pastas de um projeto específico. A diferença é que ele fica armazenado no GitHub e pode ser acessado e editado por várias pessoas em computadores diferentes.
Em outras palavras, um repositório do GitHub é um local onde você pode armazenar os arquivos do seu projeto e compartilhá-los com outras pessoas, para que elas possam colaborar com você, fazer alterações e contribuir com o projeto. Ele também rastreia todas as alterações feitas no projeto ao longo do tempo, permitindo reverter facilmente para uma versão anterior, se necessário.
Além disso, o GitHub oferece muitos recursos para ajudar a gerenciar o seu projeto, como rastreamento de problemas, pull requests e revisões de código. É uma ferramenta poderosa para gerenciar e colaborar em projetos de software, amplamente utilizada por desenvolvedores em todo o mundo: um espaço com controle de versão onde o código-fonte dos aplicativos Odoo é armazenado. Ele rastreia todas as alterações, oferece suporte à colaboração e pode ser público ou privado.
Projeto Odoo.sh¶
Um projeto Odoo.sh é uma Plataforma como Serviço (PaaS) que se integra ao GitHub e possibilita o desenvolvimento, os testes e a implantação simplificados de aplicativos Odoo. Ele inclui ferramentas como backups automatizados, ambientes de teste e pipelines de integração contínua.
Banco de dados Odoo¶
Um banco de dados Odoo armazena todos os dados operacionais usados e gerados pelos aplicativos Odoo, como registros comerciais, configurações e dados de usuários.
Tipos de usuários¶
O Odoo.sh envolve diferentes tipos de usuários, cada um com um papel específico no ciclo de vida do projeto:
Usuários do GitHub: desenvolvedores com acesso ao repositório do GitHub vinculado ao projeto Odoo.sh. Ter acesso ao repositório não torna automaticamente alguém um colaborador do projeto Odoo.sh.
Colaboradores do Odoo.sh: pessoas que gerenciam o projeto Odoo.sh. Cada colaborador deve estar vinculado a um usuário do GitHub. No entanto, os colaboradores não são o mesmo que usuários do banco de dados.
Usuários do banco de dados: usuários finais do banco de dados Odoo implantado. Eles interagem com o sistema em produção, mas não estão envolvidos no desenvolvimento ou no gerenciamento do projeto.
Conceitos técnicos¶
Ao trabalhar com o Odoo.sh, também é importante entender vários conceitos técnicos:
Fazer fork de um repositório¶
Fazer fork de um repositório no GitHub significa criar uma cópia do repositório de outra pessoa em sua própria conta. Isso permite fazer alterações no repositório sem afetar a versão original.
Ao fazer fork de um repositório, você cria sua própria cópia dele, com todos os arquivos e pastas do repositório original. Você pode então fazer alterações nos arquivos da sua cópia do repositório e enviá-las por commit, assim como faria em qualquer outro repositório.
A vantagem de fazer fork de um repositório é poder alterar o código sem afetar a versão original, o que é útil quando você quer experimentar novos recursos ou corrigir bugs no código de outra pessoa. Você também pode usar o repositório com fork como ponto de partida para o seu projeto, fazendo as alterações necessárias.
Depois de fazer as alterações no repositório com fork, você pode enviar um pull request ao proprietário do repositório original, pedindo que ele mescle suas alterações de volta ao repositório dele. Essa é uma abordagem comum em projetos de código aberto para aceitar contribuições de outros desenvolvedores, e pode ser uma ótima maneira de se envolver com a comunidade e melhorar suas habilidades de programação.
Enviar um commit¶
Quando você faz alterações em um arquivo ou em vários arquivos de um repositório Git no seu computador local, essas alterações são consideradas não confirmadas. Em outras palavras, o Git sabe que houve alterações, mas elas ainda não foram salvas ou registradas oficialmente.
Para salvar essas alterações e adicioná-las ao repositório Git, você precisa criar um commit. Um commit é um registro das alterações feitas nos arquivos em um momento específico. Ele indica quais alterações foram feitas, quem as fez e quando.
Depois de criar um commit, você pode enviá-lo (push) para um repositório remoto, como um hospedado no GitHub. Enviar um commit significa transmitir as alterações feitas no commit do seu repositório local para o repositório remoto, para que outras pessoas possam vê-las e utilizá-las.
Em resumo, enviar um commit significa transmitir as alterações feitas nos arquivos do seu repositório Git do computador local para um repositório remoto. É uma forma de compartilhar suas alterações com outras pessoas e colaborar em um projeto.
Mesclar uma branch¶
Mesclar uma branch com outra é o processo de combinar as alterações feitas em uma branch com as da outra. Por exemplo, digamos que você criou uma nova branch chamada feature-branch para trabalhar em um novo recurso do seu projeto. Depois de terminar as alterações nessa branch, você pode mesclá-las de volta na branch principal (geralmente chamada de master ou main).
Ao mesclar uma branch, o Git examina as alterações em ambas as branches e tenta combiná-las. Se houver conflitos entre as alterações feitas nas duas branches, o Git solicitará que você os resolva antes de concluir a mesclagem (no nível do código).