Bu sayfa makine çevirisidir. İngilizce orijinalini okuyun. English

Bulut ve Docker

HQbird, bulut sunucusunda da kendi sunucunuzdaki gibi çalışır. Docker için her Firebird sürümüne hazır bir imaj vardır. Yedeklemeler doğrudan S3'e gider, sunucu diskinde dosya kalmaz. Merkeze bağlantı için gelen bağlantı noktası gerekmez.

  • 4 imaj Firebird 5 · 4 · 3 · 2.5
  • 1 konteyner Firebird, ajan ve konsol
  • S3 diskte dosya olmadan yedekleme
  • 0 merkeze bağlantı için gelen bağlantı noktası
  • 200–250 MB boşta duran her örnek için bellek

Sunucu · konteyner · depolama

Bulut kurulumunun üç parçası

HQbird'i bir bulut sunucusuna normal yükleyiciyle kurabilir veya bir Docker konteynerinde çalıştırabilirsiniz. Her iki durumda da ajan HQCenter'a kendisi bağlanır ve yedeklemeler S3 depolamaya gidebilir.

Diyagram: uygulamalar ve tarayıcı ana bilgisayardaki HQbird konteynerine bağlanır; ajan HQCenter'a kendisi bağlanır ve yedeklemeleri S3'e gönderir bulut sunucusu veya Docker ana bilgisayarı HQbird Firebird fbagent HQ Monitor birimler: /db · /backup · /opt bağlantı noktaları: 3050 · 23050 küme: 7051 · 7443 · 7444 İstemciler Firebird bağlantı noktası 3050 Tarayıcı HQ Monitor 23050 HQCenter ajan dışarı bağlanır S3 yedeklemeler, HTTPS
Kim kime bağlanır. Uygulamalar ve tarayıcı Firebird ve HQ Monitor bağlantı noktalarından gelir. Ajan HQCenter'a ve S3'e kendisi bağlanır: bunun için gelen bağlantı noktası gerekmez.
Sunucu

Normal yükleyici

Tek bir dosya, bir bulut sunucusuna Firebird, ajanı ve konsolu kurar. Yükleyicinin kendisi hiçbir şey indirmez. Tüm sunucu veritabanı için ayrıldığında iyi bir seçimdir.

Konteyner

Docker imajı

Bir konteyner, tüm HQbird bileşenleriyle bir Firebird'dür. Veriler birimlerde bulunur ve konteyneri veya imajı değiştirdiğinizde kalır.

Depolama

S3'e yedeklemeler

gbak ve nbackup bir akışa yazar ve akış bir bucket'a gider. Yedekleme sunucu diskinde yer kaplamaz. Hem sunucuda hem de konteynerde çalışır.

Yedeklemeler sayfasında daha fazlası →

İmajlar · ilk başlatma · compose

Docker'da HQbird

Konteyner, HQbird'i bir sunucudakiyle aynı yükleyiciyle kurar. İçinde Firebird, fbagent ajanı ve HQ Monitor çalışır. Ajan, örnek bir kümeye katıldığında küme düğümünü kendisi kurar. RCM'yi yalnızca bu örnek küme RCM'si olarak atandığında kurar.

İmajlar IBSurgeon GitHub Container Registry'de bulunur. Genel erişimlidirler: kayıt defterine giriş yapmanız gerekmez. İmaj etiketi, HQbird kitinin sürümüdür.

İmajFirebirdFirebird bağlantı noktası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

İlk başlatma

  1. 1compose.yamlkitten ana bilgisayardaki bir klasöre kopyalayın
  2. 2SYSDBA parolasıyalnızca sizin okuyabildiğiniz bir gizli dosyaya
  3. 3İmaj, ad, gizli değerlerimage ve hostname ayarlayın, secrets: satırlarındaki # işaretini kaldırın
  4. 4docker compose up -dkonteyner HQbird'i kurar
  5. 5✓ healthyFirebird ve konsol yanıt verir
mkdir -p secrets
openssl rand -hex 12 > secrets/sysdba_password
chmod 600 secrets/sysdba_password
docker compose up -d
docker compose logs -f   # kurulum ilerlemesi
docker compose ps        # healthy olmasını bekleyin

2 çekirdekli bir sunucuda ilk başlatmadaki kurulum yaklaşık 20 saniye sürer.

Ne elde edersiniz

  • Firebird: <Docker host>:3050.
  • HQ Monitor: http://<Docker host>:23050/, giriş admin.
  • Yükleyici konsol parolasını oluşturur. Konteyner içindeki /opt/hqbird/conf/access.properties dosyasındadır.
  • HQCenter'daki ajan adı: ana bilgisayar adı, kurulum tarihi ve Firebird sürümü.

Günlük işler

GörevKomut
Hizmet durumudocker compose exec hqbird systemctl list-units --type=service
Firebird'i yeniden başlatdocker compose exec hqbird systemctl restart firebird
Firebird 3.0: firebird-superserver hizmeti
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Bir saatlik günlükdocker compose logs --since 1h
Durdurdocker compose stop: Firebird veritabanlarını kapatır

Konteyner içinde systemctl komutu HQbird hizmetlerini denetler, ancak systemd değildir. HQbird programlarının kullandığı komutları anlar: start, stop, restart, status, list-units ve diğerleri.

Değişkenler · gizli değerler · birimler

Ayarlar ve birimler

Konteyner ayarları yalnızca bir kez, ilk başlatmada okur: bu, kurulumdur. Veriler, yapılandırma, lisans ve güncellenmiş programlar birimlerde bulunur. Konteyneri yeniden oluşturduğunuzda veya imajı değiştirdiğinizde kalırlar.

AyarNe yapar
HQBIRD_FB_PORTKonteyner içindeki Firebird bağlantı noktası, varsayılan olarak 3050. HQ Monitor 20000 + bu bağlantı noktasını dinler.
HQBIRD_HQM_PORTFarklı bir HQ Monitor bağlantı noktası.
HQBIRD_AGENT_IDAjan adı. Varsayılan olarak ana bilgisayar adı, tarih ve bağlantı noktasından oluşturulur.
HQBIRD_HQM_LOGIN, gizli hqmonitor_passwordHQ Monitor girişi ve parolası.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEDeneme lisansı talebi.
gizli sysdba_passwordYeni Firebird'ün SYSDBA parolası.
gizli licenseLisans dosyası.
gizli attachHQCenter'dan attach.json dosyası: ajanı merkezinize bağlar.
BirimYolİçerik
db/dbVeritabanları. Veritabanlarınızı buraya koyun.
backup/backupYedekler.
opt/optFirebird, ajan, HQ Monitor, küme düğümü, RCM.
state/var/lib/hqbird-containerHizmetler, konsol verileri, ajan günlükleri, makine kimliği.
trust/usr/libexec/hqbird-fbagentAjan güncellemelerinin güvenilir başlatılması.
rootwork/var/lib/hqbird-fbagentGüncellemeler için çalışma klasörü.
  • Ana makine klasörleri yalnızca veritabanları ve yedekler içindb ve backup birimlerini ana makine klasörleriyle değiştirebilirsiniz. Bunları uid 84 olan kullanıcıya verin: bu, imajdaki firebird kullanıcısıdır. Diğer dört birimi ana makine klasörleriyle değiştirmeyin.
  • Birimlerin yedeklenmesiAltı birimin tümünü birlikte kaydedin.
  • Ana makine adını değiştirmeyinLisans, state birimindeki makine kimliğine ve ajan adına bağlıdır. Yeni bir state birimi yeni bir kurulumdur.
  • Merkeze tek bir dosyayla bağlanınattach gizli anahtarı, ajanı ilk başlatmada HQCenter'a bağlar. Bunun için konteynere girmeniz gerekmez.

Bağlantı noktası yayınlama · güvenlik duvarı · ikinci örnek

Bağlantı noktaları ve birden çok örnek

Her bağlantı noktasını konteynerin dışında ve içinde aynı numarayla yayınlayın: 3051:3051, 3051:3050 değil. Ajan ve küme, konteyner içinde gördükleri bağlantı noktasını bildirir.

Bağlantı noktasıNeNe zaman gerekli
HQBIRD_FB_PORT (3050)Firebirdher zaman
20000 + Firebird bağlantı noktası (23050)HQ Monitorher zaman
düğüm bağlantı noktası (7051)küme düğümüörnek bir kümeye katıldığında
7443, 7444RCM ve web arayüzübu ajan RCM çalıştırıyor; ana makine başına bir tane

Docker, bağlantı noktalarını ufw'yi atlayarak yayınlar. Bunu kontrol ettik: "yalnızca 22 numaralı bağlantı noktası" ufw kuralıyla Firebird ve HQ Monitor bağlantı noktaları internetten açıktı. Harici bir güvenlik duvarı kullanın, bağlantı noktasını tek bir ana makine adresinde yayınlayın ("10.0.0.5:23050:23050") veya iptables DOCKER-USER zincirine kurallar ekleyin.

Aynı ana makinede ikinci örnek

Her örneğin kendi klasörü, proje adı, ana makine adı ve bağlantı noktaları olmalıdır. Proje adı birim adlarını belirler. Aynı adla ikinci başlatma, birincinin birimlerini ve konteynerini alır.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + Firebird bağlantı noktası.
  • Küme düğümü: 7051 + N.
  • Ana makinede yalnızca bir örnek RCM çalıştırabilir.

Aynı ana makinedeki diğer Firebird sürümleri de aynı kurallara uyar, her biri kendi imajıyla.

Örnek 1Örnek 2
Proje ve ana makine adıhqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Bağlantı noktaları3051, 23051, 70523052, 23052, 7053
  • BellekBoşta bir örnek yaklaşık 200–250 MB alır. Bunu kontrol ettik: 2 çekirdekli ve 4 GB bellekli bir sunucuda üç Firebird 4.0 örneği, biri yük altında.
  • Aynı ana makinede Docker dışında FirebirdAna makinede Docker olmadan Firebird veya HQbird zaten çalışıyorsa 3050, 23050 ve 7051 bağlantı noktalarını atlayın.

HQCenter · yeni imaj · küme

Güncellemeler ve küme

Bir konteyneri iki şekilde güncelleyebilirsiniz. Her ikisi de verileri korur.

HQCenter'dan

Normal bir sunucudaki gibi: merkez, konteyner içindeki ajanı, HQ Monitor'ü, Firebird'ü, küme düğümünü ve RCM'yi günceller. Güncellenen programlar bir birimde olduğundan yeniden başlatmadan sonra da kalır.

Yeni bir imajla

image satırındaki sürümü değiştirin ve şunu çalıştırın:

docker compose pull
docker compose up -d

Başlatmada konteyner, yeni imajın yükleyicisini güncelleme modunda çalıştırır. Merkez ajanı zaten imajdakinden daha yeni bir sürüme güncellediyse yükleyici çalışmaz: sürüm düşmez.

Kümedeki konteyner

Konteynerdeki bir örnek, bir kümeye sunucuyla aynı şekilde katılır. Üye adresi Docker ana makinesinin adresidir. Küme bağlantı noktalarını compose.yaml içinde yayınlayın.

  • Düğüm bağlantı noktası, örneğin 7051: örnek bir küme üyesi olduğunda.
  • 7443 ve 7444 bağlantı noktaları: bu ajan RCM çalıştırdığında. 7444 üzerindeki web arayüzü için RCM ayarlarında operator_addr = 0.0.0.0:7444 olarak ayarlayın.
  • Küme tanımındaki düğüm bağlantı noktası, yayınlanan bağlantı noktasıyla eşleşmelidir.

Ajan, kümeyi kaydettikten birkaç dakika sonra düğümü kurar. O zamana kadar düğüm bağlantı noktası yanıt vermez.

Küme ve çoğaltma hakkında daha fazla bilgi →

Bulut sunucusu · NAT · güvenlik duvarı

Bulut sunucusunda HQbird

Bir bulut sunucusunda HQbird'i normal yükleyiciyle kurarsınız: tek dosya, tek komut. Firebird, ajan ve konsol dosyanın içindedir: yükleyici hiçbir şey indirmez. Linux'ta dağıtım deposundan birkaç işletim sistemi kitaplığı (libtommath, ICU) alır. Depo yoksa tam komutları yazdırır ve hiçbir şeyi değiştirmez.

  • Merkez için gelen bağlantı noktası yokAjan HQCenter'a kendi başına bağlanır. NAT arkasındaki veya özel bir bulut ağındaki bir sunucu, merkezde sizin rafınızdaki bir sunucuyla aynı görünür.
  • İşletim sistemi güvenlik duvarıYükleyici, yeni Firebird'ün bağlantı noktasını ve HQ Monitor bağlantı noktasını firewalld veya ufw içinde açar. Bulutun kendi güvenlik duvarı kurallarını siz ayarlarsınız.
  • Sunucu gereksinimleriEn az 2 GB bellek, 2 çekirdek ve 5 GB disk. Linux x86-64 veya Windows.
  • Linux dağıtımlarıapt, dnf, yum veya zypper içeren Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS ve diğerleri.
  • Betikle yüz sunucuHer kurulum adımı bir anahtar olarak kullanılabilir. Önce kurulum planını görüntüleyebilirsiniz: komut hiçbir şeyi değiştirmez.
  • Gizli anahtarlar korunurKonsolda girdiğiniz bir gizli anahtar ajana şifrelenmiş olarak gider. Gizli anahtarlar raporlarda ve yapılandırma kopyalarında gizlenir. Ajan yapılandırma dosyasında S3 anahtarı şifrelenmez: bu dosyaya erişimi kısıtlayın. Bir Amazon EC2 sunucusunda anahtar olmadan çalışabilirsiniz: ajan sunucunun IAM rolünü kullanır.
  • Grafana'nızda metriklerAjan, Firebird ve sunucu metriklerini Prometheus biçiminde dışa aktarır.
  • Bulut diski kontrol altındaAjan okuma ve yazma gecikmesini ölçer ve diskin ne zaman dolacağını tahmin eder. Yavaş veya neredeyse dolu bir bulut diski sağlık raporunda görünür.

Kurulum ve güncellemeler hakkında daha fazla bilgi →

Sınırlar · ipuçları

Bilmeniz iyi olur

  • Docker ve ufwYayınlanan bir konteyner bağlantı noktası ufw'yi atlayarak açıktır. Harici bir güvenlik duvarıyla kapatın veya tek bir adreste yayınlayın.
  • Ayarlar yalnızca ilk başlatmadaDeğişkenler ve gizli anahtarlar bir kez okunur. Firebird bağlantı noktasını, ana makine adını ve gizli anahtarları sonradan değiştiremezsiniz: yeni bir kurulum gerekir. İşleri ve diğer ajan ayarlarını HQ Monitor'de veya merkezden değiştirirsiniz.
  • docker compose exec ile betiklerBetiklerde -T anahtarını ve </dev/null ekleyin. Bunlar olmadan komut standart girdiyi okur ve betiğin geri kalanını alır.
  • Merkeze bağlantıdan önceki uyarılarAjan HQCenter'a bağlanana kadar günlüğü, bağlantı ayarlarının eksik olduğunu söyler. Bu normaldir.
  • İmaj imzasıİmajlar cosign aracıyla imzalanır. cosign verify komutuyla kontrol etmek için kullanılacak genel anahtar henüz yayınlanmadı.
  • Nerede test edildiUbuntu 22.04, Compose ile Docker, 2 çekirdekli ve 4 GB bellekli bir sunucu. Ubuntu için adım adım kurulum kılavuzu Rusça ve Portekizce olarak mevcuttur.

← HQbird 2027 genel bakışına dön