मेरमैड.जीएस आर्किटेक्चर डायग्राम सिंटैक्स और लेआउट गाइड

एक आर्किटेक्चर डायग्राम सिस्टम आर्किटेक्ट्स और डेवोप्स टीमों द्वारा इंफ्रास्ट्रक्चर सेटअप, क्लाउड माइक्रोसर्विसेज और संरचनात्मक लेआउट कॉन्फ़िगरेशन को देखने के लिए उपयोग किए जाने वाले संरचित ब्लूप्रिंट प्रदान करता है। आर्किटेक्चर-बीटाइंजन, इस टेक्स्ट-आधारित टूल ने मैनुअल ड्रैगिंग उपकरणों को स्वचालित रूप से संरचनात्मक सेवा समूहों, डेटाबेस क्लस्टर, गेटवे और एज पाथ को साफ, पूर्वानुमानित सिस्टम लेआउट में व्यवस्थित करके प्रतिस्थापित कर दिया है।

बेसिक सिंटैक्स संरचना

प्रत्येक डायग्राम के साथ शुरू होता है आर्किटेक्चर-बीटा घोषणा हेडर। आप टेक्स्ट को अलग-अलग नोड तत्वों को परिभाषित करके भरते हैं, जिसमें सेवा कीवर्ड का उपयोग करते हैं, और सटीक दिशात्मक निर्देशांक पोर्ट (टीऊपर, बीनीचे, एलबाएं, आर) को कोलन और डबल डैश के बीच अलग किया गया है।

आर्किटेक्चर-बीटा
  सेवा गेटवे(इंटरनेट)[गेटवे लेबल]
  सेवा सर्वर(सर्वर)[एप्लिकेशन सर्वर]
  
  गेटवे:बी -- टी:सर्वर

सिंटैक्स संदर्भ

नीचे दी गई तालिका मेरमैड.जीएस में आर्किटेक्चर वर्कस्पेस मैप बनाने के लिए उपयोग किए जाने वाले प्राथमिक डेटा घटकों, फॉर्मेटिंग कीवर्ड्स और कनेक्टर विशेषताओं को विभाजित करती है।

उन्नत समूहन और पोर्ट किनारे रूटिंग

तत्वों के बीच लिंक के यात्रा के बारे में बिल्कुल नियंत्रण करने के लिए बिना गड़बड़ दिखने के लिए, संरचना इंजन को स्पष्ट पोर्ट बाइंडिंग की आवश्यकता होती है। संबंधित नोड्स को संरचनात्मक समूहों के भीतर व्यवस्थित किया जा सकता है ताकि प्रणाली की सीमाएं स्पष्ट हों।

1. सटीक पोर्ट बाइंडिंग नियम

आप एक कनेक्शन लाइन के घटक से निकलने और प्रवेश करने के स्थान को एक दाएं बिंदु और एक किनारे की दिशा फ्लैग (“T, B, L, R) को संबंधित नोड पहचानकर्ताओं के साथ जोड़कर निर्धारित करते हैं:

• db:R -- L:server : लाइन डेटाबेस के **दाएं** ओर से निकलती है और सीधी क्षैतिज रेखा के रूप में सर्वर के **बाएं** ओर प्रवेश करती है।
• db:T -- L:server : लाइन डेटाबेस के **ऊपरी** ओर से निकलती है और सीधे 90° के साफ कोने पर मुड़कर सर्वर के **बाएं** ओर प्रवेश करती है।
• src:B --> T:proc : लाइन स्रोत नोड के **नीचे** से निकलती है और दिशात्मक तीर के साथ प्रोसेसर के **ऊपरी** ओर तक नीचे जाती है।

2. समूहों के साथ प्रणालियों की संरचना

एक दृश्य समूह (जैसे एक वर्चुअल प्राइवेट क्लाउड या डेटाबेस क्लस्टर) घोषित करने के लिए, उपयोग करें group कीवर्ड, और इसे in संशोधक के माध्यम से नोड्स को निर्धारित करें:

संरचना-बीटा
  समूह क्लाउडनेटवर्क(क्लाउड)[निजी क्लाउड]
    सेवा ऑथ(सर्वर)[प्रमाणीकरण नोड] क्लाउडनेटवर्क में
    सेवा api(सर्वर)[API अंतिम बिंदु] क्लाउडनेटवर्क में

सहपाठी तत्वों को संरेखित करना (v11.16.0+)

जब कई अलग-अलग सेवाएं समान किनारे रूटिंग मार्गों का साझा करती हैं (उदाहरण के लिए, तीन अलग-अलग डेटा स्रोत एकल संदेश कार्यकर्ता में प्रवाहित हो रहे हैं), तो लेआउट एल्गोरिदम कभी-कभी उन्हें एक साथ बांध देता है। संरेखित पंक्ति और स्तंभ संरेखित करें निर्देश इंजन को उन सहपाठी तत्वों को एक विशिष्ट अक्ष रेखा के आर-पार समान रूप से वितरित करने के लिए बाध्य करते हैं।

वास्तुकला-बीटा
  सेवा src1(सर्वर)[स्रोत 1]
  सेवा src2(सर्वर)[स्रोत 2]
  सेवा proc(सर्वर)[प्रोसेसर हब]

  src1:B --> T:proc
  src2:B --> T:proc

  स्तंभ संरेखित करें src1 src2

वास्तविक दुनिया का नक्शा: माइक्रोसर्विस क्लस्टर नक्शा

यह नक्शा एक अत्यधिक लचीले, उद्यम स्तर के क्लाउड वास्तुकला को दर्शाता है। मुख्य API इंजन को केंद्रित करने और प्राथमिकता और असमान तरीके से कार्य करने वाले कार्यों को इसके दोनों ओर क्षैतिज रूप से शाखाओं में बांटने के द्वारा, व्यवस्था सममित डिजाइन सिद्धांतों का उपयोग करती है ताकि ओवरलैपिंग रेखाओं को रोका जा सके। पूरी डेटा प्रवाह साफ तरीके से नीचे जाता है, जहां सार्वजनिक गेटवे से एक स्पष्ट रूप से संरेखित डेटा स्टोरेज लेयर में जाता है, दोहरे का उपयोग करते हुएपंक्ति संरेखित करें निर्देशों के लिए घटकों को तीखे, पूर्वानुमानित क्षैतिज ट्रैक में बंद करने के लिए।

वास्तुकला-बीटा
  शीर्षक "उच्च उपलब्धता माइक्रोसर्विस वास्तुकला"

  %% बाहरी प्रवेश स्तर
  सेवा cloudflare(internet)[Cloudflare WAF]
  सेवा alb(सर्वर)[AWS एप्लीकेशन लोड बैलेंसर]

  %% मुख्य एप्लीकेशन क्लस्टर
  समूह appCluster(बादल)[प्रबंधित EKS माइक्रोसर्विसेज]
    सेवा authService(सर्वर)[प्रमाणीकरण सेवा] in appCluster
    सेवा apiService(सर्वर)[मुख्य API इंजन] in appCluster
    सेवा workerNode(सर्वर)[असिंक्रोनस कार्य कार्यकर्ता] in appCluster

  %% सुरक्षित भंडारण स्तर
  समूह dataCluster(डेटाबेस)[सुरक्षित डेटा परत]
    सेवा redis(डिस्क)[Redis कैश क्लस्टर] in dataCluster
    सेवा postgres(डेटाबेस)[PostgreSQL प्राथमिक] in dataCluster

  %% 1. ऊर्ध्वाधर प्रवाह: सार्वजनिक से नीचे कंप्यूटिंग कोर तक ट्रैफिक प्रवेश
  cloudflare:B --> T:alb
  alb:B --> T:apiService

  %% 2. क्षैतिज प्रवाह: मुख्य API बाएं और दाएं ओर सममित रूप से शाखाएं बांटता है
  apiService:L --> R:authService
  apiService:R --> L:workerNode

  %% 3. आधार रेखा प्रवाह: एप्लीकेशन कार्यकर्ता सीधे संबंधित डेटा स्लॉट में गिरते हैं
  authService:B --> T:redis
  workerNode:B --> T:postgres

  %% एक आदर्श ग्रिड ग्रिड के लिए लेआउट अक्ष संरेखण
  पंक्ति संरेखित करें authService apiService workerNode
  पंक्ति संरेखित करें redis postgres

सामान्य सिंटैक्स गलतियाँ और सिस्टम सीमाएं

जब इंफ्रास्ट्रक्चर कोड लिखते हैं, तो विशिष्ट विन्यास सत्यापन नियमों को ध्यान में रखें ताकि पार्सिंग त्रुटियों से बचा जा सके:

• लेबल ब्रैकेट क्रम: प्रदर्शन टेक्स्ट स्ट्रिंग्स का उपयोग स्क्वायर ब्रैकेट करना चाहिए [लेबल पाठ] और आइकन पैरेंथेसिस के तुरंत बाद बिना अंतराल के अनुसरण करें: सेवा id(सर्वर)[पाठ] सही है। कोष्ठक के भीतर उद्धरण चिह्नों का उपयोग करने से पार्सर खराब हो जाएगा।
• पोर्ट केस संवेदनशीलता: कनेक्शन एज पोर्ट एंकर को उच्च अक्षरों में लिखा जाना चाहिए (T, B, L, आर). छोटे अक्षर (टी, बी, एल, आर) पहचाने नहीं जाते हैं और लेआउट जनरेशन क्रैश का कारण बनेंगे।
• पूर्व घोषणा नियम: किसी एज पाथवे डिक्लेरेशन में उपयोग किए जाने वाले प्रत्येक नोड या जंक्शन आईडी को उसके ऊपर अलग लाइन पर स्पष्ट रूप से घोषित किया जाना चाहिए। एक अप्रत्यक्ष नोड नाम से कनेक्ट करने की कोशिश करने पर बिल्ड फेल हो जाएगी।
• एलाइन मेम्बर सीमाएं: जब एलाइन रो या एलाइन कॉलम पोजीशनिंग निर्देशों का उपयोग करते समय, आपको कम से कम दो या अधिक वैध, पहले घोषित सेवा या जंक्शन आईडी कमांड लाइन पर प्रदान करनी होगी।