Menyelesaikan Kesalahan getaddrinfo ENOTFOUND Aplikasi Docker dengan SQL Server

Menangani Kesalahan Koneksi Aplikasi Docker dengan SQL Server

Node.js dengan Docker - Menggunakan Variabel Lingkungan dan Konfigurasi Jaringan

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

Menggunakan Docker Compose untuk Menangani Masalah Jaringan untuk Koneksi SQL Server

Docker Compose - Pengaturan Multi-Container untuk Node.js dan 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"

Menguji Koneksi Menggunakan Tes Unit

Jest - Koneksi Basis Data Pengujian Unit

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

Solusi Alternatif: Penanganan Kesalahan dan Coba Lagi Logika

Node.js - Mekanisme Coba Ulang untuk Koneksi Database yang Tangguh

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

Pertanyaan Umum Tentang Masalah Konektivitas SQL Server Docker

1. Apa yang menyebabkan kesalahan getaddrinfo ENOTFOUND di aplikasi Docker?
2. Kesalahan ini biasanya berasal dari masalah resolusi DNS dalam Docker, di mana aplikasi tidak dapat menyelesaikan nama host SQL Server. Pengaturan jaringan terisolasi Docker sering kali memerlukan konfigurasi untuk mengaktifkan akses nama host yang andal.
3. Bagaimana saya bisa membuat SQL Server saya dapat dijangkau dengan nama host di Docker?
4. Menggunakan Docker Compose dengan layanan bernama, seperti mendefinisikan SQL Server Anda sebagai “db”, lalu mengaksesnya melalui alias tersebut. Docker secara otomatis menambahkan ini ke DNS internalnya, yang membantu menyelesaikan nama host dalam jaringan Docker.
5. Mengapa aplikasi saya berfungsi secara lokal tetapi tidak di Docker?
6. Secara lokal, aplikasi Anda menggunakan DNS sistem untuk menyelesaikan nama host, sedangkan di Docker, aplikasi menggunakan jaringan dalam container. Tanpa konfigurasi yang tepat, Docker mungkin tidak dapat menemukan SQL Server, sehingga menyebabkan kesalahan.
7. Peran apa yang dimainkan perintah depend_on di Docker Compose?
8. Itu depends_on perintah membantu mengontrol urutan startup layanan. Misalnya, memastikan SQL Server dimulai sebelum aplikasi mencegah kesalahan koneksi selama inisialisasi.
9. Haruskah saya menggunakan percobaan ulang untuk koneksi database saya di Docker?
10. Ya! Menerapkan mekanisme percobaan ulang, dengan sedikit penundaan, bisa sangat efektif dalam menangani kasus di mana kontainer database memerlukan waktu ekstra agar dapat diakses sepenuhnya.
11. Bisakah saya mengakses SQL Server eksternal dari wadah Docker?
12. Ya, tetapi jaringan Docker mungkin memerlukan konfigurasi tambahan. Menggunakan jaringan jembatan atau menambahkan IP statis dapat membantu aplikasi Docker menjangkau Server SQL non-Docker.
13. Apakah ada cara untuk menguji koneksi aplikasi Docker saya ke SQL Server?
14. Sangat. Anda dapat menulis pengujian unit menggunakan perpustakaan seperti Jest di Node.js untuk memvalidasi bahwa aplikasi terhubung dengan benar, baik secara lokal maupun dalam Docker.
15. Mengapa konfigurasi jaringan Docker penting untuk aplikasi SQL Server?
16. Isolasi jaringan Docker dapat mencegah layanan menemukan satu sama lain, sehingga berdampak pada koneksi SQL Server. Mengonfigurasi opsi jaringan membantu memastikan aplikasi dapat mengakses database secara konsisten.
17. Bisakah saya menggunakan variabel lingkungan untuk mengelola pengaturan database di Docker?
18. Ya, variabel lingkungan direkomendasikan untuk menyimpan informasi sensitif dengan aman, dan variabel tersebut memudahkan penyesuaian konfigurasi untuk lingkungan yang berbeda.
19. Apa peran jaringan jembatan dalam koneksi Docker SQL Server?
20. Jaringan jembatan memungkinkan kontainer untuk berkomunikasi dalam mesin host yang sama, berguna untuk aplikasi Docker yang perlu mengakses layanan eksternal seperti SQL Server tanpa jaringan yang rumit.
21. Bagaimana cara menangani masalah cache DNS Docker?
22. Untuk menghindari masalah cache, pastikan DNS disegarkan dengan benar. Dalam beberapa kasus, memulai ulang daemon Docker atau mengonfigurasi TTL (time to live) untuk cache DNS Docker dapat membantu.

Mengakhiri Perjalanan Pemecahan Masalah Anda

Mengatasi masalah jaringan di Docker bisa terasa membebani, terutama dengan SQL Server. Dengan menyiapkan alias jaringan dan mengandalkan Docker Compose untuk mengontrol urutan startup, Anda dapat membantu aplikasi Anda berkomunikasi dengan lancar dengan database. Setiap penyesuaian ini akan membuat lingkungan Docker Anda lebih tangguh.

Selain itu, menggabungkan percobaan ulang dan penanganan kesalahan yang tangguh membuat aplikasi dapat diandalkan, meskipun layanan dimulai pada waktu yang berbeda. Dengan praktik terbaik ini, Anda dapat menjaga keandalan pengembangan lokal dalam pengaturan terkontainer, mengurangi kesalahan seperti ENOTFOUND dan memastikan koneksi database yang lancar untuk aplikasi Docker Anda. 🚀