حل خطأ getaddrinfo ENOTFOUND لتطبيق Dockerized مع SQL Server

معالجة أخطاء اتصال التطبيق Dockerized مع SQL Server

Node.js مع Docker - استخدام متغيرات البيئة وتكوين الشبكة

// Backend Script: Connecting to SQL Server with Environment Variables
// This solution leverages environment variables to configure database access in Node.js.
// Ensure that Docker Compose or Dockerfile properly defines network aliases for your services.
// Test each component in both local and containerized environments.

const sql = require('mssql');
require('dotenv').config();

// Configuration options using environment variables for reusability and security.
const config = {
    user: process.env.DB_USER,
    password: process.env.DB_PASS,
    server: process.env.DB_HOST || 'name_server', // Host alias as set in Docker network
    database: process.env.DB_NAME,
    options: {
        encrypt: true, // For secure connections
        trustServerCertificate: true // Self-signed certificates allowed for dev
    }
};

// Function to connect and query the database
async function connectDatabase() {
    try {
        await sql.connect(config);
        console.log("Database connection established successfully.");
    } catch (err) {
        console.error("Connection failed:", err.message);
    }
}

connectDatabase();

استخدام Docker Compose لمعالجة مشكلات الشبكة لاتصالات SQL Server

Docker Compose - إعداد متعدد الحاويات لـ Node.js وSQL Server

# This Docker Compose file defines two services: app (Node.js) and db (SQL Server)
# The app uses the db's container alias for network resolution.

version: '3.8'
services:
  app:
    build: .
    environment:
      - DB_USER=${DB_USER}
      - DB_PASS=${DB_PASS}
      - DB_HOST=db < !-- Alias used here -->
      - DB_NAME=${DB_NAME}
    depends_on:
      - db
  db:
    image: mcr.microsoft.com/mssql/server
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=${DB_PASS}
    ports:
      - "1433:1433"

اختبار الاتصال باستخدام اختبارات الوحدة

Jest - اتصال قاعدة بيانات اختبار الوحدة

// Test Script: Unit test to verify connection handling in multiple environments
const sql = require('mssql');
const config = require('./config'); // Config from environment setup

describe("Database Connection Tests", () => {
    it("should connect to the database successfully", async () => {
        try {
            const pool = await sql.connect(config);
            expect(pool.connected).toBeTruthy();
        } catch (err) {
            throw new Error("Connection failed: " + err.message);
        }
    });
});

الحل البديل: معالجة الأخطاء وإعادة محاولة المنطق

Node.js - آلية إعادة المحاولة لاتصالات قاعدة البيانات المرنة

const sql = require('mssql');
const config = require('./config');

// Retry wrapper function to handle transient network issues in Docker
async function connectWithRetry(retries = 5) {
    for (let i = 0; i < retries; i++) {
        try {
            await sql.connect(config);
            console.log("Connected to database.");
            return;
        } catch (err) {
            if (i === retries - 1) throw err;
            console.warn("Retrying connection...");
            await new Promise(res => setTimeout(res, 2000)); // Wait before retry
        }
    }
}

connectWithRetry();

الأسئلة الشائعة حول مشكلات اتصال خادم SQL Dockerized

1. ما الذي يسبب خطأ getaddrinfo ENOTFOUND في تطبيقات Dockerized؟
2. ينبع هذا الخطأ عادةً من مشكلات تحليل DNS داخل Docker، حيث لا يستطيع التطبيق تحليل اسم المضيف لخادم SQL Server. غالبًا ما تحتاج إعدادات شبكة Docker المعزولة إلى التكوين لتمكين الوصول الموثوق لاسم المضيف.
3. كيف يمكنني جعل خادم SQL الخاص بي قابلاً للوصول عن طريق اسم المضيف في Docker؟
4. يستخدم Docker Compose مع الخدمات المسماة، مثل تعريف SQL Server الخاص بك باسم "db"، ثم الوصول إليه عبر هذا الاسم المستعار. يضيف Docker هذا تلقائيًا إلى DNS الداخلي الخاص به، مما يساعد في حل أسماء المضيفين داخل شبكة Docker.
5. لماذا يعمل تطبيقي محليًا ولكن ليس في Docker؟
6. محليًا، يستخدم تطبيقك نظام DNS لحل أسماء المضيفين، بينما في Docker، يستخدم شبكة داخل حاوية. بدون التكوين المناسب، قد لا يتمكن Docker من تحديد موقع SQL Server، مما يؤدي إلى حدوث أخطاء.
7. ما الدور الذي يلعبه الأمرdependent_on في Docker Compose؟
8. ال depends_on يساعد الأمر في التحكم في ترتيب بدء تشغيل الخدمات. على سبيل المثال، يؤدي التأكد من بدء تشغيل SQL Server قبل التطبيق إلى منع حدوث أخطاء في الاتصال أثناء التهيئة.
9. هل يجب أن أستخدم عمليات إعادة المحاولة لاتصالات قاعدة البيانات الخاصة بي في Docker؟
10. نعم! يمكن أن يكون تنفيذ آلية إعادة المحاولة، مع تأخير بسيط، فعالاً للغاية في التعامل مع الحالات التي تستغرق فيها حاوية قاعدة البيانات وقتًا إضافيًا لتصبح قابلة للوصول بشكل كامل.
11. هل يمكنني الوصول إلى خادم SQL خارجي من حاوية Docker؟
12. نعم، ولكن قد تحتاج شبكة Docker إلى تكوين إضافي. يمكن أن يساعد استخدام شبكات الجسر أو إضافة عناوين IP ثابتة في وصول تطبيقات Dockerized إلى خوادم SQL غير تابعة لـ Docker.
13. هل هناك طريقة لاختبار اتصال تطبيق Dockerized الخاص بي بـ SQL Server؟
14. قطعاً. يمكنك كتابة اختبارات الوحدة باستخدام مكتبات مثل Jest في Node.js للتحقق من أن التطبيق يتصل بشكل صحيح، محليًا وداخل Docker.
15. ما سبب أهمية تكوين شبكة Docker لتطبيقات SQL Server؟
16. يمكن أن يؤدي عزل شبكة Docker إلى منع الخدمات من اكتشاف بعضها البعض، مما يؤثر على اتصالات SQL Server. يساعد تكوين خيارات الشبكة على ضمان إمكانية وصول التطبيق إلى قاعدة البيانات باستمرار.
17. هل يمكنني استخدام متغيرات البيئة لإدارة إعدادات قاعدة البيانات في Docker؟
18. نعم، يوصى بمتغيرات البيئة لتخزين المعلومات الحساسة بشكل آمن، كما أنها تجعل من السهل ضبط التكوينات لبيئات مختلفة.
19. ما هو دور شبكات الجسر في اتصالات Docker SQL Server؟
20. تسمح شبكات Bridge للحاويات بالاتصال داخل نفس الجهاز المضيف، وهو أمر مفيد لتطبيقات Docker التي تحتاج إلى الوصول إلى خدمات خارجية مثل SQL Server بدون شبكات معقدة.
21. كيف أتعامل مع مشكلات التخزين المؤقت لـ Docker DNS؟
22. لتجنب مشكلات التخزين المؤقت، تأكد من تحديث DNS بشكل مناسب. في بعض الحالات، يمكن أن تساعد إعادة تشغيل البرنامج الخفي Docker أو تكوين TTL (مدة البقاء) لذاكرة التخزين المؤقت لنظام أسماء النطاقات الخاصة بـ Docker.

اختتام رحلة استكشاف الأخطاء وإصلاحها

معالجة قضايا الشبكة في Docker قد يبدو الأمر مرهقًا، خاصة مع SQL Server. من خلال إعداد الأسماء المستعارة للشبكة والاعتماد على Docker Compose للتحكم في ترتيب بدء التشغيل، يمكنك مساعدة تطبيقك على التواصل بسلاسة مع قاعدة البيانات. كل من هذه التعديلات ستجعل بيئة Dockerized الخاصة بك أكثر مرونة.

بالإضافة إلى ذلك، فإن دمج عمليات إعادة المحاولة والمعالجة القوية للأخطاء يجعل التطبيق موثوقًا به، حتى لو بدأت الخدمات في أوقات مختلفة. باستخدام أفضل الممارسات هذه، يمكنك الحفاظ على موثوقية التطوير المحلي ضمن إعداد حاوية، مما يقلل الأخطاء مثل ENOTFOUND ويضمن اتصالات سلسة لقاعدة البيانات لتطبيقات Docker الخاصة بك. 🚀