Instalacja ze źródeł¶
„Instalacja” ze źródeł nie polega na instalowaniu Odoo, ale na uruchamianiu go bezpośrednio ze źródeł.
Korzystanie ze źródeł Odoo może być wygodniejsze dla programistów modułów, ponieważ jest łatwiej dostępne niż korzystanie z instalatorów pakietów.
Umożliwia bardziej elastyczne i jawne uruchamianie i zatrzymywanie Odoo niż usługi skonfigurowane przez instalatory pakietów. Pozwala również zastępować ustawienia za pomocą parametrów wiersza poleceń bez konieczności edytowania pliku konfiguracyjnego.
Zapewnia większą kontrolę nad konfiguracją systemu i pozwala łatwiej utrzymywać (i uruchamiać) wiele wersji Odoo równolegle.
Pobierz źródła¶
Istnieją dwa sposoby uzyskania kodu źródłowego Odoo: jako archiwum ZIP lub przez Git.
Archiwizuj¶
Edycja Community:
Edycja Enterprise:
Git¶
Informacja
Wymagane jest zainstalowanie Git, a zalecana jest podstawowa znajomość poleceń Git.
Aby sklonować repozytorium Git, wybierz między klonowaniem przez HTTPS lub SSH. W większości przypadków najlepszą opcją jest HTTPS. Wybierz jednak SSH, aby współtworzyć kod źródłowy Odoo lub podczas realizacji samouczka Pierwsze kroki dla programistów.
$ git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
C:\> git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
C:\> git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
Informacja
Repozytorium git Enterprise nie zawiera pełnego kodu źródłowego Odoo. Jest to tylko zbiór dodatkowych dodatków. Główny kod serwera znajduje się w wersji Community. Uruchomienie wersji Enterprise oznacza uruchomienie serwera z wersji Community z opcją addons-path ustawioną na folder z wersją Enterprise. Wymagane jest sklonowanie zarówno repozytorium Community, jak i Enterprise, aby mieć działającą instalację Odoo Enterprise.
Przygotowanie¶
Python¶
Odoo wymaga Pythona 3.10 lub nowszego do działania.
Zmienione w wersji 17: Minimalny wymóg zaktualizowany z Pythona 3.7 do Pythona 3.10.
Użyj menedżera pakietów, aby pobrać i zainstalować Pythona 3, jeśli to konieczne.
Pobierz najnowszą wersję Pythona 3 i zainstaluj ją.
Podczas instalacji zaznacz Add Python 3 to PATH, następnie kliknij Customize Installation i upewnij się, że pip jest zaznaczony.
Informacja
Jeśli Python 3 jest już zainstalowany, upewnij się, że wersja to 3.10 lub wyższa, ponieważ poprzednie wersje nie są kompatybilne z Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Sprawdź, czy pip jest również zainstalowany dla tej wersji.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo używa PostgreSQL jako systemu zarządzania bazą danych.
Użyj menedżera pakietów, aby pobrać i zainstalować PostgreSQL (obsługiwane wersje: 12.0 lub nowsze). Można to osiągnąć, wykonując następujące polecenie:
$ sudo apt install postgresql postgresql-client
Pobierz PostgreSQL (obsługiwane wersje: 12.0 lub nowsze) i zainstaluj go.
Użyj Postgres.app, aby pobrać i zainstalować PostgreSQL (obsługiwana wersja: 12.0 lub nowsza).
Wskazówka
Aby udostępnić narzędzia wiersza poleceń dołączone do Postgres.app, upewnij się, że skonfigurowałeś zmienną $PATH, postępując zgodnie z instrukcjami narzędzi CLI Postgres.app.
Domyślnie jedynym użytkownikiem jest postgres. Ponieważ Odoo zabrania łączenia się jako postgres, utwórz nowego użytkownika PostgreSQL.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Informacja
Ponieważ użytkownik PostgreSQL ma taką samą nazwę jak login Unix, możliwe jest połączenie z bazą danych bez hasła.
Dodaj katalog
binPostgreSQL (domyślnie:C:\Program Files\PostgreSQL\<version>\bin) doPATH.Utwórz użytkownika postgres z hasłem, używając interfejsu graficznego pg admin:
Otwórz pgAdmin.
Kliknij dwukrotnie serwer, aby utworzyć połączenie.
Wybierz .
Wprowadź nazwę użytkownika w polu Role Name (np.
odoo).Otwórz zakładkę Definition, wprowadź hasło (np.
odoo) i kliknij Save.Otwórz zakładkę Privileges i przełącz Can login? na
Yesoraz Create database? naYes.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Informacja
Ponieważ użytkownik PostgreSQL ma taką samą nazwę jak login Unix, możliwe jest połączenie z bazą danych bez hasła.
Zależności¶
Używanie pakietów dystrybucyjnych jest preferowanym sposobem instalacji zależności. Alternatywnie można zainstalować zależności Pythona za pomocą pip.
Na Debianie/Ubuntu następujące polecenia powinny zainstalować wymagane pakiety:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
Skrypt setup/debinstall.sh przeanalizuje plik debian/control i zainstaluje znalezione pakiety.
Ostrzeżenie
Używanie pip może prowadzić do problemów z bezpieczeństwem i uszkodzonych zależności; rób to tylko, jeśli wiesz, co robisz.
Ponieważ niektóre pakiety Pythona wymagają etapu kompilacji, potrzebują zainstalowanych bibliotek systemowych.
Na Debianie/Ubuntu następujące polecenie powinno zainstalować te wymagane biblioteki:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Zależności Odoo są wymienione w pliku requirements.txt znajdującym się w katalogu głównym Odoo Community.
Informacja
Pakiety Pythona w requirements.txt są oparte na ich stabilnej/LTS wersji Debiana/Ubuntu odpowiadającej dacie wydania Odoo. Na przykład dla Odoo 15.0 wersja pakietu python3-babel to 2.8.0 w Debianie Bullseye i 2.6.0 w Ubuntu Focal. Najniższa wersja jest następnie wybierana w requirements.txt.
Wskazówka
Może być wskazane, aby nie mieszać pakietów modułów Pythona między różnymi instancjami Odoo lub z systemem. Można jednak użyć virtualenv do tworzenia izolowanych środowisk Pythona.
Przejdź do ścieżki instalacji Odoo Community (CommunityPath) i uruchom pip na pliku wymagań, aby zainstalować wymagania dla bieżącego użytkownika.
$ cd /CommunityPath
$ pip install -r requirements.txt
Przed instalacją zależności pobierz i zainstaluj Build Tools for Visual Studio. Wybierz C++ build tools w zakładce Workloads i zainstaluj je po wyświetleniu monitu.
Zależności Odoo są wymienione w pliku requirements.txt znajdującym się w katalogu głównym Odoo Community.
Wskazówka
Może być wskazane, aby nie mieszać pakietów modułów Pythona między różnymi instancjami Odoo lub z systemem. Można jednak użyć virtualenv do tworzenia izolowanych środowisk Pythona.
Przejdź do ścieżki instalacji Odoo Community (CommunityPath) i uruchom pip na pliku wymagań w terminalu z uprawnieniami administratora:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Zależności Odoo są wymienione w pliku requirements.txt znajdującym się w katalogu głównym Odoo Community.
Wskazówka
Może być wskazane, aby nie mieszać pakietów modułów Pythona między różnymi instancjami Odoo lub z systemem. Można jednak użyć virtualenv do tworzenia izolowanych środowisk Pythona.
Przejdź do ścieżki instalacji Odoo Community (CommunityPath) i uruchom pip na pliku wymagań:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Informacja
W przypadku języków używających interfejsu od prawej do lewej (takich jak arabski lub hebrajski) wymagany jest pakiet rtlcss.
Pobierz i zainstaluj nodejs oraz npm za pomocą menedżera pakietów.
Zainstaluj
rtlcss:$ sudo npm install -g rtlcss
Pobierz i zainstaluj nodejs.
Zainstaluj
rtlcss:C:\> npm install -g rtlcssEdytuj zmienną środowiskową systemu
PATH, aby dodać folder, w którym znajduje sięrtlcss.cmd(zazwyczaj:C:\Users\<użytkownik>\AppData\Roaming\npm\).
Ostrzeżenie
wkhtmltopdf nie jest instalowany przez pip i musi być zainstalowany ręcznie w wersji 0.12.6, aby obsługiwał nagłówki i stopki. Sprawdź wkhtmltopdf wiki, aby uzyskać więcej informacji na temat różnych wersji.
Uruchamianie Odoo¶
Po skonfigurowaniu wszystkich zależności Odoo można uruchomić, wykonując odoo-bin, interfejs wiersza poleceń serwera. Znajduje się on w katalogu głównym katalogu Odoo Community.
Aby skonfigurować serwer, należy określić argumenty wiersza poleceń lub plik konfiguracyjny.
Wskazówka
W przypadku edycji Enterprise dodaj ścieżkę do dodatków enterprise do argumentu addons-path. Należy pamiętać, że musi ona znajdować się przed innymi ścieżkami w addons-path, aby dodatki zostały poprawnie załadowane.
Typowe niezbędne konfiguracje to:
Użytkownik i hasło PostgreSQL.
Niestandardowe ścieżki dodatków poza domyślnymi do ładowania niestandardowych modułów.
Typowy sposób uruchomienia serwera wyglądałby następująco:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Gdzie CommunityPath to ścieżka instalacji Odoo Community, a mydb to nazwa bazy danych PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Gdzie CommunityPath to ścieżka instalacji Odoo Community, dbuser to login PostgreSQL, dbpassword to hasło PostgreSQL, a mydb to nazwa bazy danych PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Gdzie CommunityPath to ścieżka instalacji Odoo Community, a mydb to nazwa bazy danych PostgreSQL.
Po uruchomieniu serwera (wyświetlenie logu INFO odoo.modules.loading: Modules loaded.) otwórz http://localhost:8069 w przeglądarce internetowej i zaloguj się do bazy danych Odoo za pomocą podstawowego konta administratora: użyj admin jako adresu e-mail i ponownie admin jako hasła.
Wskazówka
Stamtąd twórz i zarządzaj nowymi użytkownikami.
Konto użytkownika używane do logowania się do interfejsu webowego Odoo różni się od argumentu CLI
--db_user.
Zobacz także