Bản portable

Chạy HolyArrs như một chương trình thông thường trên Linux hoặc Windows, không cần Docker. Docker vẫn là cách chạy chính.

Chú ý

Hiện chưa ai phát hành các tệp nén portable, và chúng chưa được ký. Bạn tự dựng chúng từ mã nguồn.

Trước khi bắt đầu

• Python 3, Git và Docker trên máy dựng.
• Một cache module Go đã có sẵn từ lần dựng dự án bình thường, và các phụ thuộc frontend đã cài từ app/frontend/package-lock.json.
• Ứng dụng web đã dựng và đã commit. Bản dựng chỉ dùng mã nguồn đã commit; các chỉnh sửa chưa commit bị bỏ qua.

Dựng và chạy

1. Từ thư mục checkout, dựng các tệp nén:

   python deploy/release/package.py --ref HEAD --version 1.0.0 --output /srv/holyarrs-archives/1.0.0 --web-node-modules app/frontend/node_modules --module-cache /home/you/go/pkg/mod

   Dùng một thư mục đầu ra mới nằm ngoài thư mục checkout. Bạn sẽ thấy một tệp nén cho mỗi nền tảng đích và một tệp SHA256SUMS.

2. Kiểm tra tệp nén với SHA256SUMS.

3. Giải nén vào một thư mục mới. Giữ chương trình và cấu hình ở các thư mục riêng.

4. Khởi động với đường dẫn cấu hình của bạn:

   ./holyarrs -config /srv/holyarrs/config -addr :6262

   Trên Windows PowerShell:

   .\holyarrs.exe -config 'C:\HolyArrs\config' -addr ':6262'

5. Mở http://your-server:6262. Bạn sẽ thấy trình hướng dẫn lần chạy đầu tiên. Hãy tạo tài khoản chủ sở hữu ngay; người truy cập đầu tiên trở thành chủ sở hữu.

Lựa chọn

Người dùng nào chạy nó

Chạy HolyArrs dưới một tài khoản riêng, chỉ có quyền ghi vào thư mục cấu hình và media của bạn.

• Chạy với quyền root bên ngoài container, không có PUID và PGID, nó dừng với thông báo “started as root outside a container”.
• Khi có PUID và PGID, nó giao thư mục cấu hình cho người dùng đó và chuyển sang người dùng đó.
• Trên Windows, bảo vệ thư mục cấu hình bằng một quyền NTFS cho tài khoản đó.

Khởi động lại và giới hạn

Tệp nén không cài dịch vụ nào. Hãy thiết lập tự khởi động lại và giới hạn bộ nhớ cứng trong trình quản lý dịch vụ của bạn (systemd, NSSM, Task Scheduler). Khởi động lại từ ứng dụng và khôi phục bản sao lưu đều thoát chương trình và trông chờ nó được khởi động lại.

Cập nhật và quay lại

1. Kiểm tra tệp nén mới trước khi dừng ứng dụng.
2. Dừng HolyArrs và sao chép toàn bộ thư mục cấu hình, gồm cả khóa chính. Hoặc tạo một bản sao lưu trong ứng dụng và giữ khóa của nó riêng.
3. Giải nén chương trình mới vào một thư mục khác. Giữ chương trình cũ và bản sao cấu hình cũ.
4. Khởi động chương trình mới trên cấu hình của bạn. Bạn sẽ đăng nhập được, và /health sẽ hiện running.

Nguy hiểm

Không bao giờ cho một chương trình cũ chạy trên các cơ sở dữ liệu mà một chương trình mới hơn đã thay đổi. Để quay lại, lưu cấu hình mới trước, rồi khởi động chương trình cũ trên bản sao cấu hình cũ tương ứng của nó.

Xem Sao lưu.

Nếu không hoạt động

Triệu chứng	Nguyên nhân	Cách khắc phục
“started as root outside a container”	Khởi động bằng quyền root	Chạy nó bằng một người dùng riêng, hoặc đặt PUID và PGID.
Ứng dụng thoát sau khi khôi phục	Việc khôi phục chuẩn bị dữ liệu rồi thoát với mã 75	Khởi động lại để áp dụng. Đặt trình quản lý dịch vụ tự khởi động lại nó.
Các lệnh gọi HTTPS lỗi trên Linux	Không có chứng chỉ CA của hệ thống	Cài chúng.
Bản dựng báo thư mục đầu ra đã tồn tại	Thư mục đầu ra đã có sẽ bị từ chối	Chọn một thư mục mới.

Dành cho người dùng nâng cao

Các tùy chọn dựng

Tùy chọn	Tác dụng	Mặc định
--targets	Tập con cần dựng, phân tách bằng dấu phẩy	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Mỗi container dựng có 1 CPU, 2 GiB và 256 tiến trình; Go dựng từng gói một. Việc đóng gói vẫn chạy trên máy chủ, ngoài các giới hạn đó.	tắt

Bản dựng chạy trong image Go builder đã ghim của dự án với mạng tắt, nên nó không tải gì xuống. Cache module được mount ở chế độ chỉ đọc. Nếu bất kỳ nền tảng đích nào lỗi, không để lại thư mục đầu ra nào. Commit được thêm vào số phiên bản và dựng vào chương trình; ứng dụng và các bản sao lưu của nó báo lại commit đó.

Một tệp nén chứa gì

Chương trình, giấy phép, thông báo của bên thứ ba, các hướng dẫn, một bản kê nguồn và danh tính gói. Một tệp nén mã nguồn riêng chứa mã nguồn dự án và các phụ thuộc Go; hãy giữ nó cạnh các tệp thực thi.

SHA256SUMS chứng minh các tệp khớp nhau. Nó không phải chữ ký. Cùng commit, phiên bản và đầu vào cho ra cùng các tệp nén, nên bạn có thể dựng lại để kiểm tra.

Ghi chú khi chạy

Chủ đề	Chi tiết
Đường dẫn cấu hình	Mặc định /config. Luôn truyền -config, trên ổ đĩa cục bộ.
Mục tiêu bộ nhớ	384 MiB khi không có GOMEMLIMIT. Đặt nó bằng khoảng 80 phần trăm bộ nhớ bạn cấp. Là một mục tiêu, không phải giới hạn cứng.
Chế độ ít bộ nhớ	Trên Linux, tự bật ở khoảng 2.5 GiB hoặc ít hơn; mục tiêu giảm còn một phần tư bộ nhớ, trong khoảng 192 đến 384 MiB. HOLYARRS_LOW_MEMORY=1 hoặc 0 quyết định.
Node	Không cần để chạy.
Hardlink	Giữ các thư mục tải xuống và Thư viện trên một hệ thống tệp.

Liên quan

• Cài đặt
• Các phần và chế độ an toàn
• Cập nhật