centos/nodejs-8-centos7

NodeJS 8 容器镜像

概述

Node.js 8容器镜像是构建和运行各种Node.js 8应用程序和框架的基础平台。Node.js基于Chrome的JavaScript运行时构建，用于轻松构建快速、可扩展的网络应用。它采用事件驱动的非阻塞I/O模型，使其轻量高效，非常适合在分布式设备上运行的数据密集型实时应用。

该镜像包含Node.JS 8作为https://github.com/openshift/source-to-image%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E6%88%B7%E5%8F%AF%E9%80%89%E6%8B%A9%E5%9F%BA%E4%BA%8ERHEL%E3%80%81CentOS%E6%88%96Fedora%E7%9A%84%E7%89%88%E6%9C%AC%E3%80%82RHEL%E9%95%9C%E5%83%8F%E5%8F%AF%E5%9C%A8Red Hat容器目录获取，CentOS镜像在https://hub.docker.com/r/centos/%E6%8F%90%E4%BE%9B%EF%BC%8CFedora%E9%95%9C%E5%83%8F%E5%88%99%E4%BD%8D%E4%BA%8EFedora Registry。生成的镜像可使用https://github.com/containers/libpod%E8%BF%90%E8%A1%8C%E3%80%82

注意：尽管本文档示例中使用podman命令，但所有此类调用均可替换为docker，参数保持不变。

使用方法

以下示例假设使用rhscl/nodejs-8-rhel7镜像（在OpenShift中可通过nodejs:8镜像流标签获取）。

在OpenShift中构建应用

构建https://github.com/sclorg/s2i-nodejs-container/tree/master/8/test/test-app%E7%A4%BA%E4%BE%8B%E5%BA%94%E7%94%A8%EF%BC%9A

bash
oc new-app nodejs:8~https://github.com/sclorg/s2i-nodejs-container.git --context-dir=8/test/test-app/

使用独立S2I工具构建

在已安装https://github.com/openshift/source-to-image%E7%9A%84%E7%B3%BB%E7%BB%9F%E4%B8%8A%E6%9E%84%E5%BB%BA%EF%BC%9A

bash
s2i build https://github.com/sclorg/s2i-nodejs-container.git --context-dir=8/test/test-app/ rhscl/nodejs-8-rhel7 nodejs-sample-app

访问应用程序

bash
curl 127.0.0.1:8080

环境变量

应用开发人员可通过以下环境变量配置运行时行为：

NODE_ENV

• 描述：NodeJS运行时模式
• 默认值："production"

DEV_MODE

• 描述：设为"true"时使用nodemon自动重载服务器；设为"true"会将NODE_ENV默认值改为"development"（若未显式设置）
• 默认值："false"

NPM_RUN

• 描述：选择自定义运行时模式，需在package.json的scripts部分定义
• 默认值：npm run "start"

HTTP_PROXY

• 描述：装配期间使用的npm代理

HTTPS_PROXY

• 描述：装配期间使用的npm代理

NPM_MIRROR

• 描述：构建过程中使用的自定义NPM registry镜像

注：可在代码库的.s2i/environment文件中以键值对形式定义环境变量，例如：DATABASE_USER=sampleUser

开发模式

通过DEV_MODE环境变量（取值true或false）启用/禁用开发模式，支持热部署和调试功能。调试端口通过DEBUG_PORT指定（仅在DEV_MODE=true时有效）。

运行示例

开发模式

bash
podman run --env DEV_MODE=true my-image-id

指定调试端口（如5454）

bash
podman run --env DEV_MODE=true DEBUG_PORT=5454 my-image-id

生产模式

bash
podman run --env DEV_MODE=false my-image-id

默认配置：DEV_MODE=false，DEBUG_PORT=5858（仅DEV_MODE=true时生效）

热部署

开发模式下，容器内源代码的更改会立即反映到运行中的应用。

使用Podman exec修改代码

bash
podman exec -it <CONTAINER_ID> /bin/bash

进入容器后，当前目录为/opt/app-root/src（应用源代码目录）。

使用OpenShift rsync同步文件

在OpenShift中，可通过oc rsync将本地文件复制到pod：

bash
oc rsync ./local-dir/ <POD_NAME>:/opt/app-root/src/

警告：
生产模式默认执行npm start（运行package.json的start脚本），开发模式使用nodemon（默认执行main属性指定的脚本，无main时执行start脚本）。为确保行为一致，建议移除package.json中的main属性。

注：oc rsync仅在OpenShift 3.1及以上版本可用。

参见

• Dockerfile及源代码：https://github.com/sclorg/s2i-nodejs-container
• 不同系统的Dockerfile命名：
  • CentOS: Dockerfile
  • RHEL7: Dockerfile.rhel7
  • RHEL8: Dockerfile.rhel8
  • Fedora: Dockerfile.fedora