FlashPanel

Triển khai ​

Triển khai là quá trình tải mã nguồn từ nhà cung cấp Git về máy chủ của bạn và chạy kịch bản triển khai. Trang Triển khai của website gồm các phần: Kịch bản triển khai, Lịch sử triển khai, Deploy key của site, Tự động triển khai và URL triển khai.

Bảng Lịch sử triển khai cho biết thời điểm, nhánh, người thực hiện, commit, thời lượng, trạng thái và nhật ký của từng lần triển khai.

Tệp .env ​

Một số ứng dụng, chẳng hạn ứng dụng Laravel, cần tệp .env để cấu hình cơ sở dữ liệu, bộ nhớ đệm... Bạn có thể tạo và chỉnh sửa tệp này ngay trong FlashPanel.

Tại trang Tổng quan của website > phần Tiện ích > chọn .env. Tệp mở trong trình soạn thảo để bạn chỉnh sửa và lưu.

! Tự động tạo tệp .env

Khi cài kho Git chứa ứng dụng Laravel, FlashPanel tự động tạo tệp .env từ .env.example (nếu dự án không có .env.example thì tạo tệp .env trống), sau đó đặt môi trường production, tắt chế độ debug và điền thông tin kết nối cơ sở dữ liệu trên máy chủ.

Tự động triển khai ​

Tính năng Tự động triển khai giúp bạn triển khai dự án ngay khi đẩy (push) mã lên nhà cung cấp Git. Khi bạn đẩy lên nhánh triển khai đã cấu hình, FlashPanel sẽ lấy mã mới nhất và chạy kịch bản triển khai của ứng dụng.

Các bước bật tự động triển khai:

  1. Tại trang quản lý website, chọn mục Triển khai ở menu bên trái
  2. Tại phần Tự động triển khai, bấm nút Bật tự động triển khai và xác nhận

INFO

Phần Tự động triển khai chỉ hiển thị với website cài từ GitHub, GitLab hoặc Bitbucket. Với kho Git tự quản lý, hãy dùng URL triển khai.

Kịch bản triển khai ​

Các lệnh chạy trên máy chủ khi dự án được triển khai được xác định bởi kịch bản triển khai của website. Bạn có thể chỉnh sửa kịch bản tại phần Kịch bản triển khai trên trang Triển khai, sau đó bấm Cập nhật (hoặc nhấn Ctrl/⌘ + S) để lưu. Bấm biểu tượng Kịch bản tùy chỉnh ở góc khung soạn thảo để dán một kịch bản đã lưu.

FlashPanel cung cấp sẵn một số biến để bạn sử dụng, giá trị thực tế của website được hiển thị ngay phía trên khung soạn thảo:

bash
FLASHPANEL_SITE_ROOT='/đường-dẫn/đến/yoursite.com'
FLASHPANEL_SITE_OWNER='site-owner'
FLASHPANEL_CODE_BRANCH='siteBranch'
FLASHPANEL_PHP='your-phpVersion'
FLASHPANEL_PHP_FPM='your-phpVersion-fpm'

Kịch bản triển khai mặc định của website cài từ Git có dạng:

bash
cd $FLASHPANEL_SITE_ROOT

# Checkout lock file
if [ -f composer.lock ]; then
  git checkout composer.lock
fi

if [ -f package-lock.json ]; then
  git checkout package-lock.json
fi

git pull origin $FLASHPANEL_CODE_BRANCH

# Install Composer
# $FLASHPANEL_PHP /usr/local/bin/composer install --no-dev --optimize-autoloader --no-ansi

# echo 'Restarting FPM...';
# sudo -S service $FLASHPANEL_PHP_FPM reload

Bỏ dấu # ở đầu các dòng lệnh bạn muốn chạy.

Phiên bản PHP ​

Nếu bạn đã cài đặt nhiều phiên bản PHP trên máy chủ, kịch bản triển khai có thể cần được cập nhật để dùng đúng phiên bản PHP.

Mặc định, php luôn trỏ đến phiên bản PHP đang được dùng cho dòng lệnh (CLI). Nếu cần dùng phiên bản PHP khác, hãy gọi phpx.x, trong đó x.x là phiên bản tương ứng (ví dụ: php8.3).

Kịch bản triển khai của các website mới tạo dùng biến môi trường $FLASHPANEL_PHP. Biến môi trường này luôn chứa phiên bản PHP hiện tại của website, vì vậy bạn không cần sửa kịch bản triển khai khi đổi phiên bản PHP của website.

Các biến môi trường ​

FlashPanel sẽ tự động đưa các biến môi trường sau vào kịch bản triển khai khi chạy:

BiếnMô tả
FLASHPANEL_SITE_ROOTThư mục gốc của website, ví dụ: /home/flashpanel/mysite.com
FLASHPANEL_SITE_OWNERNgười dùng Linux sở hữu website.
FLASHPANEL_CODE_BRANCHTên nhánh sẽ được triển khai.
FLASHPANEL_PHPLệnh PHP ứng với phiên bản website đang dùng (ví dụ: php8.3).
FLASHPANEL_PHP_FPMTên dịch vụ PHP-FPM của website (ví dụ: php8.3-fpm).
FLASHPANEL_PNPMĐường dẫn đến lệnh pnpm của người dùng sở hữu website.

WARNING

Biến môi trường

FlashPanel đặt tiền tố FLASHPANEL_ cho mọi biến được đưa vào. Vui lòng không dùng tiền tố này khi định nghĩa biến môi trường của riêng bạn.

Triển khai từ CI ​

Ngoài việc triển khai từ giao diện FlashPanel hoặc dùng tính năng Tự động triển khai, bạn cũng có thể triển khai từ nền tảng CI mà bạn chọn bằng URL triển khai.

  1. Tại trang Triển khai > phần URL triển khai
  2. Bấm Làm mới URL triển khai và xác nhận để tạo URL mới, sau đó sao chép URL

INFO

Tính năng làm mới URL triển khai chỉ dành cho người dùng trả phí.

Sử dụng URL triển khai ​

Bạn có thể triển khai bất kỳ lúc nào bằng cách cấu hình nền tảng CI gửi yêu cầu GET hoặc POST tới URL triển khai.

Bạn có thể làm mới URL bất kỳ lúc nào, nhưng sau đó cần cập nhật URL mới cho mọi dịch vụ đang dùng URL cũ.

Nhánh triển khai ​

Bạn có thể đổi nhánh được triển khai cho website. Sau khi đổi nhánh, bạn cần bấm Triển khai ngay để triển khai mã từ nhánh mới.

Các bước cập nhật nhánh triển khai:

  1. Tại trang quản lý website > chọn mục Cài đặt > phần Cập nhật nhánh Git
  2. Chọn hoặc nhập tên nhánh mới
  3. Bấm Cập nhật

Các bước triển khai thủ công:

  1. Tại trang quản lý website > chọn mục Triển khai
  2. Bấm Triển khai ngay ở góc trên phần Kịch bản triển khai

Git Remote ​

Cập nhật Git Remote sẽ đổi URL kho Git trên máy chủ; website không bị xóa hay gián đoạn trong quá trình này. Git Remote mới phải chứa cùng kho lưu trữ/lịch sử Git với kho đang được cài.

Bạn không nên dùng chức năng này để cài một dự án hoàn toàn khác. Nếu muốn cài dự án khác, hãy gỡ hoàn toàn mã nguồn hiện có bằng chức năng Xóa code.

Các bước cập nhật Git Remote:

  1. Tại trang quản lý website > chọn mục Cài đặt > phần Cập nhật Git Remote
  2. Thay đổi nhà cung cấp, tài khoản Git hoặc địa chỉ kho lưu trữ. Xem chi tiết tại Cài đặt website.
  3. Bấm Cập nhật

Các bước xóa code:

  1. Tại trang Tổng quan của website > phần Khu vực nguy hiểm > chọn Xóa code
  2. (Tùy chọn) Đánh dấu Xóa cơ sở dữ liệu, Xóa người dùng cơ sở dữ liệu (chỉ hiển thị khi website có cơ sở dữ liệu đi kèm) và Khôi phục về trang mặc định?
  3. Đánh dấu Đúng, làm đi! rồi bấm Xóa code