Olay İşleyicilerini Kullanma¶
Belirli olaylar gerçekleştiğinde belirli eylemlerin otomatik olarak gerçekleşmesini sağlamak için SolusVM 2'deki olay işleyicilerini kullanabilirsiniz. Şu anda web kancaları desteklenen tek olay işleyici türüdür. Gelecekte başka olay işleyici türleri eklenebilir.
Bir olay işleyicisi oluştururken, desteklenen olaylar listesinden bir IP adresi ekleme veya bir sunucuyu kaldırma gibi bir veya daha fazla olay seçebilirsiniz. Yalnızca desteklenen etkinlikler için bir olay işleyicisi oluşturabilirsiniz. Desteklenen bir olay her gerçekleştiğinde, ister yönetici ister müşteri tarafından başlatılmış olsun, o olayla ilişkili tüm olay işleyicileri tetiklenir.
Web Kancası Oluşturma¶
Web kancası, kullanıcı tanımlı bir HTTP/HTTPS geri çağrısıdır. Bu türden bir olay işleyicisi her tetiklendiğinde web kancasını çalıştırır ve ardından SolusVM 2, web kancası URL'sine bir POST isteği gönderir. SolusVM 2 en fazla beş yönlendirmeyi takip eder ve web sitesinin SSL/TLS sertifikasının (varsa) geçerliliğini kontrol etmez. Önceden belirlenmiş bir dizi parametre her zaman URL aracılığıyla iletilir (örneğin, silinen sunucunun kimliği veya eklenen IP adresi). Bir web kancası, kullanıcı tarafından tanımlanan ek parametreleri iletecek şekilde de yapılandırılabilir.
Bir web kancası her tetiklendiğinde SolusVM 2'de bir görev oluşturulur. Komut dosyası 4хх veya 5хх HTTP durum kodu döndürürse görev "Başarısız" durumuna sahip olacaktır.
Web kancası oluşturmak için:
- SolusVM 2'de oturum açın.
- Ayarlar > Olay İşleyicileri'ne gidin ve ardından Web Kancası Ekle'yi tıklayın.
- Web kancanıza benzersiz bir ad verin.
- Web kancası URL'sini belirtin. Webhook her tetiklendiğinde bu URL'ye bir istek gönderilecektir.
- Açılır menüden bir veya daha fazla etkinlik seçin. Desteklenen bir etkinlik her gerçekleştiğinde webhook tetiklenir.
- (İsteğe bağlı) Webhook URL'si aracılığıyla aktarılacak ek istek parametrelerini belirtin. Parametreler JSON formatında olmalıdır.
- (İsteğe bağlı) Web kancasının oluşturulduktan sonra etkin olmasını istiyorsanız "Etkin" onay kutusunu seçin. Alternatif olarak web kancasını daha sonra etkinleştirebilirsiniz.
- Kaydet'i tıklayın.
Web kancası oluşturuldu. Bunu Ayarlar > Olay İşleyicileri'nde bulabilirsiniz. Web kancasını oluşturma sırasında etkinleştirdiyseniz, bir sonraki desteklenen etkinlik gerçekleştiğinde web kancası tetiklenecek ve web kancası URL'sine bir istek gönderilecektir.
Web Kancalarını Değiştirme, Devre Dışı Bırakma ve Kaldırma¶
Bir web kancasını değiştirmek için:
- SolusVM 2'de oturum açın.
- Ayarlar > Olay İşleyicileri'ne gidin.
- Değiştirmek istediğiniz web kancasına karşılık gelen
simgesine tıklayın.
- İstediğiniz değişiklikleri yapın ve ardından Kaydet'i tıklayın.
Değişiklikler artık yürürlüktedir.
Bir web kancasını etkinleştirmek veya devre dışı bırakmak için:
- SolusVM 2'de oturum açın.
- Ayarlar > Olay İşleyicileri'ne gidin.
- Etkinleştirmek veya devre dışı bırakmak istediğiniz web kancasına karşılık gelen geçiş düğmesini tıklayarak "Etkin" (mavi) veya "Devre Dışı" (gri) görünmesini sağlayın.
Web kancası artık etkinleştirilmiştir (veya devre dışı bırakılmıştır).
Bir web kancasını silmek için:
- SolusVM 2'de oturum açın.
- Ayarlar > Olay İşleyicileri'ne gidin.
- Silmek istediğiniz web kancasına karşılık gelen
simgesine tıklayın ve ardından Sil'e tıklayın.
Web kancası silinir.
Web Kancaları Tarafından Aktarılan Parametrelerin Listesi¶
Bir web kancası her tetiklendiğinde, URL aracılığıyla aşağıdaki parametreleri iletir:
crId
crHostname
crStatus
(commissioning, configure_network, active, failed, unavailable)crLicenseType
(micro, mini, standard)serverId
sunucuIps
(örneğin, ["10.0.0.1","10.0.0.2"])serverHostname
serverUuid
serverStatus
(mevcut değil, başlatıldı, durduruldu, kullanılamıyor)userId
billingUserId
userEmail
userStatus
(aktif, kilitli, askıya alındı)userAllowedIps
(örneğin, ["10.0.0.1","10.0.0.2"])
Web Kancası Örneği¶
WHMCS'de bir bilgi işlem kaynağından diğerine taşınan sunucuların IP adreslerini otomatik olarak güncelleyecek bir web kancası oluşturabilirsiniz.
Web kancasını oluşturmak için:
-
WHMCS sunucunuza SSH aracılığıyla giriş yapın.
-
SolusVM 2 WHMCS eklentisiyle birlikte gönderilen
hook_example.php
dosyasını bulun. Dosyamodules/servers/solusvm2vps/
dizininde olmalıdır. -
Dosyanın bir kopyasını oluşturun ve ardından kopyayı düzenlemeye başlayın.
-
- satırdaki
exit();
öğesini kaldırın.
- satırdaki
-
Sırlarınızı
$securitySecrets
değişkenine ekleyin. -
SolusVM 2 yönetim düğümünüzün IP adreslerini
$connectionIPs
değişkenine ekleyin. -
Değişiklikleri Kaydet.
-
SolusVM 2'de oturum açın.
-
Ayarlar > Olay İşleyicileri'ne gidin ve ardından Web Kancası Ekle'yi tıklayın.
-
Web kancanıza benzersiz bir ad verin.
-
Düzenlenen komut dosyasının URL'sini belirtin.
-
Açılır menüden "Ek IP ekle veya kaldır" seçeneğini seçin.
-
Bu prosedürün 5. adımı sırasında betiğe eklediğiniz sırları belirtin:
{ "secret": "<your secret goes here>" }
-
"Etkin" onay kutusunu seçin ve ardından Kaydet'i tıklayın.
Artık bir sunucu her taşındığında, SolusVM 2'de WHMCS'de sunucunun IP adresini güncellemeye yönelik bir görev oluşturulacak.