Resolvendo o erro getaddrinfo ENOTFOUND do aplicativo Dockerizado com SQL Server

Tratamento de erros de conexão de aplicativos Dockerizados com SQL Server

Node.js com Docker – Usando variáveis ​​de ambiente e configuração de rede

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

Usando Docker Compose para lidar com problemas de rede em conexões do SQL Server

Docker Compose - Configuração de vários contêineres para Node.js e 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"

Testando conexão usando testes de unidade

Jest - Conexão de banco de dados de teste unitário

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

Solução alternativa: tratamento de erros e lógica de nova tentativa

Node.js - mecanismo de nova tentativa para conexões de banco de dados resilientes

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

Perguntas frequentes sobre problemas de conectividade do SQL Server Dockerizado

1. O que causa o erro getaddrinfo ENOTFOUND em aplicativos Dockerizados?
2. Esse erro geralmente decorre de problemas de resolução de DNS no Docker, onde o aplicativo não consegue resolver o nome do host do SQL Server. As configurações de rede isoladas do Docker geralmente precisam de configuração para permitir acesso confiável ao nome do host.
3. Como posso tornar meu SQL Server acessível por nome de host no Docker?
4. Usar Docker Compose com serviços nomeados, como definir seu SQL Server como “db” e acessá-lo por meio desse alias. O Docker adiciona isso automaticamente ao seu DNS interno, o que ajuda a resolver nomes de host na rede Docker.
5. Por que meu aplicativo funciona localmente, mas não no Docker?
6. Localmente, seu aplicativo usa o DNS do sistema para resolver nomes de host, enquanto no Docker usa uma rede em contêiner. Sem a configuração adequada, o Docker pode não localizar o SQL Server, causando erros.
7. Qual é a função do comando depende_on no Docker Compose?
8. O depends_on O comando ajuda a controlar a ordem de inicialização dos serviços. Por exemplo, garantir que o SQL Server seja iniciado antes do aplicativo evita erros de conexão durante a inicialização.
9. Devo usar novas tentativas para minhas conexões de banco de dados no Docker?
10. Sim! A implementação de um mecanismo de nova tentativa, com um pequeno atraso, pode ser muito eficaz no tratamento de casos em que o contentor da base de dados leva mais tempo para se tornar totalmente acessível.
11. Posso acessar um SQL Server externo a partir de um contêiner Docker?
12. Sim, mas a rede Docker pode precisar de configuração adicional. Usar redes de ponte ou adicionar IPs estáticos pode ajudar aplicativos Dockerizados a alcançar SQL Servers não-Docker.
13. Existe uma maneira de testar a conexão do meu aplicativo Dockerizado com o SQL Server?
14. Absolutamente. Você pode escrever testes unitários usando bibliotecas como Jest no Node.js para validar se o aplicativo se conecta corretamente, tanto localmente quanto no Docker.
15. Por que a configuração de rede do Docker é importante para aplicativos SQL Server?
16. O isolamento de rede do Docker pode impedir que os serviços se descubram, impactando as conexões do SQL Server. Configurar opções de rede ajuda a garantir que o aplicativo possa acessar o banco de dados de forma consistente.
17. Posso usar variáveis ​​de ambiente para gerenciar configurações de banco de dados no Docker?
18. Sim, as variáveis ​​de ambiente são recomendadas para armazenar informações confidenciais com segurança e facilitam o ajuste de configurações para diferentes ambientes.
19. Qual é a função das redes bridge nas conexões do Docker SQL Server?
20. As redes bridge permitem que os contêineres se comuniquem dentro da mesma máquina host, o que é útil para aplicativos Docker que precisam acessar serviços externos como o SQL Server sem redes complexas.
21. Como lidar com problemas de cache DNS do Docker?
22. Para evitar problemas de cache, certifique-se de que o DNS seja atualizado adequadamente. Em alguns casos, reiniciar o daemon do Docker ou configurar o TTL (time to live) para o cache DNS do Docker pode ajudar.

Concluindo sua jornada de solução de problemas

Endereçamento problemas de rede no Docker pode parecer complicado, especialmente com o SQL Server. Ao configurar aliases de rede e contar com o Docker Compose para controlar a ordem de inicialização, você pode ajudar seu aplicativo a se comunicar perfeitamente com o banco de dados. Cada um desses ajustes tornará seu ambiente Dockerizado mais resiliente.

Além disso, a incorporação de novas tentativas e o tratamento robusto de erros tornam o aplicativo confiável, mesmo que os serviços sejam iniciados em horários diferentes. Com essas práticas recomendadas, você pode manter a confiabilidade do desenvolvimento local em uma configuração em contêiner, reduzindo erros como ENOTFOUND e garantindo conexões de banco de dados perfeitas para seus aplicativos Docker. 🚀