プログラミング

Node.jsアプリをDocker化する方法

最終更新： 28/03/2025
1 分の読み

Node.jsのアプリケーションをDockerで構築するプロセスは、開発環境の一貫性を保ち、どこでも簡単にデプロイできるという利点があります。この記事では、Node.jsアプリケーションをDockerを使って構築する方法を完全かつ包括的に解説します。

1. Dockerとは？

Dockerは、アプリケーションとその依存関係をコンテナという単位でパッケージ化するツールです。コンテナは、異なる環境においても一貫した動作を保証するため、開発から本番環境までシームレスにアプリケーションを移行することができます。

関連記事

Node.jsのアプリケーションをDocker化することにより、開発者は依存関係や環境設定を気にすることなく、どこでも同じようにアプリケーションを実行できるようになります。

2. Node.jsアプリケーションの準備

まずは、Node.jsアプリケーションの基本的なセットアップを行います。以下の手順に従って、新しいNode.jsアプリケーションを作成します。

(1) プロジェクトの作成

まず、Node.jsのプロジェクトディレクトリを作成します。

bash
mkdir my-node-app
cd my-node-app

次に、Node.jsのプロジェクトを初期化します。

bash
npm init -y

これにより、package.jsonが作成されます。このファイルには、アプリケーションの依存関係やスクリプトなどが含まれます。

(2) 必要なパッケージのインストール

今回はシンプルなAPIサーバーを作成するので、expressパッケージをインストールします。

bash
npm install express

次に、簡単なExpressアプリケーションを作成します。index.jsという名前のファイルを作成し、以下の内容を追加します。

javascript
const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello, Docker!');
});

app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
});

このコードは、3000番ポートで「Hello, Docker!」というメッセージを返すシンプルなAPIサーバーを立ち上げます。

3. Dockerfileの作成

次に、Node.jsアプリケーションをDockerコンテナとして実行するために、Dockerfileを作成します。Dockerfileは、アプリケーションをコンテナ化するためのレシピです。以下の内容でDockerfileを作成します。

dockerfile
# ベースイメージの指定
FROM node:16

# 作業ディレクトリを作成
WORKDIR /usr/src/app

# パッケージファイルをコピー
COPY package*.json ./

# 依存関係をインストール
RUN npm install

# アプリケーションのソースコードをコピー
COPY . .

# アプリケーションを実行するポートを指定
EXPOSE 3000

# アプリケーションを起動
CMD ["node", "index.js"]

Dockerfileの各ステップの詳細は以下の通りです：

  • FROM node:16：Node.jsの公式イメージ（バージョン16）をベースに使用します。

  • WORKDIR /usr/src/app：コンテナ内で作業するディレクトリを指定します。

  • COPY package*.json ./：package.jsonとpackage-lock.jsonをコンテナ内にコピーします。

  • RUN npm install：依存関係をインストールします。

  • COPY . .：ローカルの全てのファイルをコンテナにコピーします。

  • EXPOSE 3000：コンテナ内で公開するポートを指定します。

  • CMD ["node", "index.js"]：アプリケーションを起動するコマンドです。

4. Dockerイメージのビルド

次に、Dockerfileを元にDockerイメージをビルドします。以下のコマンドを実行します。

bash
docker build -t my-node-app .

このコマンドにより、現在のディレクトリにあるDockerfileを使用して、my-node-appという名前のDockerイメージが作成されます。

5. コンテナの実行

イメージのビルドが成功したら、コンテナを起動します。

bash
docker run -p 3000:3000 my-node-app

このコマンドにより、コンテナ内で実行されているNode.jsアプリケーションがローカルの3000番ポートにバインドされ、ブラウザでhttp://localhost:3000にアクセスすると、「Hello, Docker!」というメッセージが表示されるはずです。

6. Docker Composeを使った複数コンテナの管理（オプション）

もし、複数のコンテナを管理したい場合（例えば、データベースや他のサービスとの連携が必要な場合）、docker-composeを使うことができます。docker-compose.ymlファイルを作成し、以下の内容を記述します。

yaml
version: '3'
services:
  app:
    build: .
    ports:
      - "3000:3000"

この設定を使用すると、docker-compose upコマンドでアプリケーションを簡単に起動できます。

bash
docker-compose up

7. デバッグと改善

Dockerでの開発は非常に便利ですが、デバッグが必要な場合もあります。そのため、コンテナ内で直接コマンドを実行して、問題を確認することもできます。

bash
docker exec -it  /bin/bash

これにより、コンテナ内でシェルが開き、アプリケーションをデバッグすることができます。

8. 最後に

このチュートリアルでは、Node.jsアプリケーションをDockerでコンテナ化する方法を解説しました。これにより、開発環境の一貫性を保ちながら、どこでも簡単にアプリケーションを実行・デプロイすることができます。また、docker-composeを使用することで、複数のサービスを管理することも可能になります。

Dockerの使い方を習得すれば、Node.jsアプリケーションを本番環境にデプロイする際にも大きな助けになります。

最終更新： 28/03/2025
1 分の読み
Back to top button