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. Nút Triển khai ngay nằm ở góc trên bên phải trang Triển khai, cạnh tóm tắt lần triển khai gần nhất (nhánh, commit, trạng thái, thời gian). Trang gồm các phần:

Nguồn & cách triển khai: bên trái là Mã nguồn (nhà cung cấp Git, kho mã, nhánh đang triển khai, link Đổi nhánh và mục Deploy key của site thu gọn); bên phải là Tự động triển khai với công tắc Push to deploy và URL triển khai.
Lịch sử triển khai
Kịch bản triển khai

Website không cài từ Git (ví dụ WordPress) vẫn triển khai được: bấm Triển khai ngay hoặc dùng URL triển khai để chạy kịch bản triển khai của bạn.

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 và trạng thái của từng lần triển khai. Bấm vào một dòng để mở nhật ký của lần triển khai đó; sau khi bấm Triển khai ngay, dòng của lần triển khai mới tự mở ra. Để bảo mật, nhật ký được xoá sau 7 ngày, phần còn lại của lịch sử được giữ 3 tháng.

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:

Tại trang quản lý website, chọn mục Triển khai ở menu bên trái
Tại phần Nguồn & cách triển khai > Tự động triển khai, bật công tắc Push to deploy. Tắt công tắc để ngừng tự động triển khai

INFO

Công tắc Push to deploy chỉ có với website cài từ GitHub, GitLab hoặc Bitbucket và dành cho người dùng trả phí. 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 Lưu (hoặc nhấn Ctrl/⌘ + S). Khi có thay đổi chưa lưu, tiêu đề phần hiện nhãn Chưa lưu; bấm Huỷ thay đổi để quay về kịch bản đã 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.

Khi kịch bản còn thay đổi chưa lưu, nút Triển khai ngay đổi thành Lưu & triển khai: kịch bản được lưu trước rồi mới triển khai.

FlashPanel cung cấp sẵn một số biến để bạn sử dụng, bấm nút Biến ở góc phải phần Kịch bản triển khai để xem giá trị thực tế của website và sao chép tên biến:

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.

Giới hạn kết quả

Chỉ 50 KB đầu tiên của kết quả triển khai được giữ lại. Dùng tuỳ chọn chạy im lặng hoặc > /dev/null để chỉ in những gì bạn cần, xem Giới hạn kết quả.

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ến	Mô tả
`FLASHPANEL_SITE_ROOT`	Thư mục gốc của website, ví dụ: `/home/flashpanel/mysite.com`
`FLASHPANEL_SITE_OWNER`	Người dùng Linux sở hữu website.
`FLASHPANEL_CODE_BRANCH`	Tên nhánh sẽ được triển khai.
`FLASHPANEL_PHP`	Lệnh PHP ứng với phiên bản website đang dùng (ví dụ: `php8.3`).
`FLASHPANEL_PHP_FPM`	Tê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.

Tại trang Triển khai > phần Nguồn & cách triển khai > URL triển khai
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

WARNING

URL chỉ hiển thị một lần ngay sau khi làm mới. Hãy sao chép và lưu lại ở nơi an toàn; nếu làm mất, bạn cần làm mới để tạo URL khác.

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:

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

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

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

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:

Tại trang quản lý website > chọn mục Cài đặt > phần Cập nhật Git Remote
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.
Bấm Cập nhật

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

Tại trang Tổng quan của website > phần Khu vực nguy hiểm > chọn Xóa code
(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?
Đánh dấu Đúng, làm đi! rồi bấm Xóa code

Triển khai ​

Tệp .env ​

Tự động triển khai ​

Kịch bản triển khai ​

Phiên bản PHP ​

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

Triển khai từ CI ​

Sử dụng URL triển khai ​

Nhánh triển khai ​

Git Remote ​