Giải quyết lỗi getaddrinfo ENOTFOUND của ứng dụng Dockerized với SQL Server

Xử lý lỗi kết nối ứng dụng được Dockerized với SQL Server

Node.js với Docker - Sử dụng biến môi trường và cấu hình mạng

// 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();

Sử dụng Docker Compose để xử lý các sự cố mạng cho kết nối máy chủ SQL

Docker Compose - Thiết lập nhiều vùng chứa cho Node.js và 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"

Kiểm tra kết nối bằng cách sử dụng bài kiểm tra đơn vị

Jest - Kết nối cơ sở dữ liệu thử nghiệm đơn vị

// 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);
        }
    });
});

Giải pháp thay thế: Xử lý lỗi và thử lại logic

Node.js - Cơ chế thử lại cho các kết nối cơ sở dữ liệu linh hoạt

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();

Các câu hỏi thường gặp về các vấn đề kết nối máy chủ SQL được Docker hóa

1. Điều gì gây ra lỗi getaddrinfo ENOTFOUND trong ứng dụng Dockerized?
2. Lỗi này thường xuất phát từ các sự cố phân giải DNS trong Docker, nơi ứng dụng không thể phân giải tên máy chủ của SQL Server. Cài đặt mạng bị cô lập của Docker thường cần cấu hình để cho phép truy cập tên máy chủ đáng tin cậy.
3. Làm cách nào tôi có thể truy cập Máy chủ SQL của mình bằng tên máy chủ trong Docker?
4. Sử dụng Docker Compose với các dịch vụ được đặt tên, chẳng hạn như xác định Máy chủ SQL của bạn là “db” và sau đó truy cập nó qua bí danh đó. Docker tự động thêm thông tin này vào DNS nội bộ của nó, giúp phân giải tên máy chủ trong mạng Docker.
5. Tại sao ứng dụng của tôi hoạt động cục bộ nhưng không hoạt động trong Docker?
6. Ở cục bộ, ứng dụng của bạn sử dụng DNS hệ thống để phân giải tên máy chủ, trong khi ở Docker, ứng dụng sử dụng mạng được chứa trong vùng chứa. Nếu không cấu hình phù hợp, Docker có thể không định vị được SQL Server, dẫn đến lỗi.
7. Lệnh phụ thuộc có vai trò gì trong Docker Compose?
8. các depends_on lệnh giúp kiểm soát thứ tự khởi động của dịch vụ. Ví dụ: đảm bảo SQL Server khởi động trước ứng dụng sẽ ngăn lỗi kết nối trong quá trình khởi tạo.
9. Tôi có nên thử lại cho các kết nối cơ sở dữ liệu của mình trong Docker không?
10. Đúng! Việc triển khai cơ chế thử lại, với độ trễ nhỏ, có thể rất hiệu quả trong việc xử lý các trường hợp trong đó vùng chứa cơ sở dữ liệu cần thêm thời gian để có thể truy cập đầy đủ.
11. Tôi có thể truy cập Máy chủ SQL bên ngoài từ bộ chứa Docker không?
12. Có, nhưng mạng Docker có thể cần cấu hình bổ sung. Sử dụng mạng cầu nối hoặc thêm IP tĩnh có thể giúp các ứng dụng Dockerized tiếp cận các Máy chủ SQL không phải Docker.
13. Có cách nào để kiểm tra kết nối ứng dụng Dockerized của tôi với SQL Server không?
14. Tuyệt đối. Bạn có thể viết bài kiểm tra đơn vị bằng các thư viện như Jest trong Node.js để xác thực rằng ứng dụng kết nối chính xác, cả cục bộ và trong Docker.
15. Tại sao cấu hình mạng của Docker lại quan trọng đối với ứng dụng SQL Server?
16. Việc cách ly mạng của Docker có thể ngăn các dịch vụ phát hiện lẫn nhau, ảnh hưởng đến kết nối SQL Server. Định cấu hình tùy chọn mạng giúp đảm bảo ứng dụng có thể truy cập cơ sở dữ liệu một cách nhất quán.
17. Tôi có thể sử dụng biến môi trường để quản lý cài đặt cơ sở dữ liệu trong Docker không?
18. Có, các biến môi trường được khuyến nghị để lưu trữ thông tin nhạy cảm một cách an toàn và chúng giúp dễ dàng điều chỉnh cấu hình cho các môi trường khác nhau.
19. Vai trò của mạng cầu nối trong kết nối Docker SQL Server là gì?
20. Mạng cầu nối cho phép các container giao tiếp trong cùng một máy chủ, hữu ích cho các ứng dụng Docker cần truy cập các dịch vụ bên ngoài như SQL Server mà không cần kết nối mạng phức tạp.
21. Làm cách nào để xử lý các sự cố bộ nhớ đệm DNS của Docker?
22. Để tránh các vấn đề về bộ nhớ đệm, hãy đảm bảo DNS được làm mới một cách thích hợp. Trong một số trường hợp, việc khởi động lại daemon Docker hoặc định cấu hình TTL (thời gian tồn tại) cho bộ đệm DNS của Docker có thể hữu ích.

Kết thúc hành trình khắc phục sự cố của bạn

Địa chỉ sự cố mạng trong Docker có vẻ quá sức, đặc biệt là với SQL Server. Bằng cách thiết lập bí danh mạng và dựa vào Docker Compose để kiểm soát thứ tự khởi động, bạn có thể giúp ứng dụng của mình giao tiếp trơn tru với cơ sở dữ liệu. Mỗi điều chỉnh này sẽ làm cho môi trường Dockerized của bạn trở nên linh hoạt hơn.

Ngoài ra, việc kết hợp số lần thử lại và khả năng xử lý lỗi hiệu quả sẽ giúp ứng dụng trở nên đáng tin cậy, ngay cả khi các dịch vụ bắt đầu vào những thời điểm khác nhau. Với những phương pháp hay nhất này, bạn có thể duy trì độ tin cậy của quá trình phát triển cục bộ trong thiết lập được chứa trong vùng chứa, giảm các lỗi như ENOTFOUND và đảm bảo kết nối cơ sở dữ liệu liền mạch cho ứng dụng Docker của bạn. 🚀