Löser Dockerized App getaddriinfo ENOTFOUND-fel med SQL Server

Hantera dockeriserade applikationsanslutningsfel med SQL Server

Node.js med Docker - Använda miljövariabler och nätverkskonfiguration

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

Använda Docker Compose för att hantera nätverksproblem för SQL Server-anslutningar

Docker Compose - Multi-Container Setup för Node.js och 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"

Testa anslutningen med hjälp av enhetstester

Jest - Enhetstestning av databasanslutning

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

Alternativ lösning: Felhantering och försök igen logik

Node.js - Försök igen mekanism för resilient databasanslutningar

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

Vanliga frågor om anslutningsproblem med dockariserad SQL Server

1. Vad orsakar getaddriinfo ENOTFOUND-felet i Dockeriserade appar?
2. Det här felet härrör vanligtvis från DNS-upplösningsproblem inom Docker, där appen inte kan lösa värdnamnet för SQL Server. Dockers isolerade nätverksinställningar behöver ofta konfigureras för att möjliggöra tillförlitlig åtkomst till värdnamn.
3. Hur kan jag göra min SQL Server tillgänglig med värdnamn i Docker?
4. Använda Docker Compose med namngivna tjänster, som att definiera din SQL Server som "db" och sedan komma åt den via det aliaset. Docker lägger automatiskt till detta till sin interna DNS, vilket hjälper till att lösa värdnamn inom Docker-nätverket.
5. Varför fungerar min app lokalt men inte i Docker?
6. Lokalt använder din app systemets DNS för att lösa värdnamn, medan den i Docker använder ett containeriserat nätverk. Utan korrekt konfiguration kan det hända att Docker inte hittar SQL-servern, vilket leder till fel.
7. Vilken roll spelar beroende_on-kommandot i Docker Compose?
8. De depends_on kommando hjälper till att kontrollera startordningen för tjänster. Till exempel, se till att SQL Server startar innan appen förhindrar anslutningsfel under initiering.
9. Ska jag använda återförsök för mina databasanslutningar i Docker?
10. Ja! Att implementera en mekanism för att försöka igen, med en liten fördröjning, kan vara mycket effektivt för att hantera fall där databasbehållaren tar extra tid att bli helt tillgänglig.
11. Kan jag komma åt en extern SQL Server från en Docker-behållare?
12. Ja, men Docker-nätverket kan behöva ytterligare konfiguration. Att använda bryggnätverk eller lägga till statiska IP-adresser kan hjälpa Dockeriserade appar att nå icke-Docker SQL-servrar.
13. Finns det något sätt att testa min Dockerized-apps anslutning till SQL Server?
14. Absolut. Du kan skriva enhetstester med hjälp av bibliotek som Jest i Node.js för att verifiera att appen ansluter korrekt, både lokalt och inom Docker.
15. Varför är Dockers nätverkskonfiguration viktig för SQL Server-appar?
16. Dockers nätverksisolering kan förhindra tjänster från att upptäcka varandra, vilket påverkar SQL Server-anslutningar. Att konfigurera nätverksalternativ hjälper till att säkerställa att appen kan komma åt databasen konsekvent.
17. Kan jag använda miljövariabler för att hantera databasinställningar i Docker?
18. Ja, miljövariabler rekommenderas för att lagra känslig information säkert, och de gör det enkelt att justera konfigurationer för olika miljöer.
19. Vilken roll spelar bryggnätverk i Docker SQL Server-anslutningar?
20. Bridge-nätverk tillåter behållare att kommunicera inom samma värddator, användbart för Docker-appar som behöver komma åt externa tjänster som SQL Server utan komplexa nätverk.
21. Hur hanterar jag problem med Docker DNS-cache?
22. För att undvika cachningsproblem, se till att DNS uppdateras på lämpligt sätt. I vissa fall kan det hjälpa att starta om Docker-demonen eller konfigurera TTL (time to live) för Dockers DNS-cache.

Avsluta din felsökningsresa

Adressering nätverksproblem i Docker kan verka överväldigande, särskilt med SQL Server. Genom att ställa in nätverksalias och lita på Docker Compose för att styra startordningen kan du hjälpa din applikation att kommunicera smidigt med databasen. Var och en av dessa justeringar kommer att göra din Dockeriserade miljö mer motståndskraftig.

Dessutom, inkorporering av omförsök och robust felhantering gör appen tillförlitlig, även om tjänsterna startar vid olika tidpunkter. Med dessa bästa metoder kan du upprätthålla tillförlitligheten för lokal utveckling inom en containeriserad installation, minska fel som ENOTFOUND och säkerställa sömlösa databasanslutningar för dina Docker-appar. 🚀