اسپرنگ بوٹ 3.3.4 کی مونگو ڈی بی ہیلتھ چیک کی ناکامی کو ٹھیک کرنا: "ایسا کوئی حکم نہیں: 'ہیلو'" خرابی

موسم بہار کے بوٹ اپ گریڈ کے بعد مونگو ڈی بی ہیلتھ چیک کے مسئلے کو حل کرنا

اسپرنگ بوٹ ایپلیکیشن کو ورژن 3.3.3 سے 3.3.4 تک منتقل کرتے وقت، ڈویلپرز کو غیر متوقع غلطیوں کا سامنا کرنا پڑ سکتا ہے۔ ایسے ہی ایک مسئلے میں MongoDB کے لیے ہیلتھ چیک اینڈ پوائنٹ شامل ہے، جو پہلے ورژن 3.3.3 میں بغیر کسی رکاوٹ کے کام کرتا تھا۔ اپ گریڈ کرنے پر، ہیلتھ چیک ٹیسٹ ناکام ہو جاتا ہے، جس کے نتیجے میں ایک گمشدہ کمانڈ کے بارے میں ایک خرابی پیدا ہوتی ہے: 'ہیلو'۔

یہ مسئلہ یونٹ ٹیسٹوں کے عمل کے دوران پیدا ہوتا ہے جو اسپرنگ بوٹ پروجیکٹ میں استعمال ہونے والے ایمبیڈڈ MongoDB ڈیٹا بیس کی صحت کی نگرانی کرتے ہیں۔ خاص طور پر، خرابی اس وقت ہوتی ہے جب `/ایکچیویٹر/ہیلتھ` اینڈ پوائنٹ کی جانچ کی جاتی ہے، جو اسپرنگ بوٹ ایکچوایٹر کا استعمال کرتے ہوئے مائیکرو سروسز کے لیے صحت کی جانچ کا ایک معیاری راستہ ہے۔ یہ مسئلہ پچھلے ورژن میں سامنے نہیں آیا، اس ناکامی کو حیران کن بنا دیا۔

ایسا لگتا ہے کہ اس خرابی کی بنیادی وجہ MongoDB ورژن میں ہونے والی تبدیلیوں سے پیدا ہوئی ہے۔ 'ہیلو' کمانڈ کو مونگو ڈی بی 5.0 سے شروع کیا گیا تھا، لیکن پروجیکٹ میں ایمبیڈڈ مونگو ڈی بی لائبریریاں اب بھی ایسا ورژن استعمال کر رہی ہیں جو اس کمانڈ کو سپورٹ نہیں کرتا ہے۔ لہذا، صحت کی جانچ ناکام ہوجاتی ہے کیونکہ یہ اس غیر تعاون یافتہ کمانڈ کو کال کرنے کی کوشش کرتا ہے۔

اس مسئلے کو حل کرنے کے لیے، ڈویلپرز کو یا تو ایمبیڈڈ MongoDB کو 'ہیلو' کمانڈ کے ساتھ مطابقت رکھنے والے ورژن میں اپ گریڈ کرنے کی ضرورت ہے یا 'ہیلو' کمانڈ کو مکمل طور پر استعمال کرنے سے بچنے کے لیے اسپرنگ بوٹ میں ہیلتھ چیک کنفیگریشن کو تبدیل کرنا ہوگا۔ آئیے اس مطابقت کے مسئلے کو حل کرنے میں شامل اقدامات کو دریافت کریں۔

Spring Boot Actuator کے ساتھ MongoDB ہیلتھ چیک کو سمجھنا

پہلا اسکرپٹ اسپرنگ بوٹ ہیلتھ چیک کنفیگریشن میں ترمیم کرتا ہے تاکہ اس مسئلے کو ہینڈل کیا جا سکے۔ مونگو ڈی بی کمانڈ "ہیلو" کو تسلیم نہیں کیا گیا ہے۔ یہ مسئلہ اس وقت ہوتا ہے جب MongoDB کے پرانے ورژن استعمال کرتے ہیں جو 'ہیلو' کمانڈ کو سپورٹ نہیں کرتے ہیں، جو MongoDB 5.0 میں متعارف کرایا گیا تھا۔ حل میں، ہم اپنی مرضی کے مطابق بناتے ہیں MongoHealthIndicator جو Spring Boot Actuator فریم ورک کے ساتھ ضم ہوتا ہے۔ @Bean تشریح کا استعمال کرتے ہوئے، ہم غیر تعاون یافتہ کمانڈ پر انحصار کرنے والے پہلے سے طے شدہ نفاذ کو نظرانداز کرتے ہوئے، MongoDB کے لیے ایک حسب ضرورت ہیلتھ چیک میکانزم لگا سکتے ہیں۔ یہ نقطہ نظر اس بات کو یقینی بناتا ہے کہ فرسودہ کمانڈ سپورٹ کی وجہ سے خرابیاں پیدا کیے بغیر صحت کی صورتحال درست رہے۔

دوسری اسکرپٹ میں، ہم ایمبیڈڈ MongoDB ورژن کو اپ گریڈ کرنے پر توجہ مرکوز کرتے ہیں۔ ماون پی او ایم فائل ایمبیڈڈ MongoDB بنیادی طور پر یونٹ ٹیسٹ چلانے کے لیے استعمال ہوتا ہے، جس کو ہیلتھ چیک اینڈ پوائنٹ کو سپورٹ کرنے کی ضرورت ہوتی ہے جو 'ہیلو' کمانڈ کو متحرک کرتا ہے۔ mongo-java-server لائبریری کے ورژن 1.47.0 میں اپ گریڈ کرکے، ہم اس بات کو یقینی بناتے ہیں کہ ایمبیڈڈ MongoDB مثال 'ہیلو' کمانڈ کو تسلیم کرتی ہے، جو مطابقت کے مسئلے کو حل کرتی ہے۔ یہ حل ایسے ماحول کے لیے موثر ہے جہاں حقیقی MongoDB سرور کو اپ گریڈ کرنا ممکن ہے اور ترقی اور جانچ کے ماحول کے درمیان مستقل مزاجی کو برقرار رکھنے میں مدد کرتا ہے۔

تیسرا اسکرپٹ یہ ظاہر کرتا ہے کہ JUnit ٹیسٹ کے ساتھ ہیلتھ چیک اینڈ پوائنٹ کی توثیق کیسے کی جائے۔ یہ ٹیسٹ استعمال کرتا ہے۔ MockMvc ایک HTTP GET درخواست کی نقل کرنے کے لیے فریم ورک /ایکچیویٹر/صحت اختتامی نقطہ andDo() طریقہ استعمال کرکے، ٹیسٹ جواب کو حاصل کرتا ہے اور اس بات کی تصدیق کرتا ہے کہ آیا MongoDB کی صحت کی حیثیت کو 'UP' کے طور پر نشان زد کیا گیا ہے۔ یہ یقینی بناتا ہے کہ کسٹم ہیلتھ انڈیکیٹر یا اپ گریڈ شدہ MongoDB صحیح طریقے سے کام کر رہا ہے۔ اگر اسٹیٹس 'UP' نہیں ہے، تو ٹیسٹ ناکام ہو جائے گا، جس سے ڈویلپر کو MongoDB کنکشن یا ہیلتھ چیک کنفیگریشن کے ممکنہ مسائل سے آگاہ کیا جائے گا۔

ہر اسکرپٹ نہ صرف MongoDB ہیلتھ چیک کی ناکامی کا حل فراہم کرتا ہے بلکہ ماڈیولر اور قابل جانچ کوڈ کی اہمیت کو بھی ظاہر کرتا ہے۔ اچھی طرح سے تشکیل شدہ اسپرنگ بوٹ کنفیگریشن کا استعمال کرکے اور یونٹ ٹیسٹ، ہم اس بات کو یقینی بنا سکتے ہیں کہ درخواست مختلف ماحول میں قابل اعتماد طریقے سے برتاؤ کرتی ہے۔ یہ اسکرپٹس مونگو ڈی بی جیسے بیرونی نظاموں کو مربوط کرتے وقت غلطی سے نمٹنے اور توثیق کی ضرورت کو بھی اجاگر کرتی ہیں، خاص طور پر ایسی ایپلی کیشنز میں جہاں اپ ٹائم اور صحت کی نگرانی بہت ضروری ہے۔ انحصار کو اپ گریڈ کرنے اور صحت کی جانچ کو حسب ضرورت بنانے کا مجموعہ اس عام مسئلے کو حل کرنے کے لیے ایک مضبوط اور لچکدار طریقہ پیش کرتا ہے۔

// Backend approach using Java and Spring Boot to modify the health check
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.boot.actuate.health.MongoHealthIndicator;
import org.springframework.boot.actuate.health.HealthIndicator;
import com.mongodb.MongoClient;
@Configuration
public class MongoHealthCheckConfig {
    @Bean
    public HealthIndicator mongoHealthIndicator(MongoClient mongoClient) {
        return new MongoHealthIndicator(mongoClient);
    }
}
// The MongoClient bean is injected to use a custom health check implementation.
// The 'hello' command error can now be handled with newer MongoDB versions.

// Modify the POM file to update the embedded MongoDB version
<dependency>
  <groupId>de.bwaldvogel</groupId>
  <artifactId>mongo-java-server</artifactId>
  <version>1.47.0</version> < !-- Upgrade to newer version -->
  <scope>test</scope>
</dependency>
// This ensures MongoDB supports the 'hello' command, used in the Spring Boot health checks.
// Version 1.47.0 is compatible with MongoDB 5.0+ commands.

// JUnit test for MongoDB health check in Spring Boot
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;
@SpringBootTest
public class MongoHealthCheckTest {
    @Autowired
    private MockMvc mockMvc;
    @Test
    public void shouldReturnUpStatus() throws Exception {
        mockMvc.perform(get("/actuator/health"))
               .andExpect(status().isOk())
               .andDo(result -> {
                   String response = result.getResponse().getContentAsString();
                   assertTrue(response.contains("UP"));
               });
    }
}
// This test checks if MongoDB health status is correctly reported as 'UP' in Spring Boot.

مونگو ڈی بی ہیلتھ چیک کی ناکامیوں کو مطابقت کے حل کے ساتھ حل کرنا

کے ساتھ کام کرتے وقت مونگو ڈی بی اور صحت کی جانچ کے لیے اسپرنگ بوٹ ایکچوایٹر، ایک اہم پہلو جس پر غور کرنا ہے وہ ہے MongoDB کے مختلف ورژنز اور ان کی حمایت کردہ کمانڈز کے درمیان مطابقت۔ "ہیلو" کمانڈ، جو MongoDB 5.0 میں متعارف کرائی گئی ہے، نئی اسپرنگ بوٹ ایپلی کیشنز میں صحت کی جانچ کے عمل کا ایک اہم حصہ ہے۔ تاہم، اگر آپ 5.0 سے پرانا ایمبیڈڈ MongoDB ورژن استعمال کر رہے ہیں، تو اس کمانڈ کو تسلیم نہیں کیا جائے گا، جس کی وجہ سے صحت کی جانچ میں ناکامی ہوگی۔

اس بات کو یقینی بنانے کے لیے کہ اسپرنگ بوٹ ایکچوایٹر ہیلتھ چیک صحیح طریقے سے کام کرتا ہے، ڈویلپرز کے پاس دو اہم اختیارات ہیں: ایک MongoDB ورژن میں اپ گریڈ کرنا جو "ہیلو" کمانڈ کو سپورٹ کرتا ہے، یا پرانے MongoDB کمانڈز کو استعمال کرنے کے لیے ہیلتھ چیک کنفیگریشن کو اپنی مرضی کے مطابق بنانا۔ ایسے حالات میں جہاں MongoDB کو اپ گریڈ کرنا ممکن نہیں ہے، غیر تعاون یافتہ کمانڈز کو نظرانداز کرنے کے لیے ہیلتھ چیک منطق میں ترمیم کرنا ایک قابل عمل حل ہو سکتا ہے۔ یہ سسٹم اپ ٹائم مانیٹرنگ کو برقرار رکھتے ہوئے ٹیسٹ کی ناکامیوں کو روکتا ہے۔

ایک اور اہم غور صحیح ماحول کے ساتھ یونٹ ٹیسٹ چلانا ہے۔ ایمبیڈڈ MongoDB مثال کے استعمال کے لیے، خاص طور پر ٹیسٹوں میں، صحت کی جانچ میں استعمال ہونے والے کمانڈز سے MongoDB کے ورژن کو ملانے کی ضرورت ہوتی ہے۔ اس بات کو یقینی بنانا کہ آپ کا ٹیسٹ ماحول اور پیداواری ماحول دونوں یکساں خصوصیات کی حمایت کرتے ہیں، ٹیسٹ کے نتائج اور حقیقی دنیا کی کارکردگی کے درمیان تضادات سے بچنے میں مدد ملتی ہے، خاص طور پر صحت کی رپورٹنگ کے لیے Actuator اینڈ پوائنٹس پر انحصار کرنے والی مائیکرو سروسز میں۔