Zum Inhalt springen

Dokumentation / Code und Addons

Addon-Repositories

GitHub-Repositories mit Odoo-Addons verbinden.

Addon-Repositories sind GitHub-Repositories, die ein oder mehrere Odoo-Addons enthalten. Wenn du ein Repository mit calmo.cloud verbindest, machst du dessen Addons für die Bereitstellung auf deinen Diensten verfügbar.

Repository verbinden #

1. GitHub-Integration einrichten #

Bevor du Repositories verbindest, musst du die calmo.cloud GitHub App auf dem GitHub-Konto oder der Organisation installieren, dem die Repositories gehören:

  1. Öffne in der Seitenleiste Developer → GitHub Installations und klicke auf Connect GitHub.
  2. GitHub fragt, auf welchem Konto die App installiert werden soll und auf welche Repositories sie zugreifen darf. Wähle die Repositories mit deinen Addons aus und bestätige.
  3. Du wirst zurück zu calmo.cloud geleitet, wo die Installation geprüft und aufgelistet wird. Wiederhole das für jedes GitHub-Konto bzw. jede Organisation, aus der du deployst.

Wurde die App bereits auf GitHub installiert, nutze Add Manually und gib ihre Installations-ID ein.

2. Repository hinzufügen #

Gehe in der Seitenleiste zu Addon-Repositories und klicke auf Neues Repository.

3. Repository auswählen #

Wähle ein Repository aus deiner GitHub-Organisation. calmo.cloud wird es nach Odoo-Addons durchsuchen.

4. Entdeckte Addons überprüfen #

calmo.cloud listet alle im Repository gefundenen Addons auf, einschliesslich:

  • Addon-Name und -Beschreibung
  • Unterstützte Odoo-Versionen
  • Abhängigkeiten

Repositories synchronisieren #

Wenn du neue Commits in dein GitHub-Repository pushst, kannst du die Änderungen in calmo.cloud synchronisieren, um neue Addons oder aktualisierte Versionen zu entdecken. calmo.cloud verfolgt:

  • Commit-SHAs — Welche exakte Version des Codes bereitgestellt ist
  • Addon-Versionen — Kompatibilität pro Odoo-Version
  • Externe Abhängigkeiten — Benötigte Python-Pakete oder Systembibliotheken

Eigene Branch-Namen pro Odoo-Version #

Standardmässig geht calmo.cloud davon aus, dass ein Repository die Odoo-Versionsnummer als Branch-Namen verwendet — also 18.0 für Odoo 18 und 19.0 für Odoo 19. Die meisten Repositories (einschliesslich OCA) folgen dieser Konvention.

Manche Teams verwenden andere Branch-Namen — zum Beispiel v18 und v19 oder 18 und 19. Damit calmo.cloud aus diesen Branches synchronisieren und deployen kann, kannst du den Branch-Namen pro Odoo-Version am Repository konfigurieren.

Trage auf der Bearbeitungsseite des Repositories im Abschnitt Branch names per Odoo version den Branch ein, den dieses Repository für die jeweilige Odoo-Version verwendet. Lass ein Feld leer, um auf die Odoo-Version selbst zurückzufallen (z. B. 18.0).

Beispiel: Ein Repository, dessen Odoo-18-Branch v18 und Odoo-19-Branch v19 heisst, würde so konfiguriert:

  • Odoo 18.0 Branch: v18
  • Odoo 19.0 Branch: v19

Nach dem Speichern sucht die nächste Synchronisation Addons auf den konfigurierten Branches und Deployments verwenden diese Branches standardmässig.

Branch-Overrides pro Service oder pro Addon (für Feature-Branches und Preview-Deployments) haben weiterhin Vorrang vor dem Repository-Standard — die Einstellung pro Version ändert nur, worauf calmo.cloud zurückgreift, wenn kein Override gesetzt ist.

Repositories verwalten #

Von der Repository-Detailseite aus kannst du:

  • Alle Addons im Repository anzeigen
  • Sehen, welche Dienste Addons aus diesem Repository bereitgestellt haben
  • Synchronisieren, um die neuesten Änderungen von GitHub abzurufen
  • Das Repository entfernen, wenn es nicht mehr benötigt wird
Überblick Addons installieren