Rješavanje pogreške Dockerized App getaddrinfo ENOTFOUND sa SQL Serverom

Rukovanje pogreškama povezivanja dockerizirane aplikacije s SQL poslužiteljem

Node.js s Dockerom - korištenje varijabli okruženja i mrežne konfiguracije

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

Korištenje Docker Compose za rješavanje problema s umrežavanjem za veze SQL Servera

Docker Compose - postavljanje više spremnika za Node.js i 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"

Testiranje veze pomoću testova jedinica

Jest - Jedinica za testiranje veze s bazom podataka

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

Alternativno rješenje: rukovanje pogreškama i logika ponovnog pokušaja

Node.js - Mehanizam ponovnog pokušaja za otporne veze baze podataka

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

Često postavljana pitanja o problemima povezivanja s Dockerized SQL Serverom

1. Što uzrokuje pogrešku getaddrinfo ENOTFOUND u Dockerized aplikacijama?
2. Ova pogreška obično proizlazi iz problema s rješavanjem DNS-a unutar Dockera, gdje aplikacija ne može razriješiti naziv hosta SQL Servera. Dockerove izolirane mrežne postavke često trebaju konfiguraciju kako bi se omogućio pouzdani pristup imenu hosta.
3. Kako mogu učiniti da moj SQL Server bude dostupan putem naziva hosta u Dockeru?
4. Koristiti Docker Compose s imenovanim uslugama, kao što je definiranje vašeg SQL poslužitelja kao "db", a zatim mu pristupite putem tog aliasa. Docker to automatski dodaje svom internom DNS-u, što pomaže u rješavanju naziva hostova unutar Docker mreže.
5. Zašto moja aplikacija radi lokalno, ali ne radi u Dockeru?
6. Lokalno, vaša aplikacija koristi DNS sustava za rješavanje naziva hostova, dok u Dockeru koristi mrežu u spremnicima. Bez odgovarajuće konfiguracije, Docker možda neće locirati SQL Server, što dovodi do pogrešaka.
7. Kakvu ulogu ima naredbadependent_on u Docker Composeu?
8. The depends_on naredba pomaže kontrolirati redoslijed pokretanja usluga. Na primjer, osiguravanje pokretanja SQL Servera prije aplikacije sprječava pogreške povezivanja tijekom inicijalizacije.
9. Trebam li koristiti ponovne pokušaje za svoje veze s bazom podataka u Dockeru?
10. Da! Implementacija mehanizma ponovnog pokušaja, s malom odgodom, može biti vrlo učinkovita u rješavanju slučajeva u kojima je spremniku baze podataka potrebno dodatno vrijeme da postane potpuno dostupan.
11. Mogu li pristupiti vanjskom SQL Serveru iz Docker spremnika?
12. Da, ali Docker mreža možda treba dodatnu konfiguraciju. Korištenje mreža premošćivanja ili dodavanje statičkih IP-ova može pomoći Dockeriziranim aplikacijama da dosegnu SQL poslužitelje koji nisu Docker.
13. Postoji li način za testiranje veze moje Dockerized aplikacije sa SQL Serverom?
14. Apsolutno. Jedinične testove možete pisati koristeći biblioteke poput Jest u Node.js kako biste potvrdili da se aplikacija ispravno povezuje, i lokalno i unutar Dockera.
15. Zašto je mrežna konfiguracija Dockera važna za aplikacije SQL Servera?
16. Dockerova mrežna izolacija može spriječiti usluge da otkriju jedna drugu, što utječe na veze SQL Servera. Konfiguriranje mrežnih opcija pomaže osigurati da aplikacija dosljedno pristupa bazi podataka.
17. Mogu li koristiti varijable okoline za upravljanje postavkama baze podataka u Dockeru?
18. Da, varijable okruženja preporučuju se za sigurno pohranjivanje osjetljivih informacija i olakšavaju prilagodbu konfiguracija za različita okruženja.
19. Koja je uloga premosnih mreža u vezama Docker SQL Servera?
20. Mreže mostova omogućuju spremnicima komunikaciju unutar istog računala, što je korisno za Docker aplikacije koje trebaju pristup vanjskim uslugama poput SQL Servera bez složenog umrežavanja.
21. Kako mogu riješiti probleme s predmemorijom Docker DNS-a?
22. Da biste izbjegli probleme s predmemorijom, osigurajte odgovarajuće osvježavanje DNS-a. U nekim slučajevima može pomoći ponovno pokretanje Docker demona ili konfiguriranje TTL-a (vrijeme života) za Dockerovu DNS predmemoriju.

Završavamo vaše putovanje u rješavanje problema

Oslovljavanje problema s mrežom u Dockeru može se činiti neodoljivim, posebno sa SQL Serverom. Postavljanjem mrežnih aliasa i oslanjanjem na Docker Compose za kontrolu redoslijeda pokretanja, možete pomoći svojoj aplikaciji da glatko komunicira s bazom podataka. Svaka od ovih prilagodbi učinit će vaše Dockerized okruženje otpornijim.

Dodatno, uključivanje ponovnih pokušaja i robusnog rukovanja pogreškama čini aplikaciju pouzdanom, čak i ako usluge počnu u različito vrijeme. Pomoću ovih najboljih praksi možete održavati pouzdanost lokalnog razvoja unutar spremnika, smanjujući pogreške kao što je ENOTFOUND i osiguravajući besprijekorne veze s bazom podataka za svoje Docker aplikacije. 🚀