Komma igång

Huvudkomponenter

När du arbetar med Odoo.sh är det viktigt att förstå huvudkomponenterna som ingår:

Även om de alla är sammankopplade har var och en en tydlig roll i utvecklingen och driftsättningen av Odoo-applikationer. Tillsammans utgör de ett sammanhängande flöde från kodutveckling till skarp affärsanvändning.

GitHub-arkiv

Ett GitHub-arkiv (repository) är som en mapp på din dator som innehåller alla filer och mappar för ett specifikt projekt. Skillnaden är att det lagras på GitHub och kan nås samt redigeras av flera personer på olika datorer.

Med andra ord är ett GitHub-arkiv en plats där du kan lagra ditt projekts filer och dela dem med andra, så att de kan samarbeta med dig, göra ändringar och bidra till ditt projekt. Det spårar också alla ändringar i ditt projekt över tid, så att du enkelt kan återgå till en tidigare version om det behövs.

Dessutom erbjuder GitHub många funktioner för att hjälpa dig hantera ditt projekt, såsom ärendehantering, pull requests och kodgranskningar. Det är ett kraftfullt verktyg för att hantera och samarbeta kring mjukvaruprojekt, och används i stor utsträckning av utvecklare världen över – ett versionshanterat utrymme där Odoo-applikationernas källkod lagras. Det spårar varje ändring, stöder samarbete och kan vara antingen offentligt eller privat.

Exempel på ett GitHub-förråd

Odoo.sh-projekt

Ett Odoo.sh-projekt är en Platform as a Service (PaaS) som integreras med GitHub och möjliggör smidig utveckling, testning och driftsättning av Odoo-applikationer. Det inkluderar verktyg såsom automatiserade säkerhetskopieringar, testmiljöer och sammanhängande integrationsflöden.

Exempel på ett Odoo.sh-projekt

Odoo-databas

En Odoo-databas lagrar all verksamhetsinformation som används och genereras av Odoo-applikationer, såsom affärsposter, konfigurationer och användardata.

Exempel på en Odoo-databas

Användartyper

Odoo.sh involverar olika typer av användare, var och en med en specifik roll i projektets livscykel:

  • GitHub-användare: utvecklare med åtkomst till GitHub-arkivet som är kopplat till Odoo.sh-projektet. Tillgång till arkivet gör inte automatiskt någon till en medarbetare i Odoo.sh-projektet.

  • Odoo.sh-samarbetspartners: personer som hanterar Odoo.sh-projektet. Varje samarbetspartner måste vara kopplad till en GitHub-användare. Samarbetspartners är dock inte samma sak som databasanvändare.

  • Databasanvändare: slutanvändare av den driftsatta Odoo-databasen. De interagerar med det aktiva systemet men är inte involverade i utveckling eller projektledning.

Tekniska begrepp

När du arbetar med Odoo.sh är det också viktigt att förstå flera tekniska begrepp:

Forka ett arkiv

Att forka ett arkiv på GitHub innebär att du skapar en kopia av någon annans arkiv på ditt eget konto. Detta gör att du kan göra ändringar i arkivet utan att påverka originalversionen.

När du forkar ett arkiv skapar du en egen kopia av arkivet, komplett med alla filer och mappar i ursprungsarkivet. Du kan sedan göra ändringar i filerna i din kopia av arkivet och göra commits för dem, precis som du skulle göra med vilket annat arkiv som helst.

Fördelen med att forka ett arkiv är att du kan göra ändringar i koden utan att påverka originalversionen, vilket är användbart när du vill experimentera med nya funktioner eller åtgärda buggar i någon annans kod. Du kan även använda det forkade arkivet som en utgångspunkt för ditt projekt och göra ändringar efter behov.

När du har gjort ändringar i det forkade arkivet kan du skicka in en pull-förfrågan till ägaren av ursprungsarkivet och be denne att sammanfoga dina ändringar tillbaka till sitt arkiv. Detta är ett vanligt tillvägagångssätt för projekt med öppen källkod för att ta emot bidrag från andra utvecklare, och det kan vara ett utmärkt sätt att engagera sig i gemenskapen och förbättra sina programmeringskunskaper.

Pusha en commit

När du gör ändringar i en fil eller flera filer i ett Git-arkiv på din lokala dator betraktas dessa ändringar som uncommitted. Med andra ord vet Git att ändringar har gjorts, men de har ännu inte sparats eller registrerats officiellt.

För att spara dessa ändringar och lägga till dem i Git-arkivet måste du skapa en commit. En commit är en ögonblicksbild av de ändringar du gjort i filerna vid en viss tidpunkt. Den registrerar vilka ändringar som gjordes, vem som gjorde dem och när.

När du har skapat en commit kan du sedan pusha den till ett fjärrarkiv, till exempel ett som hanteras på GitHub. Att pusha en commit innebär att skicka de ändringar du har gjort i committen från ditt lokala arkiv till fjärrarkivet så att andra kan se och använda dem.

Sammanfattningsvis innebär att pusha en commit att skicka de ändringar du har gjort i filerna i ditt Git-arkiv från din lokala dator till ett fjärrarkiv. Det är ett sätt att dela dina ändringar med andra och samarbeta i ett projekt.

Sammanfoga en filial

Att sammanfoga en filial med en annan är processen att slå samman ändringarna som gjorts i en filial till den andra. Anta till exempel att du skapade en ny filial som heter feature-branch för att arbeta på en ny funktion för ditt projekt. När du är klar med ändringarna i denna filial kan du sammanfoga dessa ändringar tillbaka till huvudfilialen (ofta kallad master- eller main-filialen).

När du sammanfogar en filial undersöker Git ändringarna i båda filialerna och försöker kombinera dem. Om det uppstår konflikter mellan ändringarna som gjorts i de två filialerna kommer Git att uppmana dig att lösa dem innan sammanfogningen slutförs (kodmässigt).