PS: 所有操作都在 ~ 路徑下

EC2

選用 Ubuntu 20.04 LTS (預設 Python版本為 3.8.10)
執行金鑰一定要選，不然會連不進去
安全群組的傳入傳出, 需要設定允許 22, 80, 443, 587, 993, 3306 等常用 port , 如果有特殊情況, 再加上其他的 port

EC2 建立後

更新 sshd 設定, 方便後續可以使用帳號密碼連入 EC2, 而不用每次都需要透過金鑰對才能連入

使用初始化實體時設定金鑰對連入 EC2
執行 sudo vim /etc/ssh/sshd_config
PermitRootLogin 設定為 yes
PasswordAuthentication 設定為 yes
執行 sudo service sshd restart
執行 sudo passwd user, 更新 user 密碼

檢查可否透過 python 直接呼叫到 python, 如果不行

source ~/.bashrc
新增 alias python=python3
source ~/.bashrc

安裝 python 3.8 venv

sudo apt install python3.8-venv

安裝 pip

sudo apt-get install python3-pip

安裝 mariadb

sudo apt-get install software-properties-common
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://ftp.ubuntu-tw.org/mirror/mariadb/repo/10.3/ubuntu xenial main'
sudo apt-get update
sudo apt-get install mariadb-server-10.3

安裝 mysql-client

sudo apt-get install libmysqlclient-dev
更新 /etc/mysql/maraidb.conf.d/50-server.cnf

# Add Below
[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4

安裝 node.js V16

curl -s https://deb.nodesource.com/setup_16.x | sudo bash
sudo apt-get install -y nodejs
sudo npm install -g yarn

安裝 Redis

sudo apt-get install redis-server

完成上述步驟後, 重新啟動 EC2

RDS

新增 Mariadb 參數群組 > character_set_server = utf8mb4 > collation_server = utf8mb4_unicode_ci
主要使用者名稱設定為 root
儲存體選一般用途 SSD(gp2), 容量 100G (依照實際調整)
停用自動擴展
不要建立備用執行個體（啟用的話費用很貴）
關閉績效監控
資料庫選項中的資料庫參數群組選擇 1. 建立的參數群組
啟用自動備份
停用加密（依實際情況調整）
停用自動次要版本升級
停用刪除保護

Frappe & ERPNext

安裝 bench

pip install frappe-bench
bench --version

初始化 frappe bench

bench init ./frappe-bench --frappe-path https://github.com/frappe/frappe --frappe-branch version-13 --python python3

安裝自定義的 erpnext

因為 erpnext 會一直更新，尤其是每更新到一個大版本，對 Python 的最低版本要求就會變高，為了方便開發，因此有 clone 一版 13.36.2 的版本出來，後續如果有一些自定義的功能，也會直接更新這個部分

bench get-app erpnext https://gitlab.com/go-right-team/erpnext.git

安裝其他自定義的 app

初始化站點

更新 common_site_config.json

{
    # ... other settings
    "db_host": "rds endpoint",
    "db_port": 3306,
    "gunicorn_workers": 4 # 預設是 1, 依實際需求調整
}

bench new-site <site_name>

以生產模式部署

sudo bench setup production

如果設置時發生錯誤, 例如 Jinja 版本的要求等
參考以下步驟, 手動設置生產環境

pip install ansible==5.4.0 ansible-core==2.12.2 jinja2==2.10.3
sudo apt-get install supervisor nginx
bench setup supervisor
bench setup nginx
sudo ln -s /home/amadeus/frappe-bench/config/supervisor.conf /etc/supervisor/conf.d/frappe-bench.conf
sudo ln -s /home/amadeus/frappe-bench/config/nginx.conf /etc/nginx/conf.d/frappe-bench.conf
sudo shutdown -r now

如果發生 sudo: bench: command not found 的錯誤
可以執行
sudo pip3 install frappe-bench
然後再執行一次 sudo bench setup production

SSL 設定

開啟多 DNS 模式

bench config dns_multitenant on

安裝 snap 相關檔案

sudo apt install snapd
sudo snap install core
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot

sudo -H bench setup lets-encrypt <site>

其他

PDF 中文無法正常顯示的處理方式

sudo apt-get install xfonts-intl-chinese fonts-wqy-zenhei fonts-arphic-ukai fonts-arphic-uming

清除 Background Jobs

bench purge-jobs

生產環境增加 Workers

supervisor.conf 增加 Queue Worker 的設定
在最下方會有個

[group:frappe-bench-workers]
programs=frappe-bench-frappe-schedule,...

新增的 worker queue name 需要放在這後面，這樣之後 bench restart 時才會一起重啟這些 queue

執行下列程式，更新 supervisor 的設定並且進行更新

sudo supervisorctl reread
sudo supervisorctl update

至 sites/common_site_config.json 中新增

"workers": {
    "<new_worker_name>": {
        "timeoute": <timeout>
    }
}

bench restart

啟用排程作業

bench --site sitename enable-scheduler

Frappe 的標準列印格式

未設定 print_hide = 0 且有值, 不是 Section Break, Column Break 或 Button 的欄位，都會依照欄位的順序出現在標準列印中

EC2