Manual Action

Manual Action Nedir?

Manual Action aksiyonu, TR7'nin standart aksiyon seçenekleri ile karşılanamayan özel gereksinimleri için gelişmiş yapılandırma kuralları eklemeye olanak tanır. Bu aksiyon, TR7 Destek Ekibi tarafından özel konfigürasyonlar oluşturmak için kullanılır.

Bu aksiyon hem istek (request) hem de yanıt (response) aşamasında çalışabilir ve yapılandırmanın farklı seviyelerine kural ekleyebilir.

DANGER

Uzman Kullanıcılar İçin

Manual Action, TR7'nin iç yapılandırma formatını kullanır ve yanlış kullanıldığında vService'in çalışmasını etkileyebilir.

Bu aksiyonu kullanmadan önce:

• TR7 Destek Ekibi ile iletişime geçmeniz önerilir.
• Test ortamında doğrulama yapılmalıdır.
• Yapılandırma sözdizimi hakkında bilgi sahibi olunmalıdır.

Destek: support@tr7.com

Manual Action Ne Zaman Kullanılır?

Manual Action, TR7'nin yerleşik aksiyonlarının karşılayamadığı özel senaryolar için tasarlanmıştır.

Manual Action genellikle şu durumlarda kullanılır;

• TR7'nin standart aksiyonlarında bulunmayan özel davranışlar tanımlamak için,
• Gelişmiş trafik yönetimi kuralları oluşturmak için,
• Özel protokol işleme gereksinimleri için,
• TR7 Destek Ekibi tarafından sağlanan özel çözümler için.

Çoğu kullanım senaryosu için TR7'nin standart aksiyonları yeterlidir. Manual Action, yalnızca özel gereksinimler için tercih edilmelidir.

Kullanılabildiği vService Tipleri

HTTP

L7 TCP

Network

Çalışma Anı

İstek Anı (On Request)

Cevap Anı (On Response)

Nasıl Eklenir?

Yeni bir Manual Action, TR7 web yönetim arayüzü üzerinden aşağıdaki adımlar izlenerek eklenebilir:

1. Sol altta bulunan TR7 logosuna tıklanarak Configuration Menu açılır.
2. Load Balancer → Actions → Add adımları takip edilir.
3. Aksiyon için benzersiz ve açıklayıcı bir isim girilir.
4. Action Type olarak Manual Action seçilir.
5. Aksiyona ait ilgili konfigürasyonlar yapılandırılır.
6. Add butonuna tıklanarak aksiyon eklenir.

Manual Action Ekleme Formu

Manual Action Ekleme Formu

INFO

Action Name

Oluşturulacak olan aksiyona benzersiz ve açıklayıcı bir isim girilir.

INFO

Action Type

Aksiyon tipi olarak Manual action seçilir.

Aksiyon koşul almadığından ve sayaç desteklemediğinden formda Conditions, Hit Counter ve Set Variable on Hit alanları bulunmaz. Aksiyon listesinde yalnızca hedef bölüm görüntülenir; girilen satır içeriği listede gösterilmez.

INFO

Execution Level

Aksiyonun hangi aşamada çalıştırılacağını belirler.

• On Request: Aksiyon, istek ilgili Kurum Servisine iletilmeden önce uygulanır. Bu seviye, istek üzerinde değişiklik yapılması veya Kurum Servisine ek bilgi iletilmesi gereken durumlarda kullanılır.
• On Response: Aksiyon, yanıt istemciye iletilmeden önce uygulanır. Bu seviye, istemciye gönderilen yanıt üzerinde düzenleme veya ekleme yapılması gereken durumlarda kullanılır.

Bu aksiyonda seçimin yapılandırmaya etkisi yoktur

Manuel kuralın nereye yazılacağını Manual Rule Field alanı belirler. Execution Level seçimi üretilen yapılandırmayı değiştirmez; yalnızca aksiyonun listelerdeki gösterimini etkileyen bir etikettir. İstek/yanıt ayrımı, girilen satırın kendi sözdiziminde (http-request / http-response) yapılır.

Bu alan kayıttan sonra değiştirilemez.

INFO

Manual Rule Field Varsayılan: Global

Kuralın ekleneceği yapılandırma bölümünü belirler. Her seçenek farklı bir kapsamda etkilidir:

Seçenek	Kuralın yazıldığı yer
Global	Genel yapılandırma bölümü; tüm vService için geçerli sistem düzeyi ayarlar
Defaults	Ortak varsayılanlar bölümü; zaman aşımı, log ve mod gibi temel davranışlar
Frontend	vService'in istemciyi karşılayan bölümü
Default backend	Yalnızca varsayılan Kurum Servisi listesi (Default Backend Services)
Conditional backend	Varsayılan liste dışındaki tüm koşullu Kurum Servisi dalları (Conditional Backend Services)

WARNING

Form Global seçili olarak açılır; bu en geniş kapsamlı bölümdür ve yanlış bir satır tüm vService'i etkiler. Seçim, girilecek satırın türüne göre bilinçli olarak yapılmalıdır.

Conditional backend seçildiğinde vService'te koşullu dağıtım tanımlı değilse satır hiçbir yere yazılmaz ve uyarı da verilmez.

Defaults bölümüne yazılan satırlar, diğer aksiyonların ürettiği ayarları geçersiz kılabilir; örneğin bağlantı modu direktifleri HTTP TCP Multiplexing aksiyonunun ayarını ezer.

INFO

Manual Rule Content Zorunlu

Yük dengeleyici yapılandırma sözdiziminde yazılmış kural içeriği bu alana girilir. İçerik, TR7 Destek Ekibi tarafından sağlanan satırlardan oluşur.

Birden fazla satır girilebilir; her satır ayrı bir yapılandırma satırı olarak eklenir ve hepsi aynı hedef bölüme, aynı öncelikle yazılır.

Girilen içerik hiçbir denetimden geçmez

Alan doğrudan yapılandırmaya aktarılır; sözdizimi denetimi, biçim doğrulaması veya güvenlik filtresi uygulanmaz.

Hatalı bir satır girildiğinde sonuç anında görünmez: yapılandırma yenilenirken satır reddedilir, ancak çalışan servis eski yapılandırmayla ayakta kaldığı için arayüzde hata görüntülenmez ve kural uygulanmış gibi görünür. Servis bir sonraki yeniden başlatmasında açılmaz.

Bu nedenle her manuel kural, canlıya alınmadan önce test ortamında doğrulanmalı ve uygulandıktan sonra beklenen davranış canlı trafikte kontrol edilmelidir.

WARNING

Bu alan akıllı değişkenleri desteklemez; %SRCIP gibi TR7 değişkenleri yazıldığı gibi yapılandırmaya geçer ve çalışmaz. Yapılandırma sözdiziminin kendi ifadeleri kullanılabilir.

Aksiyon koşul alanı sunmadığından, koşul gerekiyorsa satırın kendi içinde yazılır (ör. satır sonuna eklenen if ifadesiyle). TR7 üzerinde tanımlı Koşul nesnelerine bu satırdan referans verilemez.

INFO

Manual Rule Priority

Satırın, hedef bölüm içindeki sırasını belirler. Yüksek değer önce yazılır; değer girilmezse satır 0 kabul edilir.

Öncelik yalnızca manuel kurallar arasında değil, hedef bölümün tüm satırları arasında geçerlidir. TR7'nin kendi ürettiği kural satırlarının çoğu pozitif önceliklidir; bu nedenle öncelik verilmeyen bir manuel satır onlardan sonra çalışır. Manuel satırın TR7 kurallarından önce çalışması gerekiyorsa yeterince yüksek bir değer verilmelidir.

WARNING

Alan negatif ve ondalık değer kabul eder; negatif bir öncelik satırı yönlendirme ve sunucu tanımlarının bile altına düşürebilir. Değer, Destek Ekibi'nin belirttiği şekilde girilmelidir.

INFO

Form Butonları

Add

Add butonuna tıklanarak aksiyon ekleme işlemi tamamlanır.

Add & Repeat

Add & Repeat butonu ile aksiyon ekleme işlemi tamamlanır ve farklı konfigürasyonlarla ilgili pencereden çıkılmadan yeni bir aksiyon daha eklenebilir.

Aksiyon Eklendi

WARNING

Manual Action koşul gerektirmez ve tanımlandığı vService üzerinde koşulsuz (Always) olarak uygulanır.

Koşulsuz çalışan aksiyonlar, trafik içeriğine bağlı değerlendirme yapmadan, ilgili vService üzerindeki tüm trafiği veya davranışı doğrudan etkiler.

Canlı ortamlarda, bu tür aksiyonların devreye alınması öncesinde hedef servis davranışlarının ve olası etkilerin dikkatle değerlendirilmesi önerilir. Aksi durumda, beklenmeyen servis davranışları veya operasyonel sorunlar oluşabilir.

Bazı satırlar servisi yeniden başlatır

Global bölümüne yazılan bazı sistem düzeyi ayarlar (iş parçacığı sayısı, arabellek boyutları, işlemci eşlemesi, saniyelik bağlantı/SSL sınırları gibi) kesintisiz yenileme ile uygulanamaz ve yük dengeleyici servisinin yeniden başlatılmasını zorunlu kılar. Bu tür satırlar bakım penceresinde eklenmeli; aynı anda sözdizimi hatası varsa servis geri gelmez.

Operasyonel ve Güvenli Kullanım Önerileri

• TR7 Destek Ekibi ile Çalışın. Manual Action kullanmadan önce TR7 Destek Ekibi ile iletişime geçin. Ekip, gereksinimlerinize uygun kuralları sağlayacak ve doğru yapılandırmayı yapmanıza yardımcı olacaktır.
• Test ortamında doğrulanır. Eklenen kurallar önce test ortamında uygulanır ve vService'in doğru çalıştığı doğrulanır; yanlış kurallar servis kesintisine neden olabilir.
• Kurallar belgelenir. Eklenen manuel kuralların ne yaptığı ve neden gerekli olduğu belgelenir; bu, ileride bakım ve sorun giderme için kritiktir.
• Önce standart aksiyonlar denenir. Manual Action kullanılmadan önce TR7'nin standart aksiyonlarının gereksinimi karşılayıp karşılamadığı kontrol edilir; standart aksiyonlar daha güvenli ve yönetimi kolaydır.