Odoo.sh
![]()
Platform-as-a-Service Angebot von Odoo.
Website: https://www.odoo.sh/
Konfiguration
Eigene Domain konfigurieren
Damit ihre Odoo-Installation oder Website unter einer eigenen Domain erreichbar sind, müssen Sie im Besitz der Domäne sein und einen DNS-Eintrag machen. Der DNS-Eintrag zeigt wo man den Odoo-Server für eine bestimme Domain findet.
Angenommen ihr Odoo.sh-Projekt heisst acme und ihre Domain ist example.com, dann müssen Sie diesen DNS-Eintrag erstellen: www.example.com ALIAS acme.odoo.com oder www.example.com CNAME acme.odoo.com.
Tips
Die DNS-Einträge können Sie im Normalfall dort machen, wo Sie die Domain erworben und registriert haben. Verantwortlich für die DNS-Einträge sind die sog. Nameserver.
In den Einstellung findet Sie den Abschnitt Custom domains, hier fügen Sie den Namen ihrer Domain ein.

Build-Verhalten bei Commit festlegen
Wenn Sie auf einen Staging- oder Entwicklungs-Branch committen, erstellt Odoo.sh standardmässig einen neuen Build. In bestimmten Fällen ist dies nicht erwünscht. Das Verhalten können Sie unter Branch > Settings festlegen.

Verwendung
Branch entfernen
Für jede Staging-Phase können Sie eine bestimmte Azahl Branches haben. Möchten Sie einen Branch entfernen so wählen Sie diesen aus und klicken oben rechts auf Delete.

Build-Backup erstellen
Zie Sie die Ansicht Builds des aktuellen Projekts an und suchen Sie den Build aus, den Sie sichern möchten. Wählen Sie im Kontext-Menü die Aktion Download-Backup.
GitHub-Repository einbinden
Angenommen Sie möchten die OCA-Module von https://github.com/OCA/partner-contact auf ihrer Odoo.sh Umgebung zur Verfügung stellen, gehen Sie wie folgt vor. Rufen Sie GitHub-Seite auf und kopieren Sie den SSH-Link zum Repository.

Rufen Sie ihr Odoo.sh Projekt auf und wählen Sie den Staging-Branch aus. Klicken Sie oben rechts auf Submodule > Run on Odoo.sh.

Im Dialog geben Sie den SSH-Link ein, wählen den Branch gemäss Odoo Version und klicken auf Add Submodule.

Nun wird das Submodule und die darin enthaltenen Module auf der Staging-Umgebung zur Verfügung gestellt.
Tips
Um die Submodule zu aktualisieren, müssen Sie das Odoo.sh Projekt als Git-Repository auschecken und die Git-Referenzen auf die Submodule aktualisieren.
Modul-Code bearbeiten
Auf den Staging- und Entwicklungsbranches kann der Code von Modulen direkt bearbeitet werden. Wählen Sie einen Branch aus und klicken Sie auf Editor. Nun öffnet sich in einem neues Fenster JupyterLab. Navigieren Sie nach /src/user. Hie finden Sie den Modul-Code aus dem GitHub-Repository.
Betriebssystem wählen
Das Odoo.sh Projekt wird für ein bestimmtes Betriebssystem eingerichtet. Wenn dieses veraltet ist, können Sie unter Settings ein neueres Betriebssystem wählen.
Warnung
Die entsprechende Einstellung wird nur angezeigt, wenn das Betriebssystem veraltet ist.
Upgrade
Staging-Upgrade ausführen
Aktualisieren Sie den Staging-Branch mit den Modulen für die neue Odoo Version. Wählen Sie den Branch aus und klicken Sie auf Upgrade. Bestätigen Sie den Dialog und der Upgrade wird gestartet.
Der Upgrade-Prozess wird beim Punkt Waiting user commit... angehalten. Nun können die Submodule angepasst werden. Mit dem Befehl git commit --allow-empty -m 'Trigger update'; git push können Sie ein Upgrade der Datebank auslösen.

Odoo stellt die aktualisierte Datenbank auf dem Staging-Branch zum Testen bereit. Sie können weitere Anpassungen vornehmen und comitten.
Upgrade-Modus beenden
Auf dem Branch wählen Sie Exit upgrade mode. Damit wird die ursprüngliche Version
Production-Upgrade ausführen
Mergen Sie den Staging-Branch in den Production-Branch und wählen Sie die Aktion Upgrade aus. Bestätigen Sie den Dialog und Odoo.sh führt das produktive Upgrade aus.
Berechtigungen
Projekt mit Github-Benutzer teilen
Odoo.sh Projekte sind an ein Github-Repository gekoppelt, wenn Sie einem Benutzer Zugriff auf das Projekt geben möchten, müssen Sie den Github-Benutzernamen in den Projekteinstellungen hinterlegen.
Öffnen Sie das Odoo.sh Projekt und navigieren Sie nach Settings > Collaborators. Tragen Sie hier den Benutzernamen und die enstprechenden Berechtigungen ein.

GitHub-Repository mit Benutzer teilen
Odoo.sh Projekte sind an ein Github-Repository gekoppelt, wenn Sie einem Benutzer Zugriff auf das Repository geben möchten, müssen Sie das via GitHub machen.
Klicken Sie auf der Projekt-Kachel-Ansicht von Odoo.sh auf den GitHub-Link. Auf der GitHub-Seite wählen Sie Settings > Collaborators and teams > Manage access > Add people. Geben Sie den GitHub-Benutzernamen ein. Wählen Sie anschliessend eine Rolle aus (Writer ist empfohlen).
Der Benutzer erhält eine Einladung via E-Mail und GitHub-Benachrichtigung. Erst wenn die Einladung angenommen ist, wird der Zugriff erteilt.
GitHub-Repository von persönlich zu Organisation wechseln
In einem persönlichen GitHub-Account können keine weiteren Benutzer mit Admin-Rechten den Repositories zugeordnet werden. Für mehr Möglichkeiten beim Vergeben von Zugriffsrechten wird das Repository einem Organisations-Account zugewiesen. Zusammen mit diesem Wechsel sind in GitHub Anpassungen nötig, sonst funktioniert der Deploy Key nicht mehr, mit dem Odoo.sh auf das Repository in GitHub zurückgreift.
- Navigieren Sie oben rechts zum_User-Icon > Organizations > Unter der betreffenden Organisation > Settings > Access-Section > Member privileges > Deploy keys_.
- Dort wählen Sie Enabled und Save.
- Bei Organization Settings > Third-party access > OAuth Apps > Odoo.sh wählen Sie Grant access.
Kontrollieren Sie den Schlüssel:
- Im GitHub-Repository unter Settings > Section 'Security and Quality' > Deploy keys ist der Schlüssel für Odoo.sh aufgeführt.
- Im Odoo.sh-Projekt unter Settings > GitHub Key & Webhook führt der Klick auf Verify Deploy Key zur Bestätigung "Deploy key successfully detected"
Warnung
Werden die Einstellungen in GitHub nicht angepasst, führt der Klick auf Verify Deploy Key zum "Access Error: You must be admin of the GitHub repository to do this action", auch wenn bereits Admin-Rechte vergeben wurden.
Datenbank
Datenbank importieren
Loggen Sie sich in ihr Odoo.sh Projekt ein. Wählen Sie den auf linken Seiten den Branch aus und klicken Sie auf den Tab Backups. Anschliessend klicken Sie auf Import Database. Es öffnet sich ein Dialog mit Informationen zum Import-Vorgang. Klicken Sie auf Next. Abhängig von der Grösse der Zip-Datei wählen Sie die entsprechende Option.
- Wählen Sie die Zip-Datei aus und klicken Sie auf Import.
- Führen Sie den Kommandozeilen-Befehl aus. Starten Sie nach dem Upload den Vorgang mit Import.