如何将Node.js与Docker结合使用

本教程介绍了在 Docker 容器中运行 Node.js 应用程序的好处以及如何创建实用的开发工作流程。

Node.js允许您在服务器和客户端上使用 JavaScript 创建快速且可扩展的 Web 应用程序。您的应用程序可能在您的开发计算机上完美运行，但您能确定它可以在您同事的设备或生产服务器上运行吗？

考虑以下场景：

当其他人使用 Windows 而服务器运行 Linux 时，您可能使用 macOS。
您安装了 Node.js 20，但其他人使用一系列运行时版本。
您正在使用数据库等依赖项，这些依赖项存在差异，或者可能在其他平台上不可用。
您确定您的新代码不会在另一个操作系统 (OS) 上执行任何危险操作吗？

Docker Delivers

Docker有助于解决上面列出的“但它可以在我的机器上运行”问题。您无需在本地安装应用程序，而是在称为容器的轻量级隔离虚拟机环境中运行它。

真正的虚拟机模拟 PC 硬件，因此您可以安装操作系统。Docker 模拟操作系统，以便您可以安装应用程序。通常为每个基于 Linux 的容器安装一个应用程序，并通过虚拟网络连接它们，以便它们可以在 HTTP 端口上进行通信。

优点：

您的 Docker 设置可以模拟生产 Linux 服务器，也可以使用容器进行部署。
您可以在几分钟内下载、安装和配置依赖项。
您的容器化应用程序在所有设备上都以相同的方式运行。
这样更安全。您的应用程序可能会破坏容器的操作系统，但它不会影响您的电脑，您可以在几秒钟内重新启动。

使用 Docker，无需在 PC 上安装 Node.js 或使用运行时管理选项（例如nvm ）。

你的第一个脚本

在Windows、macOS或Linux上安装 Docker Desktop ，然后创建一个version.js使用以下代码命名的小脚本：

console.log(`Node.js version: ${ process.version }`);

如果您本地安装了 Node.js，请尝试运行该脚本。

$ node version.js
Node.js version: v18.18.2

您现在可以在 Docker 容器内运行相同的脚本。以下命令使用 Node.js 的最新长期支持 (LTS) 版本。cd进入脚本目录并在 macOS 或 Linux 上运行它：

$ docker run --rm --name version \
  -v $PWD:/home/node/app \
  -w /home/node/app \
  node:lts-alpine version.js

Node.js version: v20.9.0

{}Windows Powershell 用户可以使用类似的带括号的命令PWD：

> docker run --rm --name version -v ${PWD}:/home/node/app -w /home/node/app node:lts-alpine version.js

Node.js version: v20.9.0

第一次运行可能需要一两分钟才能执行，因为 Docker 下载依赖项。随后的运行是瞬时的。

让我们尝试不同版本的 Node — 例如最新版本的版本 21。在 macOS 或 Linux 上：

$ docker run --rm --name version \
  -v $PWD:/home/node/app \
  -w /home/node/app \
  node:21-alpine version.js

Node.js version: v21.1.0

在 Windows Powershell 上：

> docker run --rm --name version -v ${PWD}:/home/node/app -w /home/node/app node:21-alpine version.js

Node.js version: v21.1.0

请记住，该脚本在安装了特定版本的 Node.js 的 Linux 容器内运行。

参数解释

出于好奇，命令参数是：

docker run从图像启动一个新容器- 下面详细介绍。
--rm终止时删除容器。除非您有充分的理由再次重新启动容器，否则没有必要保留容器。
--name version为容器指定一个名称，以便于管理。
-v $PWD:/home/node/app（或-v ${PWD}:/home/node/app）bind 安装卷。在这种情况下，主机 PC 上的电流直接安装在位于的容器内/home/node/app。
-w /home/node/app设置 Node.js 工作目录。
node:lts-alpine是图像——在本例中，是在 Alpine Linux 中运行的 Node.js 的 LTS 版本。该映像包含运行应用程序所需的操作系统和文件。将其视为磁盘快照。您可以从同一个映像启动任意数量的容器：它们都引用同一组文件，因此每个容器需要最少的资源。
version.js是要执行的命令（从工作目录内部）。

Docker 镜像可从Docker Hub获取，并且可用于包括Node.js在内的应用程序和运行时。图像通常有多个版本，并用诸如:lts-alpine、20-bullseye-slim或等标签标识latest。

请注意，Alpine是一个小型 Linux 发行版，基本映像大小约为 5MB。它不包含很多库，但对于简单的项目（例如本教程中的项目）来说已经足够了。

运行复杂的应用程序

上面的脚本version.js很简单，不包含依赖项或构建步骤。大多数 Node.js 应用程序用于在目录npm中安装和管理模块node_modules。您不能使用上面的命令，因为：

您无法npm在主机 PC 上运行（您可能没有安装 Node.js 或正确的版本）。
某些模块需要特定于平台的二进制文件。您无法在主机 PC 上安装 Windows 二进制文件并期望它在 Linux 容器中运行。

解决方案是创建您自己的 Docker 映像，其中包含：

Node.js 运行时的适当版本
包含所有必需模块的应用程序的已安装版本

以下演示使用Express.js框架构建一个简单的 Node.js 应用程序。创建一个名为的新目录simple并添加一个package.json包含以下内容的文件：

{
  "name": "simple",
  "version": "1.0.0",
  "description": "simple Node.js and Docker example",
  "type": "module",
  "main": "index.js",
  "scripts": {
    "debug": "node --watch --inspect=0.0.0.0:9229 index.js",
    "start": "node index.js"
  },
  "license": "MIT",
  "dependencies": {
    "express": "^4.18.2"
  }
}

添加index.js包含 JavaScript 代码的文件：

// Express application
import express from 'express';

// configuration
const cfg = {
  port: process.env.PORT || 3000
};

// initialize Express
const app = express();

// home page route
app.get('/:name?', (req, res) => {
  res.send(`Hello ${ req.params.name || 'World' }!`);
});

// start server
app.listen(cfg.port, () => {
  console.log(`server listening at http://localhost:${ cfg.port }`);
});

不要尝试在主机 PC 上安装依赖项或运行此应用程序！

创建一个名为Dockerfile以下内容的文件：

# base Node.js LTS image
FROM node:lts-alpine

# define environment variables
ENV HOME=/home/node/app
ENV NODE_ENV=production
ENV NODE_PORT=3000

# create application folder and assign rights to the node user
RUN mkdir -p $HOME && chown -R node:node $HOME

# set the working directory
WORKDIR $HOME

# set the active user
USER node

# copy package.json from the host
COPY --chown=node:node package.json $HOME/

# install application modules
RUN npm install && npm cache clean --force

# copy remaining files
COPY --chown=node:node . .

# expose port on the host
EXPOSE $NODE_PORT

# application launch command
CMD [ "node", "./index.js" ]

这定义了安装和执行应用程序所需的步骤。请注意，package.json将复制到映像，然后在复制其余文件之前npm install运行。这比一次复制所有文件更有效，因为 Docker 在每个命令中都会创建一个镜像层。如果你的应用程序文件（）发生变化，Docker只需要运行最后三个步骤；不需要再这样做了。index.jsnpm install

您也可以选择添加.dockerignore文件。它类似于.gitignore并阻止将不必要的文件复制到映像中COPY 。例如：

Dockerfile

.git
.gitignore

.vscode
node_modules
README.md

simple通过输入以下命令构建一个 Docker 映像（请注意.末尾的句点 - 表示您正在使用当前目录中的文件）：

$ docker image build -t simple .

node:lts-alpine如果上面使用的 Docker 镜像尚未从您的系统中删除，该镜像应该会在几秒钟内构建完成。

假设构建成功，从您的映像启动一个容器：

$ docker run -it --rm --name simple -p 3000:3000 simple

server listening at http://localhost:3000

-p 3000:3000 将主机 PC 上的端口 3000 发布或公开<host-port>到<container-port>容器内的端口 3000。

打开浏览器并输入 URLhttp://localhost:3000/以查看“Hello World!”

尝试在 URL 中添加名称 - 例如http://localhost:3000/Craig- 以查看替代消息。

最后，通过单击 Docker Desktop容器选项卡中的停止图标来停止应用程序运行，或者在另一个终端窗口中输入以下命令：

docker container stop simple

更好的 Docker 开发工作流程

上述过程有一些令人沮丧的缺陷：

对代码（在index.js）中的任何更改都需要您停止容器、重建映像、重新启动容器并重新测试。
您无法附加 Node.js 调试器，例如VS Code中提供的调试器。

Docker 可以通过保留现有的生产级映像来改进您的开发工作流程，但运行具有覆盖的容器以执行以下操作：

设置环境变量，例如NODE_ENVto development。
将本地目录挂载到容器中。
使用启动应用程序npm run debug。它会运行node --watch --inspect=0.0.0.0:9229 index.js，当文件更改时重新启动应用程序（Node.js 18 中的新增功能），并使用容器外部允许的请求启动调试器。
向主机公开应用程序端口 3000 和调试器端口 9229。

您可以使用一个长docker run命令来完成此操作，但我更喜欢使用Docker Compose。它与 Docker Desktop 一起安装，通常用于启动多个容器。创建一个新文件，命名docker-compse.yml为以下内容：

version: '3'

services:

  simple:
    environment:
      - NODE_ENV=development
    build:
      context: ./
      dockerfile: Dockerfile
    container_name: simple
    volumes:
      - ./:/home/node/app
    ports:
      - "3000:3000"
      - "9229:9229"
    command: /bin/sh -c 'npm install && npm run debug'

使用以下命令启动在调试模式下运行的应用程序：

$ docker compose up

[+] Building 0.0s
[+] Running 2/2
 ✔ Network simple_default  Created
 ✔ Container simple        Created
Attaching to simple
simple  |
simple  | up to date, audited 63 packages in 481ms
simple  |
simple  | > simple@1.0.0 debug
simple  | > node --watch --inspect=0.0.0.0:9229 index.js
simple  |
simple  | Debugger listening on ws://0.0.0.0:9229/de201ceb-5d00-1234-8692-8916f5969cba
simple  | For help, see: https://nodejs.org/en/docs/inspector
simple  | server listening at http://localhost:3000

请注意，旧版本的 Docker Compose 是使用docker-compose. 较新的版本已将 Compose 功能集成到主可执行文件中，因此它以docker compose.

实时应用程序重新启动

打开index.js，进行更改（例如第 14 行的字符串），然后保存文件以查看应用程序自动重新启动：

simple  | Restarting 'index.js'
simple  | Debugger listening on ws://0.0.0.0:9229/acd16665-1399-4dbc-881a-8855ddf9d34c
simple  | For help, see: https://nodejs.org/en/docs/inspector
simple  | server listening at http://localhost:3000

打开或刷新浏览器https://localhost:3000/以查看更新。

使用 VS Code 进行调试

打开 VS Code运行和调试面板，然后单击创建 launch.json 文件。

在下拉列表中选择Node.js.vscode/launch.json ，将创建一个文件并在编辑器中打开。添加以下代码，将调试器附加到正在运行的容器：

{
  // Use IntelliSense to learn about possible attributes.
  // Hover to view descriptions of existing attributes.
  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Container",
      "address": "localhost",
      "port": 9229,
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/home/node/app",
      "skipFiles": [
        "<node_internals>/**"
      ]
    }
  ]
}

保存文件，然后单击“调试”窗格顶部的“附加到容器”以开始调试。

出现调试工具栏。单击装订index.js线以显示红点，切换到第 14 行并添加断点。

在浏览器中刷新https://localhost:3000/，VS Code 将在断点处停止执行并显示所有应用程序变量的状态。单击调试工具栏上的图标可继续运行、单步执行代码或断开调试器。

停止容器

通过打开另一个终端来停止正在运行的容器。cd到应用程序目录，然后输入：

docker compose down

概括

虽然 Docker 需要一些初始设置时间，但健壮、可分发代码的长期好处远远超过了付出的努力。当您添加更多依赖项（例如数据库）时，Docker 将变得非常宝贵。

本教程介绍了在 Docker 容器中运行 Node.js 应用程序的基础知识。

翻译来自：https://www.sitepoint.com/node-js-docker

链接: https://www.fly63.com/article/detial/12577