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 hav.sh 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 hav.sh GitHub App installieren. Siehe GitHub-Integration für die Einrichtungsanleitung.

#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. hav.sh wird es nach Odoo-Addons durchsuchen.

#4. Entdeckte Addons überprüfen

hav.sh 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 hav.sh synchronisieren, um neue Addons oder aktualisierte Versionen zu entdecken. hav.sh 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 hav.sh 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 hav.sh 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-Namen pro 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 hav.sh 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