Cài đặt

Các bước này giả sử bạn muốn cài đặt Bench ở chế độ nhà phát triển.

Nếu bạn muốn cài đặt ở chế độ sản xuất, hãy làm theo các phương pháp cài đặt được đề xuất mới nhất .

Yêu cầu hệ thống

Hướng dẫn này giả định rằng bạn đang sử dụng máy tính cá nhân, VPS hoặc máy chủ cơ bản. Bạn cũng cần phải sử dụng hệ thống *nix để mọi bản phân phối Linux và MacOS đều được hỗ trợ. Tuy nhiên, chúng tôi chính thức chỉ hỗ trợ các bản phân phối sau.

1. Hệ điều hành Mac

2. Debian / Ubuntu

Tìm hiểu thêm về kiến ​​trúc ở đây .

Điều kiện tiên quyết

Version 13:
Python 3.7 or Python 3.8
Node.js 14
MariaDB 10.3+

Version 14:
Python 3.10 or Python 3.11
Node.js 14 or 16
MariaDB 10.6.6+

Version 15/Nightly:
Python 3.10 or Python 3.11
Node.js 18
MariaDB 10.6.6+


Common for all Frappe versions:
Redis 6                                       (caching and realtime updates)
yarn 1.12+                                    (js dependency manager)
pip 20+                                       (py dependency manager)
wkhtmltopdf (version 0.12.5 with patched qt)  (for pdf generation)
cron                                          (bench's scheduled jobs: automated certificate renewal, scheduled backups)
NGINX                                         (proxying multitenant sites in production)

Hệ điều hành Mac

Cài đặt phiên bản dòng lệnh của công cụ Xcode.

xcode-select --install

Cài đặt Homebrew . Nó giúp dễ dàng cài đặt các gói trên macOS.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Bây giờ, bạn có thể dễ dàng cài đặt các gói cần thiết bằng cách chạy lệnh sau

brew install [email protected] git redis [email protected] node@14
brew install --cask wkhtmltopdf

Bây giờ, hãy chỉnh sửa tệp cấu hình MariaDB.

nano /usr/local/etc/my.cnf

Đối với Apple silicon, đường dẫn cho cấu hình MariaDB là

nano /opt/homebrew/etc/my.cnf

Và thêm cấu hình này

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
bind-address = 127.0.0.1

[mysql]
default-character-set = utf8mb4

Bây giờ, chỉ cần khởi động lại dịch vụ mysql và bạn đã sẵn sàng.

brew services restart mariadb

Cài đặt Yarn

Cài đặt Yarn bằng npm

npm install -g yarn

Debian / Ubuntu

Cài đặt git, python, vàredis

sudo apt install git python-dev python-pip redis-server

Cài đặt MariaDB

sudo apt install software-properties-common

Nếu bạn đang dùng phiên bản Ubuntu cũ hơn 20.04, hãy chạy phiên bản này trước khi cài đặt MariaDB:

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'

Nếu bạn đang dùng phiên bản Ubuntu 20.04 thì MariaDB có sẵn trong kho lưu trữ mặc định và bạn có thể chạy trực tiếp các lệnh bên dưới để cài đặt nó:

sudo apt-get update
sudo apt-get install mariadb-server

Trong quá trình cài đặt này, bạn sẽ được nhắc đặt mật khẩu root MySQL. Nếu không được nhắc, bạn sẽ phải tự mình khởi tạo thiết lập máy chủ MySQL. Bạn có thể làm điều đó bằng cách chạy lệnh:

mysql_secure_installation

Hãy nhớ: chỉ chạy nó nếu bạn không được nhắc nhập mật khẩu trong quá trình thiết lập.

Điều thực sự quan trọng là bạn phải nhớ mật khẩu này vì nó sẽ hữu ích sau này. Bạn cũng sẽ cần các tệp phát triển cơ sở dữ liệu MySQL.

apt-get install mariadb-client-10.3

Bây giờ, hãy chỉnh sửa tệp cấu hình MariaDB.

nano /etc/mysql/my.cnf

Và thêm cấu hình này

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

[mysql]
default-character-set = utf8mb4

Bây giờ, chỉ cần khởi động lại dịch vụ mysql và bạn đã sẵn sàng.

service mysql restart

Cài đặt Node

Chúng tôi khuyên bạn nên cài đặt Node bằng nvm

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

Sau khi nvm được cài đặt, bạn có thể phải đóng terminal của mình và mở một terminal khác. Bây giờ hãy chạy lệnh sau để cài đặt node.

nvm install 14

Xác minh cài đặt bằng cách chạy:

node -v
# output
v14.17.2

Cuối cùng, cài đặt yarnbằng cách sử dụngnpm

npm install -g yarn

Cài đặt wkhtmltopdf

apt-get install xvfb libfontconfig wkhtmltopdf

Cài đặt Bench CLI

Cài đặt bench qua pip3

pip3 install frappe-bench

Xác nhận cài đặt bench bằng cách kiểm tra phiên bản

bench --version

# output
5.2.1

Tạo thư mục bench đầu tiên của bạn.

cd ~
bench init frappe-bench

Sau khi thư mục frappe-bench được tạo, hãy thay đổi thư mục của bạn thành thư mục đó và chạy lệnh này

bench start

Xin chúc mừng, bạn đã cài đặt bench vào hệ thống của mình.