클라우드 및 Docker
클라우드 및 Docker
HQbird는 자체 서버에서와 동일한 방식으로 클라우드 서버에서도 작동합니다. Docker의 경우 각 Firebird 라인별로 준비된 이미지가 있습니다. 백업은 서버 디스크에 파일을 남기지 않고 S3로 직접 전송됩니다. 센터와의 연결에는 인바운드 포트가 필요하지 않습니다.
- 4개 이미지 Firebird 5 · 4 · 3 · 2.5
- 1개 컨테이너 Firebird, 에이전트 및 콘솔
- S3 디스크에 파일을 남기지 않는 백업
- 0 센터 연결을 위한 인바운드 포트
- 200–250 MB 유휴 인스턴스당 메모리
서버 · 컨테이너 · 스토리지
클라우드 설치의 세 가지 구성 요소
HQbird는 일반 설치 프로그램으로 클라우드 서버에 설치하거나 Docker 컨테이너에서 실행할 수 있습니다. 두 경우 모두 에이전트가 자체적으로 HQCenter에 연결하며, 백업은 S3 스토리지로 전송할 수 있습니다.
일반 설치 프로그램
하나의 파일로 클라우드 서버에 Firebird, 에이전트 및 콘솔을 설치합니다. 설치 프로그램 자체는 아무것도 다운로드하지 않습니다. 서버 전체를 데이터베이스 전용으로 사용할 때 적합합니다.
Docker 이미지
하나의 컨테이너는 모든 HQbird 구성 요소를 갖춘 하나의 Firebird입니다. 데이터는 볼륨에 있으며 컨테이너나 이미지를 교체해도 유지됩니다.
S3로 백업
gbak과 nbackup은 스트림에 쓰고, 스트림은 버킷으로 전송됩니다. 백업에 서버 디스크 공간이 필요하지 않습니다. 서버와 컨테이너 모두에서 작동합니다.
이미지 · 첫 시작 · compose
Docker에서의 HQbird
컨테이너는 서버와 동일한 설치 프로그램으로 HQbird를 설치합니다. Firebird, fbagent 에이전트 및 HQ Monitor가 내부에서 실행됩니다. 에이전트는 인스턴스가 클러스터에 조인할 때 클러스터 노드를 스스로 설치합니다. 이 인스턴스가 클러스터 RCM으로 지정된 경우에만 RCM을 설치합니다.
이미지는 IBSurgeon GitHub Container Registry에 있습니다. 공개되어 있으므로 레지스트리에 로그인할 필요가 없습니다. 이미지 태그는 HQbird 키트의 버전입니다.
| 이미지 | Firebird | Firebird 포트 | HQ Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
첫 시작
- 1compose.yaml키트에서 호스트의 폴더로 복사합니다
- 2SYSDBA 비밀번호본인만 읽을 수 있는 시크릿 파일에 넣습니다
- 3이미지, 이름, 시크릿
image와hostname을 설정하고secrets:줄에서#을 제거합니다 - 4docker compose up -d컨테이너가 HQbird를 설치합니다
- 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 firebirdFirebird 3.0: firebird-superserver 서비스 |
| isql | docker 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_password | HQ Monitor 로그인 및 비밀번호. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | 평가판 라이선스 요청. |
시크릿 sysdba_password | 새 Firebird의 SYSDBA 비밀번호. |
시크릿 license | 라이선스 파일. |
시크릿 attach | HQCenter의 attach.json 파일: 에이전트를 센터에 연결합니다. |
| 볼륨 | 경로 | 내용 |
|---|---|---|
db | /db | 데이터베이스. 데이터베이스를 여기에 두십시오. |
backup | /backup | 백업. |
opt | /opt | Firebird, 에이전트, 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, 7444 | RCM 및 웹 인터페이스 | 이 에이전트가 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-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| 포트 | 3051, 23051, 7052 | 3052, 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용 단계별 설치 가이드는 러시아어와 포르투갈어로 제공됩니다.