Linux : Ubuntu 18.04 : Odoo 13 설치 방법, 예제, 명령어

Odoo는 인기 있는 오픈 소스 비즈니스 앱 제품군입니다. CRM, e-Commerce, 웹 사이트 작성기, 청구서, 회계, 제조, 창고, 프로젝트 관리, 재고 등 다양한 애플리케이션을 완벽하게 통합합니다.

Odoo는 사용 사례 및 사용 가능한 기술에 따라 다양한 방법으로 설치할 수 있습니다. Odoo를 설치하는 가장 쉽고 빠른 방법은 공식 Odoo APT 저장소를 사용하는 것입니다. 

가상 환경에 Odu를 설치하거나 Docker 컨테이너로 배포하면 시스템 설정을 보다 효과적으로 제어할 수 있으며 동일한 시스템에서 여러 Odu 버전을 실행할 수 있습니다. 

이 가이드에서는 Ubuntu 18.04의 Python 가상 환경에 Odoo 13을 설치하고 배포하는 방법에 대해 설명합니다. 그들의 Github 저장소에서 Odoo를 다운로드하고 역 프록시로 Nginx를 사용할 것입니다.

 

 

 

필수 구성 요소를 설치

Sudo 사용자로 Ubuntu에 로그인하고 Apt 캐시를 업데이트합니다.

sudo apt update

 

 

Git , Pip , Node.js 및 Odu 종속성을 구축하는 데 필요한 도구를 설치합니다.

sudo apt install git python3-pip build-essential wget python3-dev python3-venv python3-wheel libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools node-less

 

 

 

시스템 사용자 생성 

홈 디렉토리 /opt/odoo13을 사용하여 Odoo13이라는 이름의 Odoo를 실행할 시스템 사용자를 생성합니다.

sudo useradd -m -d /opt/odoo13 -U -r -s /bin/bash odoo13

 

 

PostgreSQL를 만드는 동안 원하는 대로 사용자 이름을 설정할 수 있습니다.

 

 

 

PostgreSQL를 설치하고 구성

Odoo는 PostgreSQL을 데이터베이스 백엔드로 사용합니다. PostgreSQL를 설치하고 다음 명령을 실행합니다.

sudo apt install postgresql

 

 

설치가 완료되면 Postgre를 만듭니다.이전에 생성된 시스템 사용자와 동일한 이름의 SQL 사용자입니다. 이 경우 odoo13입니다.

sudo su - postgres -c "createuser -s odoo13"

 

 

 

Wkhtmltopdf를 설치

wkhtmltox 패키지는 HTML을 PDF 및 다양한 이미지 형식으로 렌더링할 수 있는 일련의 오픈 소스 명령줄 도구를 제공합니다. PDF 보고서를 인쇄하려면 wkhtmltopdf 도구를 설치해야 합니다. Odoo의 권장 버전은 0.12.5이며 기본 Ubuntu 18.04 리포지토리에서는 사용할 수 없습니다.

다음 wget 명령을 사용하여 패키지를 다운로드합니다.

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb

 

 

다운로드가 완료되면 다음을 입력하여 패키지를 설치합니다.

sudo apt install ./wkhtmltox_0.12.5-1.bionic_amd64.deb

 

 

 

Odoo 13을 설치하고 구성

앞에서 언급한 것처럼 분리된 파이썬 가상 환경의 소스에서 Odu를 설치합니다.

먼저 사용자 "odoo13"으로 변경합니다.

sudo su - odoo13

 

 

GitHub에서 Odoo 13 소스 코드를 복제합니다.

git clone https://www.github.com/odoo/odoo --depth 1 --branch 13.0 /opt/odoo13/odoo

 

 

 

다운로드가 완료되면 Odoo를 위한 새로운 파이썬 가상 환경을 만듭니다.

cd /opt/odoo13
python3 -m venv odoo-venv

 

 

다음 명령을 사용하여 환경을 활성화합니다.

source odoo-venv/bin/activate

 

 

pip3와 함께 필요한 모든 파이썬 모듈을 설치합니다.

pip3 install wheel
pip3 install -r odoo/requirements.txt

 

 

 

설치 중에 컴파일 오류가 발생하면 필수 구성 요소 설치 섹션에 나열된 모든 필수 종속성이 설치되었는지 확인합니다.

완료되면 다음을 입력하여 환경을 비활성화합니다.

deactivate

 

 

 

제3자 부록을 저장할 새 디렉터리를 만듭니다.

mkdir /opt/odoo13/odoo-custom-addons

 

 

나중에 addons_path 매개 변수에 이 디렉토리를 추가합니다. 이 매개 변수는 Odoo가 모듈을 검색하는 디렉터리 목록을 정의합니다.

다시 sudo 사용자로 전환합니다.

exit

 

 

다음 내용으로 구성 파일을 만듭니다.

# /etc/odoo13.conf

[options]
; This is the password that allows database operations:
admin_passwd = my_admin_passwd
db_host = False
db_port = False
db_user = odoo13
db_password = False
addons_path = /opt/odoo13/odoo/addons,/opt/odoo13/odoo-custom-addons

 

 

my_admin_passwd를 보다 안전한 것으로 변경하는 것을 잊지 마십시오.

 

 

 

Systemd 단위 파일 생성

텍스트 편집기를 열고 다음 내용으로 odoo13.service라는 서비스 단위 파일을 만듭니다.

# /etc/systemd/system/odoo13.service

[Unit]
Description=Odoo13
Requires=postgresql.service
After=network.target postgresql.service

[Service]
Type=simple
SyslogIdentifier=odoo13
PermissionsStartOnly=true
User=odoo13
Group=odoo13
ExecStart=/opt/odoo13/odoo-venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /etc/odoo13.conf
StandardOutput=journal+console

[Install]
WantedBy=multi-user.target

 

 

systemd에 새 장치 파일이 존재함을 알립니다.

sudo systemctl daemon-reload

 

 

Odoo 서비스를 시작하고 부팅 시 다음을 실행하여 시작할 수 있도록 설정합니다.

sudo systemctl enable --now odoo13

 

 

서비스 상태를 확인합니다.

sudo systemctl status odoo13

# ● odoo13.service
#    Loaded: loaded (/etc/systemd/system/odoo13.service; enabled; vendor preset: enabled)
#    Active: active (running) since Sat 2019-10-19 20:06:23 UTC; 3s ago
#  Main PID: 1860 (python3)
#     Tasks: 4 (limit: 2362)
#    CGroup: /system.slice/odoo13.service
#            └─1860 /opt/odoo13/odoo-venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /et

 

 

Odu 서비스에서 기록한 메시지를 보려면 아래 명령을 사용하십시오.

sudo journalctl -u odoo13

 

 

 

설치를 테스트

브라우저를 열고 http://<your_domain_or_IP_address>:8069입니다.

설치가 성공하면 다음과 유사한 화면이 나타납니다.

Linux : Ubuntu 18.04 : Odoo 13 설치 방법, 예제, 명령어

 

 

 

Nginx를 SSL 종료 프록시로 구성

기본 Odoo 웹 서버는 HTTP를 통해 트래픽을 서비스하고 있습니다. Odoo 배포를 보다 안전하게 만들기 위해 Nginx를 HTTPS를 통해 트래픽을 처리하는 SSL 종료 프록시로 구성합니다.

SSL 종료 프록시는 SSL 암호화/해제를 처리하는 프록시 서버입니다. 즉, 종료 프록시(Nginx)가 들어오는 TLS 연결(HTTPS)을 처리 및 해독하고 암호화되지 않은 요청을 내부 서비스(Odu)에 전달합니다. Nginx와 Odoo 사이의 트래픽은 암호화되지 않습니다(HTTP).

역방향 프록시를 사용하면 로드 밸런싱, SSL 종료, 캐싱, 압축, 정적 콘텐츠 서비스 등과 같은 많은 이점을 얻을 수 있습니다.

이 섹션을 계속하기 전에 다음 필수 조건을 충족했는지 확인하십시오.

- 공용 서버 IP를 가리키는 도메인 이름입니다. example.com을 이용하겠습니다.

- Nginx가 설치되었습니다.

- 도메인에 대한 SSL 인증서입니다. 무료 암호화 SSL 인증서를 설치할 수 있습니다.

 

텍스트 편집기를 열고 도메인 서버 블록을 작성/편집합니다.

sudo nano /etc/nginx/sites-enabled/example.com.conf

 

 

다음 구성은 SSL 종료, HTTP에서 HTTPS로 리디렉션, WWW에서 비WW로 리디렉션, 정적 파일을 캐시하고 GZip 압축을 사용하도록 설정합니다.

# /etc/nginx/sites-enabled/example.com.conf

# Odoo servers
upstream odoo {
 server 127.0.0.1:8069;
}

upstream odoochat {
 server 127.0.0.1:8072;
}

# HTTP -> HTTPS
server {
    listen 80;
    server_name www.example.com example.com;

    include snippets/letsencrypt.conf;
    return 301 https://example.com$request_uri;
}

# WWW -> NON WWW
server {
    listen 443 ssl http2;
    server_name www.example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    include snippets/ssl.conf;
    include snippets/letsencrypt.conf;

    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com;

    proxy_read_timeout 720s;
    proxy_connect_timeout 720s;
    proxy_send_timeout 720s;

    # Proxy headers
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;

    # SSL parameters
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    include snippets/ssl.conf;
    include snippets/letsencrypt.conf;

    # log files
    access_log /var/log/nginx/odoo.access.log;
    error_log /var/log/nginx/odoo.error.log;

    # Handle longpoll requests
    location /longpolling {
        proxy_pass http://odoochat;
    }

    # Handle / requests
    location / {
       proxy_redirect off;
       proxy_pass http://odoo;
    }

    # Cache static files
    location ~* /web/static/ {
        proxy_cache_valid 200 90m;
        proxy_buffering on;
        expires 864000;
        proxy_pass http://odoo;
    }

    # Gzip
    gzip_types text/css text/less text/plain text/xml application/xml application/json application/javascript;
    gzip on;
}

 

 

example.com을 Odu 도메인으로 바꾸고 SSL 인증서 파일의 올바른 경로를 설정하는 것을 잊지 마십시오. 이 구성에 사용된 스니펫은 이 안내서에 작성되어 있습니다.

완료되면 Nginx 서비스를 다시 시작합니다.

sudo systemctl restart nginx

 

 

다음엔, 오두에게 대리인을 이용하라고 말해야 해요. 이렇게 하려면 구성 파일을 열고 다음 줄을 추가하십시오.

# /etc/odoo13.conf

proxy_mode = True

 

 

변경 내용을 적용하려면 Odu 서비스를 다시 시작합니다.

sudo systemctl restart odoo13

 

 

이때 역방향 프록시가 구성되며 다음 사이트에서 Odu 인스턴스에 액세스할 수 있습니다. https://example.com

 

 

 

바인딩 인터페이스를 변경

이 단계는 선택 사항이지만 좋은 보안 관행입니다.

기본적으로 Odoo 서버는 모든 인터페이스에서 포트 8069를 수신합니다. Odoo 인스턴스에 대한 직접 액세스를 사용하지 않도록 설정하려면 모든 공개 인터페이스에 대해 포트 8069를 차단하거나 Odoo가 로컬 인터페이스에서만 수신하도록 강제할 수 있습니다.

Odoo가 127.0.1에서만 청취하도록 구성합니다. 구성을 열고 파일 끝에 다음 두 줄을 추가합니다.

# /etc/odoo13.conf

xmlrpc_interface = 127.0.0.1
netrpc_interface = 127.0.0.1

 

 

변경 사항을 적용하려면 구성 파일을 저장하고 Odu 서버를 다시 시작합니다.

sudo systemctl restart odoo13

 

 

 

다중 처리를 사용 가능으로 설정

기본적으로 Odoo는 멀티스레딩 모드에서 작업 중입니다. 프로덕션 배포의 경우 안정성을 높이고 시스템 리소스를 더 잘 사용할 수 있도록 멀티프로세싱 서버로 변경하는 것이 좋습니다.

다중 처리를 사용하려면 Odu 구성을 편집하고 0이 아닌 작업자 프로세스 수를 설정해야 합니다. 작업자 수는 시스템의 CPU 코어 수와 사용 가능한 RAM 메모리를 기준으로 계산됩니다.

작업자 수와 필요한 RAM 메모리 크기를 계산하기 위한 공식 Odu 설명서에 따르면 다음과 같은 공식과 가정을 사용할 수 있습니다.

 

 

작업자번호계산

- 이론적으로 최대 작업자 수 = (시스템_가공자 * 2) + 1입니다.

- 1명의 직원이 최대 = 6명의 동시 사용자를 서비스할 수 있습니다.

- 크론 작업자도 CPU가 필요합니다.

 

RAM 메모리 크기를 계산 

우리는 모든 요청의 20퍼센트는 무거운 요청이고 80퍼센트는 가벼운 요청이라는 것을 고려할 것입니다. 무거운 요청에는 약 1GB의 RAM이 사용되고 가벼운 요청에는 약 150MB의 RAM이 사용됩니다.

필요한 RAM = number_of_worker * (light_worker_light_worker_ram_lam_reation) + (heavy_worker_lam_readation * havy_worker_lam_readation) )

시스템에 얼마나 많은 CPU가 있는지 모를 경우 다음 grep 명령을 사용합니다.

grep -c ^processor /proc/cpuinfo

 

 

4개의 CPU 코어, 8GB의 RAM 메모리, 30명의 동시 Odu 사용자가 있는 시스템이 있다고 가정해 보겠습니다.

사용자 30명 / 6명 = **5** (5명은 이론적으로 필요한 작업자 수)

(4 * 2) + 1 = **9** (9는 이론상 최대 작업자 수)

 

위의 계산에 따르면 크론 작업자에 대해 5명의 작업자 + 1명의 작업자를 사용할 수 있으며, 총 6명의 작업자를 사용할 수 있습니다.

작업자 수를 기준으로 RAM 메모리 소비량을 계산합니다.

 RAM = 6 * ((0.8*150) + (0.2*12) ~= 2GB RAM입니다.

 

계산 결과 Odu 설치에는 약 2GB의 RAM이 필요합니다. 

다중 처리 모드로 전환하려면 구성 파일을 열고 계산된 값을 추가합니다.

# /etc/odoo13.conf

limit_memory_hard = 2684354560
limit_memory_soft = 2147483648
limit_request = 8192
limit_time_cpu = 600
limit_time_real = 1200
max_cron_threads = 1
workers = 5

 

 

변경 내용을 적용하려면 Odu 서비스를 다시 시작합니다.

sudo systemctl restart odoo13

 

 

나머지 시스템 리소스는 이 시스템에서 실행되는 다른 서비스에서 사용됩니다. 이 가이드에서 우리는 Postgre와 함께 Odu를 설치했습니다.SQL과 Nginx가 같은 서버에 있습니다. 설정에 따라 서버에서 다른 서비스가 실행 중일 수도 있습니다.

Nginx를 역 프록시로 사용하는 파이썬 가상 환경에서 Ubuntu 18.04에 Odoo 13을 설치하는 과정을 안내했습니다. 또한 프로덕션 환경에서 멀티프로세싱을 활성화하고 Odu를 최적화하는 방법도 보여드렸습니다.