Smarter by Design.Simpler for Business
lb backend-group
lb backend-group komutu, aynı hizmeti veren birden çok arka uç sunucuyu tek bir kayıt altında toplar. Sağlık denetimi, SSL ve kaynak adres ayarları grubun tamamına uygulanır; adres, ağırlık ve bağlantı sınırı ise her sunucu için ayrı yazılır. Panel karşılığı Backend Groups ekranıdır.
Tek bir sunucu yeterliyse lb backend kullanılır; grup, sunucular arasında dağıtım yapılacağı zaman gerekir.
Komut Özeti
# komuttan sonra Tab
admin@TR7LBWAF01> lb backend-group
add delete list show update update-many
admin@TR7LBWAF01> lb backend-group list # hepsini listele
admin@TR7LBWAF01> lb backend-group show <kimlik> # birini göster
admin@TR7LBWAF01> lb backend-group add name <ad> v-device <v-device> …
admin@TR7LBWAF01> lb backend-group update id <kimlik> … # değiştir
admin@TR7LBWAF01> lb backend-group update-many <hedef> … # toplu değiştir
admin@TR7LBWAF01> lb backend-group delete <kimlik> # sil
admin@TR7LBWAF01>
Yazım Sırası
Adım 1 Adı yaz
lb backend-group add web-havuzuAdım 2 Sanal cihazı seç
Grubun tanımlanacağı v-device. Varsayılan, komutun çalıştığı cihazdır.
Adım 3 Yönlendirme tablosunu seç
Varsayılan değer
1'dir. Adım 4 Sunucuları indeksle ekle
--servers.0.addr.ip … --servers.0.addr.port … --servers.1.addr.ip …Adım 5 Grup ayarlarını ekle
Sağlık denetimi, SSL ve kaynak adres alanları grubun tamamına uygulanır.
Zorunlu Alanlar
| Sıra | Alan | Durum | Değer |
|---|---|---|---|
| 1 | name | Zorunlu | Grubun adı; koleksiyonda benzersiz olmalı |
| 2 | v-device | Zorunlu | Sanal cihaz; varsayılan, komutun çalıştığı cihaz |
| 3 | namespace | Zorunlu | Yönlendirme tablosu; varsayılan 1 |
| — | differentIp.ip | Koşullu zorunlu | Yalnız --useDifferentIp true yazıldığında istenir |
Bu üç alan eğik çizgisiz, çıplak yazılır. Adres ve port grup düzeyinde sorulmaz; her sunucu için --servers.N.addr.ip ve --servers.N.addr.port alanlarıyla verilir.
Grup sunucusuz kalmamalı
Şemada sunucu listesi zorunlu olarak tanımlıdır. Bu yüzden grup, komut satırında en az bir sunucuyla birlikte yazılır: --servers.0.addr.ip ve --servers.0.addr.port.
Sunucu Alanları
Her sunucu kendi indeksiyle yazılır: --servers.0.…, --servers.1.… biçiminde.
| Alan | Varsayılan | Değer |
|---|---|---|
--servers.N.addr.ip | — | Sunucunun IP adresi ya da alan adı |
--servers.N.addr.port | — | Sunucunun portu |
--servers.N.weight | Yok | Dağıtım ağırlığı; 1 ile 256 arasında |
--servers.N.connLimit | Yok | Eşzamanlı bağlantı sınırı; 1 ile 65535 arasında |
--servers.N.cookieContent | Yok | Oturum sürekliliğinde bu sunucuyu işaretleyen çerez değeri |
Adres, ağırlık, bağlantı sınırı ve çerez değeri yalnız sunucu düzeyinde bulunur; aşağıdaki alanların hepsi grubun tamamına uygulanır.
Sağlık Denetimi Alanları
| Alan | Varsayılan | Değer |
|---|---|---|
--hc | Yok | Uygulanacak lb hc kaydı |
--enableHcLog | true | Sağlık denetimi günlüklerinin tutulup tutulmayacağı |
--useDifferentIp | false | Sağlık denetiminin farklı bir adrese yapılması |
--differentIp.ip | — | Denetimin yapılacağı adres; --useDifferentIp true iken zorunlu |
--differentIp.port | Yok | Denetimin yapılacağı port |
--differentSrcType | Yok | Denetimin kaynak adresi: boş ya da deviceSrc |
--deviceSrc | — | --differentSrcType deviceSrc iken kullanılacak cihaz adresi |
SSL Alanları
Bu alanlar TR7 ile gruptaki sunucular arasındaki bağlantıya uygulanır ve yalnız --sslService true yazıldığında etkindir.
| Alan | Varsayılan | Değer |
|---|---|---|
--sslService | false | Sunuculara SSL ile bağlanılması |
--ciphers | standard | Şifre takımı: standard ya da low |
--sni | Yok | Bağlantıda gönderilecek SNI değeri |
--alpn | http20_disabled | http20_disabled (HTTP/2 kapalı) ya da http20_enabled (HTTP/2 açık) |
--sslSecurityProfile | Yok | Uygulanacak lb ssl-security profili |
--sslVerify | none | Sunucu sertifikasının doğrulanması: none ya da required |
--sslVerifyCa | Yok | Doğrulamada kullanılacak CA profili; --sslVerify required iken yazılır |
--sslClientCert | Yok | TR7'nin sunuculara kendini tanıtırken sunacağı istemci sertifikası |
Grup Davranışı ve Kaynak Adres Alanları
| Alan | Varsayılan | Değer |
|---|---|---|
--backupService | false | Grubun yedek olarak işaretlenmesi |
--maintenanceMode | false | Grubun bakıma alınması; trafik gönderilmez |
--useFrontendPort | false | Sunuculara, isteğin geldiği karşılama portuyla bağlanılması |
--proxyOpt | Yok | send-proxy (PROXY protokolü v1) ya da send-proxy-v2 |
--snatOpt | Yok | Kaynak adres çevrimi: clientIp ya da customIpDevice |
--snatIpDevice | — | --snatOpt customIpDevice iken kullanılacak adres |
--spoofing | false | --snatOpt clientIp iken MAC relay davranışı |
--spoofingIp | — | Relay için kullanılacak adres |
--spoofingClusterIp | — | Relay koşulunu belirleyen VIP |
--spoofingDefaultClusterId | 1 | Relay için varsayılan cihaz |
Örnekler
# zorunlu alanlar her durumda öneksiz ve -- alanlarından önce yazılır
admin@TR7LBWAF01> lb backend-group add name web-havuzu v-device <v-device> namespace 1 \
--servers.0.addr.ip 10.0.10.21 --servers.0.addr.port 8080 \
--servers.1.addr.ip 10.0.10.22 --servers.1.addr.port 8080
admin@TR7LBWAF01>
# güçlü sunucuya daha yüksek ağırlık
admin@TR7LBWAF01> lb backend-group add name api-havuzu v-device <v-device> namespace 1 \
--servers.0.addr.ip 10.0.20.11 --servers.0.addr.port 9000 --servers.0.weight 60 \
--servers.1.addr.ip 10.0.20.12 --servers.1.addr.port 9000 --servers.1.weight 40 \
--hc <denetim> --enableHcLog true
admin@TR7LBWAF01>
admin@TR7LBWAF01> lb backend-group add name tls-havuzu v-device <v-device> namespace 1 \
--servers.0.addr.ip 10.0.30.11 --servers.0.addr.port 443 \
--servers.1.addr.ip 10.0.30.12 --servers.1.addr.port 443 \
--sslService true --sni portal.kurum.com.tr --sslVerify required --sslVerifyCa <ca-profili>
admin@TR7LBWAF01>
Sunucu Ekleme ve Çıkarma
# var olan bir sunucunun ağırlığını değiştirme
admin@TR7LBWAF01> lb backend-group update id <kimlik> --servers.0.weight 80
# listeye yeni sunucu ekleme: sıradaki indeks yazılır
admin@TR7LBWAF01> lb backend-group update id <kimlik> \
--servers.2.addr.ip 10.0.10.23 --servers.2.addr.port 8080
# tek sunucuyu listeden çıkarma
admin@TR7LBWAF01> lb backend-group update id <kimlik> --servers.1.delete
# sunucu listesinin tamamını boşaltma
admin@TR7LBWAF01> lb backend-group update id <kimlik> --servers.delete
admin@TR7LBWAF01>
--servers.N.delete ve --servers.delete bayrakları değer almaz ve yalnız update komutunda görünür.
vService'e Bağlama
admin@TR7LBWAF01> lb service update id <vService> --defaultBackendList.0 <grup>
admin@TR7LBWAF01>
Güncelleme ve Silme
admin@TR7LBWAF01> lb backend-group update id <kimlik> --maintenanceMode true
admin@TR7LBWAF01> lb backend-group delete <kimlik>
admin@TR7LBWAF01>
Toplu Güncelleme
update-many, aynı değişikliği birçok grup kaydına birden uygular. Yazım sırası her kaynakta aynıdır.
Adım 1 Hedefi seç
Tek zorunlu alan
target: selected listeden seçilen kayıtlar, all koleksiyonun tamamı. Adım 2 Yazılacak alanları ekle
Yalnız birçok kayda aynı değerle yazılabilen alanlar bulunur; kimlik, ad ve sunucu listesi gibi kayda özgü alanlar bu komutta yer almaz.
Adım 3 Hedefleri listeden işaretle
target selected yazılıp kimlik verilmediğinde onay kutulu seçim listesi açılır. Adım 4 Onayla
Kaç kaydın etkileneceğini yazan uyarı çıkar; onay sözcüğü yazılmadan hiçbir şey yazılmaz.
| Alan | Durum | Değer |
|---|---|---|
target | Zorunlu | selected — listeden seçilen kayıtlar · all — koleksiyonun tamamı |
--ids.N | Koşullu | target selected için hedef kimlikleri. Tab listesinde önerilmez: hedefler seçim listesinden işaretlenir. Betikte ve boru hattında elle yazılır. |
--onError | İsteğe bağlı | abort (varsayılan) — hedeflerden biri bile doğrulamadan geçmezse hiçbir şey yazılmaz · skip — geçen hedefler yazılır |
Yazılabilen Alanlar
# komuttan sonra Tab
admin@TR7LBWAF01> lb backend-group update-many
--info target
# target alanından sonra Tab
admin@TR7LBWAF01> lb backend-group update-many target
all selected
# -- yazıp Tab: yazılabilen alanların tamamı
admin@TR7LBWAF01> lb backend-group update-many target all --
--alpn --backupService --ciphers
--differentSrcType --enableHcLog --hc
--info --maintenanceMode --onError
--proxyOpt --snatOpt --spoofing
--spoofingDefaultClusterId --sslClientCert --sslSecurityProfile
--sslService --sslVerify --sslVerifyCa
--useDifferentIp --useFrontendPort
admin@TR7LBWAF01>
Komutta 20 alan bulunur; yukarıdaki liste cihazda -- yazıp Tab'a basıldığında çıkanın aynısıdır. Her birinin ne yaptığı ve arkasına ne yazıldığı aşağıdaki tablodadır.
Tekil komutta koşula bağlı olan alanlar (bir başka alanın değerine göre açılanlar) burada koşulsuz listelenir: toplu güncellemede her hedef kendi kaydına göre ayrı doğrulanır, alan bir hedefte aktif değilse yalnız o hedefte atlanır.
| Alan | Ne yapar | Arkasına ne yazılır |
|---|---|---|
--info | Komutu çalıştırmadan ne yapacağını yazar | Değer almaz; tek başına yazılır |
--onError | Bir hedef doğrulamadan geçmezse ne olacağını belirler | abort hiçbir şey yazmaz (varsayılan) · skip geçen hedefleri yazar |
--hc | Hedeflere uygulanacak sağlık denetimini bağlar | lb hc kaydı; Tab var olanları listeler |
--enableHcLog | Sağlık denetimi günlüklerinin tutulup tutulmayacağını belirler | true · false (varsayılan true) |
--useDifferentIp | Sağlık denetiminin trafiğin gittiği adresten farklı bir adrese yapılmasını açar | true · false (varsayılan false). Denetim adresi kayda özgü olduğu için bu komutta yazılamaz; adresi tekil update ile verin |
--differentSrcType | Sağlık denetiminin hangi kaynak adresten çıkacağını seçer | Boş bırakılır ya da deviceSrc yazılır |
--manualSrc | Sağlık denetiminin çıkacağı kaynak adresi elle yazmaya yarayan alandır | Bu sürümde --differentSrcType alanının değer kümesinde manualSrc bulunmadığından alan hiç etkinleşmez |
--maintenanceMode | Kaydı bakıma alır; hedeflere trafik gönderilmez, yapılandırma silinmez | true · false (varsayılan false) |
--backupService | Kaydı yedek olarak işaretler; ötekiler sağlıklıyken trafik almaz | true · false (varsayılan false) |
--useFrontendPort | Arka uca, isteğin geldiği karşılama portuyla bağlanılmasını sağlar | true · false (varsayılan false) |
--proxyOpt | İstemcinin gerçek adresini arka uca PROXY protokolüyle taşır | send-proxy (PROXY protokolü v1) · send-proxy-v2; boş bırakıldığında kapalıdır |
--sslService | Arka uca SSL ile bağlanılmasını açar; SSL alanlarının hepsi buna bağlıdır | true · false (varsayılan false) |
--ciphers | SSL bağlantısında kullanılacak şifre takımını seçer | standard · low (varsayılan standard) |
--alpn | SSL bağlantısında HTTP/2 kullanılıp kullanılmayacağını belirler | http20_disabled · http20_enabled (varsayılan http20_disabled) |
--sslSecurityProfile | Arka uç bağlantısına SSL güvenlik profili uygular | lb ssl-security kaydı. Bu bağlantıda profilin yalnız en düşük/en yüksek SSL sürümü, şifre listesi ve eğri ayarları geçerlidir |
--sslVerify | Arka ucun sunduğu sertifikanın doğrulanıp doğrulanmayacağını belirler | none · required (varsayılan none) |
--sslVerifyCa | Doğrulamada hangi CA profilinin kullanılacağını seçer | lb ca kaydı; --sslVerify required ile birlikte anlamlıdır |
--sslClientCert | TR7'nin arka uca kendini tanıtırken sunacağı istemci sertifikasını seçer (mTLS) | Sertifika kaydı. Bu, ziyaretçinin sertifikasının doğrulanmasının tersi yöndür: burada istemci TR7'dir |
--snatOpt | Arka uca giden bağlantının kaynak adresinin nasıl belirleneceğini seçer | clientIp istemcinin adresini taşır · customIpDevice cihaz üzerinden seçilen adresi kullanır; boş bırakıldığında çevrim yapılmaz |
--spoofing | Kaynak adres istemciden taşınırken MAC relay davranışını açar | true · false (varsayılan false); --snatOpt clientIp ile birlikte anlamlıdır |
--spoofingDefaultClusterId | MAC relay için varsayılan cihazı seçer | Cihaz listesinden seçilir (varsayılan 1) |
Tekil komutta bulunup burada olmayan alanlar ve nedenleri:
| Alan | Neden yok |
|---|---|
name | Ad benzersizdir; aynı değer birçok kayda yazılamaz |
v-device | Sanal cihaz, seçilebilecek adres ve tablo kümesini belirler; değeri kardeş alanlara bağlıdır |
namespace | Yönlendirme tablosu da aynı biçimde sanal cihaza bağlıdır |
sni | Akıllı içerik alanıdır; değer değil, kayda göre çözülen bir ifade taşır |
snatIpDevice | Değeri, seçilen sanal cihazın adres listesinden gelir |
spoofingIp | Adres alanıdır; her kayıt için ayrı yazılır |
spoofingClusterIp | Değeri kardeş alanlara bağlıdır |
deviceSrc | Değeri, seçilen cihazın adres listesinden gelir |
differentIp.ip | Sağlık denetimi adresi kayda özgüdür; nesne alanı olduğu için toplu yazılamaz |
differentIp.port | Aynı nesne alanının parçasıdır |
servers.N.addr.ip | Sunucu listesi öğeleri kendi kimliklerini taşır; bir grubun öğe kimlikleri ötekilere kopyalanamaz |
servers.N.weight | Aynı listenin parçasıdır |
servers.N.connLimit | Aynı listenin parçasıdır |
servers.N.cookieContent | Aynı listenin parçasıdır |
Hedef Seçimi ve Onay
admin@TR7LBWAF01> lb backend-group update-many target selected --maintenanceMode true
? Hedef nesneler
boşluk: işaretle · ctrl+a: tümü · enter: onayla
Filtre: (yazarak filtreleyin) · esc: iptal
[x] <kayıt-1>
[x] <kayıt-2>
[ ] <kayıt-3>
2 seçili / 3
⚠ 2 nesne güncellenecek
<kayıt-1>, <kayıt-2>
Devam etmek için "evet" yazın: evet
admin@TR7LBWAF01>
# koleksiyonun tamamı: liste açılmaz, doğrudan onay gelir
admin@TR7LBWAF01> lb backend-group update-many target all --enableHcLog false
⚠ Bu işlem koleksiyondaki TÜM nesneleri güncelleyecek
Devam etmek için "evet" yazın:
# betikte ya da boru hattında: hedefler elle yazılır, liste açılmaz
admin@TR7LBWAF01> lb backend-group update-many target selected \
--ids.0 <kimlik-1> --ids.1 <kimlik-2> --maintenanceMode true --onError skip
admin@TR7LBWAF01>
Ekran dili kullanıcıya bağlıdır
Seçim listesindeki ve onay ekranındaki metinler, oturum açan kullanıcının dil tercihine göre gelir. İngilizce arayüzde onay sözcüğü yes, Türkçe arayüzde evet olur.
Toplu güncellemenin ayrıntılı davranışı — hangi alanların toplu yazılabildiği ve her hedef için dönen rapor — API Commands sayfasındadır.
Bilinmesi Gerekenler
- Ortak ayarlar gruba, adres sunucuya aittir. Sağlık denetimi, SSL, kaynak adres ve bakım modu grubun tamamına uygulanır; adres, port, ağırlık, bağlantı sınırı ve çerez değeri her sunucu için ayrı yazılır.
- İndeks sırası önemlidir. Sunucular
--servers.0,--servers.1biçiminde sırayla yazılır; güncellemede var olan bir indekse yazmak o sunucuyu değiştirir, sıradaki indekse yazmak yeni sunucu ekler. - Toplu güncelleme sunucu alanlarını taşımaz.
update-manykomutunda sunucu listesi bulunmaz; yalnız grup düzeyindeki ortak alanlar yazılabilir. Komut, uygulamadan önce her zaman onay ister. - Ad benzersizdir. Aynı ada sahip ikinci bir grup oluşturulamaz.
- Sağlık denetimi ayrı bir kayıttır.
--hcalanına yazılacak denetim öncelb hcile oluşturulur.
