Bulut ve Docker
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.
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.
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.
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.
İ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.
| İmaj | Firebird | Firebird bağlantı noktası | 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 |
İlk başlatma
- 1compose.yamlkitten ana bilgisayardaki bir klasöre kopyalayın
- 2SYSDBA parolasıyalnızca sizin okuyabildiğiniz bir gizli dosyaya
- 3İmaj, ad, gizli değerler
imagevehostnameayarlayın,secrets:satırlarındaki#işaretini kaldırın - 4docker compose up -dkonteyner HQbird'i kurar
- 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.propertiesdosyasındadır. - HQCenter'daki ajan adı: ana bilgisayar adı, kurulum tarihi ve Firebird sürümü.
Günlük işler
| Görev | Komut |
|---|---|
| Hizmet durumu | docker compose exec hqbird systemctl list-units --type=service |
| Firebird'i yeniden başlat | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: firebird-superserver hizmeti |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Bir saatlik günlük | docker compose logs --since 1h |
| Durdur | docker 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.
| Ayar | Ne yapar |
|---|---|
HQBIRD_FB_PORT | Konteyner içindeki Firebird bağlantı noktası, varsayılan olarak 3050. HQ Monitor 20000 + bu bağlantı noktasını dinler. |
HQBIRD_HQM_PORT | Farklı bir HQ Monitor bağlantı noktası. |
HQBIRD_AGENT_ID | Ajan adı. Varsayılan olarak ana bilgisayar adı, tarih ve bağlantı noktasından oluşturulur. |
HQBIRD_HQM_LOGIN, gizli hqmonitor_password | HQ Monitor girişi ve parolası. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Deneme lisansı talebi. |
gizli sysdba_password | Yeni Firebird'ün SYSDBA parolası. |
gizli license | Lisans dosyası. |
gizli attach | HQCenter'dan attach.json dosyası: ajanı merkezinize bağlar. |
| Birim | Yol | İçerik |
|---|---|---|
db | /db | Veritabanları. Veritabanlarınızı buraya koyun. |
backup | /backup | Yedekler. |
opt | /opt | Firebird, ajan, HQ Monitor, küme düğümü, RCM. |
state | /var/lib/hqbird-container | Hizmetler, konsol verileri, ajan günlükleri, makine kimliği. |
trust | /usr/libexec/hqbird-fbagent | Ajan güncellemelerinin güvenilir başlatılması. |
rootwork | /var/lib/hqbird-fbagent | Güncellemeler için çalışma klasörü. |
- Ana makine klasörleri yalnızca veritabanları ve yedekler için
dbvebackupbirimlerini ana makine klasörleriyle değiştirebilirsiniz. Bunları uid 84 olan kullanıcıya verin: bu, imajdakifirebirdkullanı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,
statebirimindeki makine kimliğine ve ajan adına bağlıdır. Yeni birstatebirimi yeni bir kurulumdur. - Merkeze tek bir dosyayla bağlanın
attachgizli 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ı | Ne | Ne zaman gerekli |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | her zaman |
| 20000 + Firebird bağlantı noktası (23050) | HQ Monitor | her zaman |
| düğüm bağlantı noktası (7051) | küme düğümü | örnek bir kümeye katıldığında |
| 7443, 7444 | RCM 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-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Bağlantı noktaları | 3051, 23051, 7052 | 3052, 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:7444olarak 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.
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.
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
-Tanahtarını ve</dev/nullekleyin. 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 verifykomutuyla 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.