SQL Server での Docker 化アプリの getaddrinfo ENOTFOUND エラーの解決

SQL Server での Dockerized アプリケーション接続エラーの処理

Node.js と Docker - 環境変数とネットワーク構成の使用

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

Docker Compose を使用して SQL Server 接続のネットワーク問題を処理する

Docker Compose - Node.js と 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"

単体テストを使用した接続のテスト

Jest - 単体テスト データベース接続

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

代替解決策: エラー処理と再試行ロジック

Node.js - 回復力のあるデータベース接続のための再試行メカニズム

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

Dockerized SQL Server の接続問題に関するよくある質問

1. Docker化されたアプリでgetaddrinfo ENOTFOUNDエラーが発生する原因は何ですか?
2. このエラーは通常、アプリが SQL Server のホスト名を解決できない、Docker 内の DNS 解決の問題が原因で発生します。 Docker の分離ネットワーク設定では、多くの場合、信頼性の高いホスト名アクセスを有効にするための構成が必要になります。
3. Docker でホスト名によって SQL Server にアクセスできるようにするにはどうすればよいですか?
4. 使用 Docker Compose SQL Server を「db」として定義するなど、名前付きサービスを使用して、そのエイリアスを介してアクセスします。 Docker はこれを内部 DNS に自動的に追加し、Docker ネットワーク内のホスト名を解決するのに役立ちます。
5. 私のアプリはローカルでは動作するのに、Docker では動作しないのはなぜですか?
6. ローカルでは、アプリはシステム DNS を使用してホスト名を解決しますが、Docker ではコンテナ化されたネットワークを使用します。適切な構成がないと、Docker が SQL Server を見つけられず、エラーが発生する可能性があります。
7. Docker Compose で depend_on コマンドはどのような役割を果たしますか?
8. の depends_on コマンドは、サービスの起動順序を制御するのに役立ちます。たとえば、アプリが起動する前に SQL Server が起動するようにすると、初期化中の接続エラーを防ぐことができます。
9. Docker でのデータベース接続に再試行を使用する必要がありますか?
10. はい！遅延が少ない再試行メカニズムを実装すると、データベース コンテナーが完全にアクセスできるようになるまでに余分な時間がかかる場合に非常に効果的です。
11. Docker コンテナから外部 SQL Server にアクセスできますか?
12. はい、ただし、Docker ネットワークには追加の構成が必要な場合があります。ブリッジ ネットワークを使用するか、静的 IP を追加すると、Docker 化されたアプリが非 Docker SQL Server にアクセスできるようになります。
13. Docker 化されたアプリの SQL Server への接続をテストする方法はありますか?
14. 絶対に。次のようなライブラリを使用して単体テストを作成できます。 Jest Node.js を使用して、アプリがローカルと Docker 内の両方で正しく接続していることを検証します。
15. SQL Server アプリにとって Docker のネットワーク構成が重要なのはなぜですか?
16. Docker のネットワーク分離により、サービスが相互に検出できなくなり、SQL Server 接続に影響を与える可能性があります。ネットワーク オプションを構成すると、アプリがデータベースに一貫してアクセスできるようになります。
17. Docker でデータベース設定を管理するために環境変数を使用できますか?
18. はい、環境変数は機密情報を安全に保存するために推奨されており、環境変数を使用すると、さまざまな環境に合わせて構成を簡単に調整できます。
19. Docker SQL Server 接続におけるブリッジ ネットワークの役割は何ですか?
20. ブリッジ ネットワークを使用すると、コンテナーが同じホスト マシン内で通信できるようになります。これは、複雑なネットワークを使用せずに SQL Server などの外部サービスにアクセスする必要がある Docker アプリに役立ちます。
21. Docker DNS キャッシュの問題はどのように処理すればよいですか?
22. キャッシュの問題を回避するには、DNS が適切に更新されていることを確認してください。場合によっては、Docker デーモンを再起動するか、Docker の DNS キャッシュの TTL (生存時間) を構成すると解決することがあります。

トラブルシューティングのまとめ

アドレッシング ネットワークの問題 Docker では、特に SQL Server では圧倒されるように思えるかもしれません。ネットワーク エイリアスを設定し、Docker Compose を利用して起動順序を制御することで、アプリケーションがデータベースとスムーズに通信できるようになります。これらの各調整により、Docker 化された環境の復元力が高まります。

さらに、再試行と堅牢なエラー処理を組み込むことで、サービスが異なる時間に開始された場合でも、アプリの信頼性が高まります。これらのベスト プラクティスを使用すると、コンテナー化されたセットアップ内でローカル開発の信頼性を維持し、ENOTFOUND などのエラーを減らし、Docker アプリのシームレスなデータベース接続を確保できます。 🚀