이 페이지는 기계 번역되었습니다. 영어 원본을 읽어보세요. English

클라우드 및 Docker

HQbird는 자체 서버에서와 동일한 방식으로 클라우드 서버에서도 작동합니다. Docker의 경우 각 Firebird 라인별로 준비된 이미지가 있습니다. 백업은 서버 디스크에 파일을 남기지 않고 S3로 직접 전송됩니다. 센터와의 연결에는 인바운드 포트가 필요하지 않습니다.

  • 4개 이미지 Firebird 5 · 4 · 3 · 2.5
  • 1개 컨테이너 Firebird, 에이전트 및 콘솔
  • S3 디스크에 파일을 남기지 않는 백업
  • 0 센터 연결을 위한 인바운드 포트
  • 200–250 MB 유휴 인스턴스당 메모리

서버 · 컨테이너 · 스토리지

클라우드 설치의 세 가지 구성 요소

HQbird는 일반 설치 프로그램으로 클라우드 서버에 설치하거나 Docker 컨테이너에서 실행할 수 있습니다. 두 경우 모두 에이전트가 자체적으로 HQCenter에 연결하며, 백업은 S3 스토리지로 전송할 수 있습니다.

다이어그램: 애플리케이션과 브라우저가 호스트의 HQbird 컨테이너에 연결하고, 에이전트는 자체적으로 HQCenter에 연결하며 백업을 S3로 전송합니다 클라우드 서버 또는 Docker 호스트 HQbird Firebird fbagent HQ Monitor 볼륨: /db · /backup · /opt 포트: 3050 · 23050 클러스터: 7051 · 7443 · 7444 클라이언트 Firebird 포트 3050 브라우저 HQ Monitor 23050 HQCenter 에이전트가 외부로 연결 S3 백업, HTTPS
누가 누구에게 연결하는가. 애플리케이션과 브라우저는 Firebird 및 HQ Monitor 포트로 들어옵니다. 에이전트는 자체적으로 HQCenter와 S3에 연결합니다. 이를 위해 인바운드 포트는 필요하지 않습니다.
서버

일반 설치 프로그램

하나의 파일로 클라우드 서버에 Firebird, 에이전트 및 콘솔을 설치합니다. 설치 프로그램 자체는 아무것도 다운로드하지 않습니다. 서버 전체를 데이터베이스 전용으로 사용할 때 적합합니다.

컨테이너

Docker 이미지

하나의 컨테이너는 모든 HQbird 구성 요소를 갖춘 하나의 Firebird입니다. 데이터는 볼륨에 있으며 컨테이너나 이미지를 교체해도 유지됩니다.

스토리지

S3로 백업

gbak과 nbackup은 스트림에 쓰고, 스트림은 버킷으로 전송됩니다. 백업에 서버 디스크 공간이 필요하지 않습니다. 서버와 컨테이너 모두에서 작동합니다.

백업 페이지에서 더 보기 →

이미지 · 첫 시작 · compose

Docker에서의 HQbird

컨테이너는 서버와 동일한 설치 프로그램으로 HQbird를 설치합니다. Firebird, fbagent 에이전트 및 HQ Monitor가 내부에서 실행됩니다. 에이전트는 인스턴스가 클러스터에 조인할 때 클러스터 노드를 스스로 설치합니다. 이 인스턴스가 클러스터 RCM으로 지정된 경우에만 RCM을 설치합니다.

이미지는 IBSurgeon GitHub Container Registry에 있습니다. 공개되어 있으므로 레지스트리에 로그인할 필요가 없습니다. 이미지 태그는 HQbird 키트의 버전입니다.

이미지FirebirdFirebird 포트HQ 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

첫 시작

  1. 1compose.yaml키트에서 호스트의 폴더로 복사합니다
  2. 2SYSDBA 비밀번호본인만 읽을 수 있는 시크릿 파일에 넣습니다
  3. 3이미지, 이름, 시크릿image와 hostname을 설정하고 secrets: 줄에서 #을 제거합니다
  4. 4docker compose up -d컨테이너가 HQbird를 설치합니다
  5. 5✓ healthyFirebird와 콘솔이 응답합니다
mkdir -p secrets
openssl rand -hex 12 > secrets/sysdba_password
chmod 600 secrets/sysdba_password
docker compose up -d
docker compose logs -f   # 설치 진행 상황
docker compose ps        # healthy 상태가 될 때까지 대기

2코어 서버에서 첫 시작 시 설치는 약 20초 걸립니다.

제공되는 것

  • Firebird: <Docker host>:3050.
  • HQ Monitor: http://<Docker host>:23050/, 로그인 admin.
  • 설치 프로그램이 콘솔 비밀번호를 생성합니다. 이 비밀번호는 컨테이너 내부의 /opt/hqbird/conf/access.properties 파일에 있습니다.
  • HQCenter의 에이전트 이름: 호스트 이름, 설치 날짜, Firebird 라인.

일상 작업

작업명령
서비스 상태docker compose exec hqbird systemctl list-units --type=service
Firebird 재시작docker compose exec hqbird systemctl restart firebird
Firebird 3.0: firebird-superserver 서비스
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
1시간 동안의 로그docker compose logs --since 1h
중지docker compose stop: Firebird가 데이터베이스를 닫습니다

컨테이너 내부에서 systemctl 명령은 HQbird 서비스를 제어하지만 systemd는 아닙니다. HQbird 프로그램이 사용하는 명령을 이해합니다: start, stop, restart, status, list-units 등.

변수 · 시크릿 · 볼륨

설정 및 볼륨

컨테이너는 첫 시작 시에만 설정을 읽습니다. 이것이 설치입니다. 데이터, 구성, 라이선스, 업데이트된 프로그램은 볼륨에 있습니다. 컨테이너를 다시 만들거나 이미지를 변경해도 그대로 유지됩니다.

설정기능
HQBIRD_FB_PORT컨테이너 내부의 Firebird 포트, 기본값 3050. HQ Monitor는 20000 + 이 포트에서 수신합니다.
HQBIRD_HQM_PORT다른 HQ Monitor 포트.
HQBIRD_AGENT_ID에이전트 이름. 기본적으로 호스트 이름, 날짜, 포트로 만들어집니다.
HQBIRD_HQM_LOGIN, 시크릿 hqmonitor_passwordHQ Monitor 로그인 및 비밀번호.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE평가판 라이선스 요청.
시크릿 sysdba_password새 Firebird의 SYSDBA 비밀번호.
시크릿 license라이선스 파일.
시크릿 attachHQCenter의 attach.json 파일: 에이전트를 센터에 연결합니다.
볼륨경로내용
db/db데이터베이스. 데이터베이스를 여기에 두십시오.
backup/backup백업.
opt/optFirebird, 에이전트, HQ Monitor, 클러스터 노드, RCM.
state/var/lib/hqbird-container서비스, 콘솔 데이터, 에이전트 로그, 머신 ID.
trust/usr/libexec/hqbird-fbagent에이전트 업데이트의 신뢰할 수 있는 시작.
rootwork/var/lib/hqbird-fbagent업데이트용 작업 폴더.
  • 호스트 폴더는 데이터베이스와 백업에만db 및 backup 볼륨을 호스트 폴더로 대체할 수 있습니다. uid 84인 사용자에게 권한을 부여하십시오. 이것은 이미지의 firebird 사용자입니다. 나머지 네 개의 볼륨은 호스트 폴더로 대체하지 마십시오.
  • 볼륨 백업여섯 개의 볼륨을 모두 함께 저장하십시오.
  • 호스트 이름을 변경하지 마십시오라이선스는 state 볼륨의 머신 ID와 에이전트 이름에 바인딩됩니다. 새 state 볼륨은 새 설치입니다.
  • 하나의 파일로 센터에 연결attach 시크릿은 첫 시작 시 에이전트를 HQCenter에 연결합니다. 이를 위해 컨테이너에 들어갈 필요가 없습니다.

포트 게시 · 방화벽 · 두 번째 인스턴스

포트 및 여러 인스턴스

각 포트를 컨테이너 외부와 내부에서 동일한 번호로 게시하십시오: 3051:3051, 3051:3050이 아닙니다. 에이전트와 클러스터는 컨테이너 내부에서 보이는 포트를 보고합니다.

포트대상필요한 경우
HQBIRD_FB_PORT (3050)Firebird항상
20000 + Firebird 포트 (23050)HQ Monitor항상
노드 포트 (7051)클러스터 노드인스턴스가 클러스터에 참여하는 경우
7443, 7444RCM 및 웹 인터페이스이 에이전트가 RCM을 실행하는 경우, 호스트당 하나

Docker는 ufw를 우회하여 포트를 게시합니다. 확인했습니다: ufw 규칙이 "포트 22만"인 상태에서도 Firebird와 HQ Monitor 포트가 인터넷에서 열려 있었습니다. 외부 방화벽을 사용하거나, 포트를 하나의 호스트 주소에 게시하거나("10.0.0.5:23050:23050"), iptables DOCKER-USER 체인에 규칙을 추가하십시오.

같은 호스트의 두 번째 인스턴스

각 인스턴스는 자체 폴더, 프로젝트 이름, 호스트 이름, 포트가 필요합니다. 프로젝트 이름이 볼륨 이름을 결정합니다. 같은 이름을 사용하면 두 번째 시작 시 첫 번째 인스턴스의 볼륨과 컨테이너를 가져갑니다.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + Firebird 포트.
  • 클러스터 노드: 7051 + N.
  • 호스트에서 RCM을 실행할 수 있는 인스턴스는 하나뿐입니다.

같은 호스트의 다른 Firebird 라인도 동일한 규칙을 따르며, 각각 고유한 이미지를 사용합니다.

인스턴스 1인스턴스 2
프로젝트 및 호스트 이름hqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
포트3051, 23051, 70523052, 23052, 7053
  • 메모리유휴 인스턴스 하나는 약 200–250 MB를 사용합니다. 확인해 보았습니다: 2코어, 4GB 메모리 서버에서 Firebird 4.0 인스턴스 세 개를 실행했으며, 그중 하나는 부하 상태였습니다.
  • 같은 호스트에서 Docker 외부의 Firebird호스트에서 Docker 없이 Firebird 또는 HQbird가 이미 실행 중이라면 포트 3050, 23050, 7051을 건너뛰십시오.

HQCenter · 새 이미지 · 클러스터

업데이트 및 클러스터

컨테이너를 업데이트하는 방법은 두 가지입니다. 두 방법 모두 데이터를 유지합니다.

HQCenter에서

일반 서버에서와 마찬가지로, 센터가 컨테이너 내부의 에이전트, HQ Monitor, Firebird, 클러스터 노드 및 RCM을 업데이트합니다. 업데이트된 프로그램은 볼륨에 있으므로 재시작 후에도 유지됩니다.

새 이미지로

image 줄의 버전을 변경하고 다음을 실행하십시오:

docker compose pull
docker compose up -d

시작 시 컨테이너는 새 이미지의 설치 프로그램을 업데이트 모드로 실행합니다. 센터가 이미 에이전트를 이미지의 버전보다 최신 버전으로 업데이트했다면 설치 프로그램은 실행되지 않습니다: 버전이 다운그레이드되지 않습니다.

클러스터 내 컨테이너

컨테이너의 인스턴스는 서버와 동일한 방식으로 클러스터에 참여합니다. 멤버 주소는 Docker 호스트의 주소입니다. compose.yaml에서 클러스터 포트를 게시하십시오.

  • 노드 포트, 예를 들어 7051: 인스턴스가 클러스터 멤버일 때.
  • 포트 7443 및 7444: 이 에이전트가 RCM을 실행할 때. 7444의 웹 인터페이스의 경우 RCM 설정에서 operator_addr = 0.0.0.0:7444로 설정하십시오.
  • 클러스터 설명의 노드 포트는 게시된 포트와 일치해야 합니다.

에이전트는 클러스터를 저장한 후 몇 분 이내에 노드를 설치합니다. 그때까지 노드 포트는 응답하지 않습니다.

클러스터 및 복제에 대해 더 알아보기 →

클라우드 서버 · NAT · 방화벽

클라우드 서버의 HQbird

클라우드 서버에서는 일반 설치 프로그램으로 HQbird를 설치합니다: 파일 하나, 명령 하나. Firebird, 에이전트 및 콘솔이 파일 안에 포함되어 있습니다: 설치 프로그램은 아무것도 다운로드하지 않습니다. Linux에서는 배포판 저장소에서 몇 가지 OS 라이브러리(libtommath, ICU)를 가져옵니다. 저장소가 없으면 정확한 명령을 출력하고 아무것도 변경하지 않습니다.

  • 센터를 위한 인바운드 포트 없음에이전트가 자체적으로 HQCenter에 연결합니다. NAT 뒤에 있거나 프라이빗 클라우드 네트워크에 있는 서버는 센터에서 랙에 있는 서버와 동일하게 보입니다.
  • OS 방화벽설치 프로그램은 firewalld 또는 ufw에서 새 Firebird의 포트와 HQ Monitor 포트를 엽니다. 클라우드 자체의 방화벽 규칙은 직접 설정합니다.
  • 서버 요구 사항최소 2GB 메모리, 2코어, 5GB 디스크. Linux x86-64 또는 Windows.
  • Linux 배포판Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS 및 apt, dnf, yum 또는 zypper를 사용하는 기타 배포판.
  • 스크립트로 서버 100대모든 설치 단계는 스위치로 사용할 수 있습니다. 먼저 설치 계획을 볼 수 있습니다: 명령은 아무것도 변경하지 않습니다.
  • 비밀 정보 보호콘솔에 입력하는 비밀 정보는 암호화되어 에이전트로 전송됩니다. 비밀 정보는 보고서 및 구성 복사본에서 숨겨집니다. 에이전트 구성 파일에서 S3 키는 암호화되지 않습니다: 이 파일에 대한 접근을 제한하십시오. Amazon EC2 서버에서는 키 없이 작업할 수 있습니다: 에이전트가 서버의 IAM 역할을 사용합니다.
  • Grafana의 메트릭에이전트는 Firebird 및 서버 메트릭을 Prometheus 형식으로 내보냅니다.
  • 클라우드 디스크 관리에이전트는 읽기 및 쓰기 지연 시간을 측정하고 디스크가 언제 가득 찰지 예측합니다. 느리거나 거의 가득 찬 클라우드 디스크는 상태 보고서에 표시됩니다.

설치 및 업데이트에 대해 더 알아보기 →

제한 사항 · 팁

알아두면 좋은 점

  • Docker와 ufw게시된 컨테이너 포트는 ufw를 우회하여 열립니다. 외부 방화벽으로 닫거나 하나의 주소에만 게시하십시오.
  • 설정은 첫 시작 시에만변수와 비밀 정보는 한 번만 읽힙니다. Firebird 포트, 호스트 이름 및 비밀 정보는 나중에 변경할 수 없습니다: 새로 설치해야 합니다. 작업 및 기타 에이전트 설정은 HQ Monitor 또는 센터에서 변경합니다.
  • docker compose exec를 사용하는 스크립트스크립트에서는 -T 스위치와 </dev/null을 추가하십시오. 이것이 없으면 명령이 표준 입력을 읽어 스크립트의 나머지 부분을 가져갑니다.
  • 센터 연결 전 경고에이전트가 HQCenter에 연결될 때까지 로그에 연결 설정이 불완전하다고 표시됩니다. 이는 정상입니다.
  • 이미지 서명이미지는 cosign 도구로 서명됩니다. cosign verify 명령으로 확인할 공개 키는 아직 게시되지 않았습니다.
  • 테스트 환경Ubuntu 22.04, Compose가 포함된 Docker, 2코어 및 4GB 메모리 서버. Ubuntu용 단계별 설치 가이드는 러시아어와 포르투갈어로 제공됩니다.

← HQbird 2027 개요로 돌아가기