Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh. English

Cloud và Docker

HQbird hoạt động trên máy chủ cloud giống như trên máy chủ của bạn. Với Docker, có sẵn một image cho mỗi dòng Firebird. Bản sao lưu đi thẳng tới S3, không có tệp nào trên đĩa máy chủ. Kết nối tới center không cần cổng vào.

  • 4 image Firebird 5 · 4 · 3 · 2.5
  • 1 container Firebird, agent và console
  • S3 sao lưu không có tệp trên đĩa
  • 0 cổng vào cho kết nối tới center
  • 200–250 MB bộ nhớ cho mỗi instance nhàn rỗi

Máy chủ · container · lưu trữ

Ba phần của một cài đặt cloud

Bạn có thể cài HQbird trên máy chủ cloud bằng bộ cài thông thường hoặc chạy nó trong container Docker. Trong cả hai trường hợp, agent tự kết nối tới HQCenter, và bản sao lưu có thể đi tới lưu trữ S3.

Diagram: applications and the browser connect to the HQbird container on the host; the agent connects to HQCenter on its own and sends backups to S3 cloud server or Docker host HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt ports: 3050 · 23050 cluster: 7051 · 7443 · 7444 Clients Firebird port 3050 Browser HQ Monitor 23050 HQCenter agent connects out S3 backups, HTTPS
Ai kết nối tới ai. Ứng dụng và trình duyệt đi vào qua các cổng Firebird và HQ Monitor. Agent tự kết nối tới HQCenter và S3: không cần cổng vào cho việc này.
Máy chủ

Bộ cài thông thường

Một tệp cài đặt Firebird, agent và console trên máy chủ cloud. Bản thân bộ cài không tải gì xuống. Phù hợp khi toàn bộ máy chủ dành cho cơ sở dữ liệu.

Container

Image Docker

Một container là một Firebird với tất cả các thành phần HQbird. Dữ liệu nằm trên volume và vẫn còn khi bạn thay container hoặc image.

Lưu trữ

Sao lưu tới S3

gbak và nbackup ghi vào một luồng, và luồng đó đi tới một bucket. Bản sao lưu không cần dung lượng trên đĩa máy chủ. Nó hoạt động cả trên máy chủ và trong container.

Thêm về trang sao lưu →

Image · lần khởi động đầu · compose

HQbird trong Docker

Container cài HQbird bằng cùng bộ cài như trên máy chủ. Firebird, agent fbagent và HQ Monitor chạy bên trong. Agent tự cài node cluster khi instance tham gia một cluster. Nó chỉ cài RCM khi instance này được chỉ định làm RCM của cluster.

Các image nằm trong IBSurgeon GitHub Container Registry. Chúng là công khai: bạn không cần đăng nhập vào registry. Thẻ image là phiên bản của bộ kit HQbird.

ImageFirebirdCổng FirebirdHQ Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050

Lần khởi động đầu

  1. 1compose.yamlsao chép nó từ bộ kit vào một thư mục trên máy chủ
  2. 2Mật khẩu SYSDBAvào một tệp secret mà chỉ bạn có thể đọc
  3. 3Image, tên, secretđặt image và hostname, bỏ # khỏi các dòng secrets:
  4. 4docker compose up -dcontainer cài HQbird
  5. 5✓ healthyFirebird và console phản hồi
mkdir -p secrets
openssl rand -hex 12 > secrets/sysdba_password
chmod 600 secrets/sysdba_password
docker compose up -d
docker compose logs -f   # installation progress
docker compose ps        # wait for healthy

Trên máy chủ 2 lõi, quá trình cài đặt ở lần khởi động đầu mất khoảng 20 giây.

Những gì bạn nhận được

  • Firebird: <Docker host>:3050.
  • HQ Monitor: http://<Docker host>:23050/, đăng nhập admin.
  • Bộ cài tạo mật khẩu console. Nó nằm trong tệp /opt/hqbird/conf/access.properties bên trong container.
  • Tên agent trong HQCenter: tên máy chủ, ngày cài đặt và dòng Firebird.

Công việc hằng ngày

Tác vụLệnh
Trạng thái dịch vụdocker compose exec hqbird systemctl list-units --type=service
Khởi động lại Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0: dịch vụ firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Log trong một giờdocker compose logs --since 1h
Dừngdocker compose stop: Firebird đóng các cơ sở dữ liệu

Bên trong container, lệnh systemctl điều khiển các dịch vụ HQbird, nhưng nó không phải systemd. Nó hiểu các lệnh mà các chương trình HQbird dùng: start, stop, restart, status, list-units và các lệnh khác.

Biến · secret · volume

Cài đặt và volume

Container chỉ đọc các cài đặt một lần, ở lần khởi động đầu: đây là quá trình cài đặt. Dữ liệu, cấu hình, giấy phép và các chương trình đã cập nhật nằm trên volume. Chúng vẫn còn khi bạn tạo lại container hoặc thay đổi image.

Cài đặtChức năng
HQBIRD_FB_PORTCổng Firebird bên trong container, mặc định là 3050. HQ Monitor lắng nghe trên 20000 + cổng này.
HQBIRD_HQM_PORTMột cổng HQ Monitor khác.
HQBIRD_AGENT_IDTên agent. Mặc định nó được tạo từ tên máy chủ, ngày và cổng.
HQBIRD_HQM_LOGIN, secret hqmonitor_passwordĐăng nhập và mật khẩu HQ Monitor.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEYêu cầu giấy phép dùng thử.
secret sysdba_passwordMật khẩu SYSDBA của Firebird mới.
secret licenseTệp giấy phép.
secret attachTệp attach.json từ HQCenter: nó kết nối agent với center của bạn.
VolumeĐường dẫnNội dung
db/dbCơ sở dữ liệu. Đặt cơ sở dữ liệu của bạn ở đây.
backup/backupCác bản sao lưu.
opt/optFirebird, agent, HQ Monitor, nút cluster, RCM.
state/var/lib/hqbird-containerDịch vụ, dữ liệu console, nhật ký agent, machine ID.
trust/usr/libexec/hqbird-fbagentKhởi động tin cậy cho các bản cập nhật agent.
rootwork/var/lib/hqbird-fbagentThư mục làm việc cho các bản cập nhật.
  • Chỉ dùng thư mục host cho cơ sở dữ liệu và bản sao lưuBạn có thể thay thế các volume db và backup bằng thư mục host. Cấp chúng cho người dùng có uid 84: đây là người dùng firebird trong image. Không thay thế bốn volume còn lại bằng thư mục host.
  • Sao lưu các volumeLưu tất cả sáu volume cùng nhau.
  • Không thay đổi tên hostGiấy phép được gắn với machine ID trên volume state và với tên agent. Một volume state mới là một cài đặt mới.
  • Kết nối tới center bằng một tệpSecret attach kết nối agent với HQCenter ở lần khởi động đầu tiên. Bạn không cần vào container để làm việc này.

Xuất bản cổng · tường lửa · phiên bản thứ hai

Cổng và nhiều phiên bản

Xuất bản mỗi cổng với cùng số ở bên ngoài và bên trong container: 3051:3051, không phải 3051:3050. Agent và cluster báo cáo cổng mà chúng thấy bên trong container.

CổngCái gìKhi nào cần
HQBIRD_FB_PORT (3050)Firebirdluôn luôn
20000 + cổng Firebird (23050)HQ Monitorluôn luôn
cổng node (7051)nút clusterphiên bản tham gia một cluster
7443, 7444RCM và giao diện web của nóagent này chạy RCM; một cái mỗi host

Docker xuất bản cổng vượt qua ufw. Chúng tôi đã kiểm tra: với quy tắc ufw "chỉ cổng 22", các cổng Firebird và HQ Monitor vẫn mở từ internet. Hãy dùng tường lửa bên ngoài, xuất bản cổng trên một địa chỉ host ("10.0.0.5:23050:23050") hoặc thêm quy tắc vào chuỗi DOCKER-USER của iptables.

Phiên bản thứ hai trên cùng một host

Mỗi phiên bản cần thư mục, tên project, tên host và cổng riêng. Tên project quyết định tên các volume. Với cùng một tên, lần khởi động thứ hai sẽ lấy các volume và container của phiên bản thứ nhất.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + cổng Firebird.
  • Nút cluster: 7051 + N.
  • Chỉ một phiên bản trên host có thể chạy RCM.

Các dòng Firebird khác trên cùng một host tuân theo cùng các quy tắc, mỗi dòng với image riêng.

Phiên bản 1Phiên bản 2
Project và tên hosthqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Cổng3051, 23051, 70523052, 23052, 7053
  • Bộ nhớMột phiên bản nhàn rỗi chiếm khoảng 200–250 MB. Chúng tôi đã kiểm tra: ba phiên bản Firebird 4.0 trên một server với 2 lõi và 4 GB bộ nhớ, một trong số đó chịu tải.
  • Firebird bên ngoài Docker trên cùng một hostNếu Firebird hoặc HQbird đã chạy trên host mà không dùng Docker, hãy bỏ qua các cổng 3050, 23050 và 7051.

HQCenter · image mới · cluster

Cập nhật và cluster

Bạn có thể cập nhật một container theo hai cách. Cả hai đều giữ lại dữ liệu.

Từ HQCenter

Như trên một server bình thường: center cập nhật agent, HQ Monitor, Firebird, nút cluster và RCM bên trong container. Các chương trình đã cập nhật nằm trên một volume, nên chúng vẫn còn sau khi khởi động lại.

Với một image mới

Thay đổi phiên bản trong dòng image và chạy:

docker compose pull
docker compose up -d

Khi khởi động, container chạy trình cài đặt của image mới ở chế độ cập nhật. Nếu center đã cập nhật agent lên phiên bản mới hơn phiên bản trong image, trình cài đặt sẽ không chạy: phiên bản không bị hạ xuống.

Container trong một cluster

Một phiên bản trong container tham gia một cluster giống như một server. Địa chỉ thành viên là địa chỉ của host Docker. Xuất bản các cổng cluster trong compose.yaml.

  • Cổng node, ví dụ 7051: khi phiên bản là thành viên cluster.
  • Cổng 7443 và 7444: khi agent này chạy RCM. Đối với giao diện web trên 7444, đặt operator_addr = 0.0.0.0:7444 trong cài đặt RCM.
  • Cổng node trong mô tả cluster phải khớp với cổng đã xuất bản.

Agent cài đặt node vài phút sau khi bạn lưu cluster. Cho đến lúc đó, cổng node không phản hồi.

Thêm về cluster và replication →

Cloud server · NAT · tường lửa

HQbird trên một cloud server

Trên một cloud server, bạn cài đặt HQbird bằng trình cài đặt thông thường: một tệp, một lệnh. Firebird, agent và console nằm trong tệp: trình cài đặt không tải xuống gì cả. Trên Linux, nó lấy một vài thư viện OS (libtommath, ICU) từ kho của bản phân phối. Nếu không có kho, nó in ra các lệnh chính xác và không thay đổi gì.

  • Không cần cổng vào cho centerAgent tự kết nối tới HQCenter. Một server sau NAT hoặc trong mạng cloud riêng trông giống hệt một server trong rack của bạn trong center.
  • Tường lửa OSTrình cài đặt mở cổng của Firebird mới và cổng HQ Monitor trong firewalld hoặc ufw. Bạn tự thiết lập các quy tắc tường lửa của chính cloud.
  • Yêu cầu serverÍt nhất 2 GB bộ nhớ, 2 lõi và 5 GB đĩa. Linux x86-64 hoặc Windows.
  • Các bản phân phối LinuxUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS và các bản khác có apt, dnf, yum hoặc zypper.
  • Một trăm server bằng scriptMỗi bước cài đặt đều có sẵn dưới dạng một tùy chọn. Bạn có thể xem kế hoạch cài đặt trước: lệnh không thay đổi gì.
  • Secret được bảo vệMột secret mà bạn nhập trong console được gửi tới agent dưới dạng mã hóa. Secret được ẩn trong báo cáo và trong các bản sao cấu hình. Trong tệp cấu hình agent, khóa S3 không được mã hóa: hãy hạn chế quyền truy cập vào tệp này. Trên một server Amazon EC2, bạn có thể làm việc mà không cần khóa: agent sử dụng IAM role của server.
  • Metrics trong Grafana của bạnAgent xuất metrics của Firebird và server ở định dạng Prometheus.
  • Kiểm soát đĩa cloudAgent đo độ trễ đọc và ghi và dự báo khi đĩa đầy. Một đĩa cloud chậm hoặc gần đầy được hiển thị trong báo cáo sức khỏe.

Thêm về cài đặt và cập nhật →

Giới hạn · mẹo

Nên biết

  • Docker và ufwMột cổng container đã xuất bản sẽ mở vượt qua ufw. Hãy đóng nó bằng tường lửa bên ngoài hoặc xuất bản nó trên một địa chỉ.
  • Cài đặt chỉ ở lần khởi động đầu tiênCác biến và secret chỉ được đọc một lần. Bạn không thể thay đổi cổng Firebird, tên host và các secret sau đó: bạn cần một cài đặt mới. Bạn thay đổi các job và các cài đặt agent khác trong HQ Monitor hoặc từ center.
  • Script với docker compose execTrong script, hãy thêm tùy chọn -T và </dev/null. Nếu không có chúng, lệnh sẽ đọc đầu vào chuẩn và lấy phần còn lại của script.
  • Cảnh báo trước khi kết nối tới centerCho đến khi agent kết nối tới HQCenter, nhật ký của nó báo rằng cài đặt kết nối chưa đầy đủ. Điều này là bình thường.
  • Chữ ký imageCác image được ký bằng công cụ cosign. Khóa công khai để kiểm tra chúng bằng lệnh cosign verify chưa được công bố.
  • Nơi đã kiểm thửUbuntu 22.04, Docker với Compose, một server với 2 lõi và 4 GB bộ nhớ. Hướng dẫn cài đặt từng bước cho Ubuntu có sẵn bằng tiếng Nga và tiếng Bồ Đào Nha.

← Quay lại tổng quan HQbird 2027