
⏰ 🔥 नेटवर्क और सिस्टम स्थितियों का अनुकरण करने के लिए एक TCP प्रॉक्सी, जो कैओस और रेज़िलिएंसी परीक्षण के लिए है
Toxiproxy नेटवर्क स्थितियों के अनुकरण के लिए एक फ्रेमवर्क है। इसे विशेष रूप से परीक्षण, CI और विकास वातावरण में काम करने के लिए बनाया गया है, जो कनेक्शनों के साथ नियतात्मक छेड़छाड़ का समर्थन करता है, साथ ही यादृच्छिक अराजकता और अनुकूलन के लिए समर्थन प्रदान करता है। Toxiproxy वह उपकरण है जिसकी आपको अपने एप्लिकेशन में एकल विफलता बिंदु न होने को परीक्षणों के माध्यम से सिद्ध करने के लिए आवश्यकता है। हम अक्टूबर 2014 से Shopify में सभी विकास और परीक्षण वातावरणों में इसका सफलतापूर्वक उपयोग कर रहे हैं। अधिक जानकारी के लिए लचीलेपन पर हमारी [ब्लॉग पोस्ट][blog] देखें।
Toxiproxy का उपयोग दो भागों से मिलकर बनता है। Go में लिखा गया एक TCP प्रॉक्सी (जो यह रिपॉज़िटरी शामिल करती है) और एक क्लाइंट जो HTTP के माध्यम से प्रॉक्सी से संचार करता है। आप अपने एप्लिकेशन को कॉन्फ़िगर करते हैं ताकि सभी परीक्षण कनेक्शन Toxiproxy के माध्यम से जाएँ और फिर HTTP के माध्यम से उनके स्वास्थ्य में हेरफेर कर सकते हैं। अपने प्रोजेक्ट को सेट अप करने के तरीके के लिए नीचे उपयोग देखें।
उदाहरण के लिए, Ruby क्लाइंट से MySQL की प्रतिक्रिया में 1000ms की विलंबता जोड़ने के लिए:
Toxiproxy[:mysql_master].downstream(:latency, latency: 1000).apply do
Shop.first # this takes at least 1s
end
सभी Redis इंस्टेंस को बंद करने के लिए:
Toxiproxy[/redis/].down do
Shop.first # this will throw an exception
end
जबकि इस README में उदाहरण वर्तमान में Ruby में हैं, आपको किसी अन्य भाषा में क्लाइंट बनाने से कोई नहीं रोक रहा है (देखें क्लाइंट)।
हमें जो मौजूदा प्रॉक्सी मिलीं, वे इंटीग्रेशन और यूनिट टेस्टिंग के लिए आवश्यक गतिशील API प्रदान नहीं करती थीं। nc जैसे Linux टूल्स क्रॉस-प्लेटफ़ॉर्म नहीं हैं और इनके लिए root आवश्यक होता है, जिससे ये टेस्ट, डेवलपमेंट और CI वातावरण में समस्याग्रस्त हो जाते हैं।
आइए एक Rails एप्लिकेशन के साथ एक उदाहरण देखें। ध्यान दें कि Toxiproxy किसी भी तरह से Ruby से जुड़ा नहीं है, यह बस हमारा पहला उपयोग मामला था। आप पूरा उदाहरण sirupsen/toxiproxy-rails-example पर देख सकते हैं। तुरंत शुरू करने के लिए, नीचे उपयोग पर जाएं।
हमारे लोकप्रिय ब्लॉग के लिए, किसी कारण से हम अपनी पोस्ट के टैग Redis में और पोस्ट स्वयं MySQL में संग्रहीत कर रहे हैं। हमारे पास एक Post क्लास हो सकती है जिसमें Redis सेट में टैग में हेरफेर करने के लिए कुछ मेथड्स शामिल हों:
class Post < ActiveRecord::Base
# Return an Array of all the tags.
def tags
TagRedis.smembers(tag_key)
end
# Add a tag to the post.
def add_tag(tag)
TagRedis.sadd(tag_key, tag)
end
# Remove a tag from the post.
def remove_tag(tag)
TagRedis.srem(tag_key, tag)
end
# Return the key in Redis for the set of tags for the post.
def tag_key
"post:tags:#{self.id}"
end
end
हमने तय किया है कि टैग डेटा स्टोर में लिखते समय (जोड़ते/हटाते समय) त्रुटि होना ठीक है। हालाँकि, यदि टैग डेटा स्टोर डाउन है, तो हमें पोस्ट को बिना टैग के देख पाना चाहिए। हम tags मेथड में SMEMBERS Redis कॉल के आसपास Redis::CannotConnectError को आसानी से rescue कर सकते हैं। आइए इसे टेस्ट करने के लिए Toxiproxy का उपयोग करें।
चूँकि हम पहले ही Toxiproxy इंस्टॉल कर चुके हैं और यह हमारी मशीन पर चल रहा है, हम सीधे स्टेप 2 पर जा सकते हैं। यहाँ हमें यह सुनिश्चित करना है कि Toxiproxy के पास Redis टैग के लिए एक मैपिंग हो। config/boot.rb में (कोई भी कनेक्शन बनने से पहले) हम जोड़ते हैं:
require 'toxiproxy'
Toxiproxy.populate([
{
name: "toxiproxy_test_redis_tags",
listen: "127.0.0.1:22222",
upstream: "127.0.0.1:6379"
}
])
फिर config/environments/test.rb में हम TagRedis को एक Redis क्लाइंट के रूप में सेट करते हैं जो इस पंक्ति को जोड़कर Toxiproxy के माध्यम से Redis से कनेक्ट होता है:
TagRedis = Redis.new(port: 22222)
परीक्षण वातावरण में सभी कॉल अब Toxiproxy के माध्यम से जाते हैं। इसका मतलब है कि हम एक यूनिट परीक्षण जोड़ सकते हैं जहाँ हम एक विफलता का अनुकरण करते हैं:
test "should return empty array when tag redis is down when listing tags" do
@post.add_tag "mammals"
# Take down all Redises in Toxiproxy
Toxiproxy[/redis/].down do
assert_equal [], @post.tags
end
end
परीक्षण Redis::CannotConnectError के साथ विफल हो जाता है। बिल्कुल सही! Toxiproxy ने क्लोज़र की अवधि के लिए Redis को सफलतापूर्वक डाउन कर दिया। आइए tags विधि को लचीला बनाने के लिए ठीक करें:
def tags
TagRedis.smembers(tag_key)
rescue Redis::CannotConnectError
[]
end
परीक्षण पास हो गए हैं! अब हमारे पास एक यूनिट टेस्ट है जो साबित करता है कि जब Redis डाउन हो तो टैग्स फ़ेच करने पर अपवाद फेंकने के बजाय एक खाली ऐरे लौटता है। पूर्ण कवरेज के लिए आपको एक इंटीग्रेशन टेस्ट भी लिखना चाहिए जो Redis डाउन होने पर पूरे ब्लॉग पोस्ट पेज को फ़ेच करने को रैप करता हो।
पूरा उदाहरण एप्लिकेशन sirupsen/toxiproxy-rails-example पर है।
किसी प्रोजेक्ट को Toxiproxy का उपयोग करने के लिए कॉन्फ़िगर करने में तीन चरण होते हैं:
Linux
अपनी आर्किटेक्चर के लिए नवीनतम बाइनरीज़ और सिस्टम पैकेज के लिए Releases देखें।
Ubuntu
$ wget -O toxiproxy-2.13.0.deb https://github.com/Shopify/toxiproxy/releases/download/v2.13.0/toxiproxy_2.13.0_linux_amd64.deb
$ sudo dpkg -i toxiproxy-2.13.0.deb
$ sudo service toxiproxy start
OS X
Homebrew के साथ:
$ brew tap shopify/shopify
$ brew install toxiproxy
या MacPorts के साथ:
$ port install toxiproxy
Windows