serafinlabs/nodejs

nodeJS 镜像

https://hub.docker.com/r/serafinlabs/nodejs/

镜像概述和主要用途

本镜像是一个基于https://hub.docker.com/r/serafinlabs/alpine/%E7%9A%84nodeJS%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E5%B8%B8%E7%94%A8%E7%9B%B8%E5%85%B3%E5%B7%A5%E5%85%B7%E5%92%8C%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E8%84%9A%E6%9C%AC%E3%80%82**dev** 变体（参见标签）包含常用开发工具和特性。

核心功能和特性

开发标签（dev tags）

dev 标签提供一些常用的nodeJS开发包（全局安装）以及基础镜像的开发工具。

开发相关Linux包：

• 编译工具
• openssh
• jq

开发相关nodeJS包：

• typescript
• bunyan
• depcheck

使用场景和适用范围

适用于需要快速部署和运行nodeJS项目的场景，支持生产环境运行和开发环境调试。特别适合需要集成Git、NPM私有仓库访问等开发流程的nodeJS应用。

使用方法和配置说明

项目文件要求

该镜像期望项目文件位于目录/srv。默认命令为npm start，因此镜像设计用于运行包含package.json文件且其中包含start脚本部分的项目，例如：

json
  "scripts": {
    "start": "forever --minUptime 1000 --spinSleepTime 1000 lib/index.js",
  }

构建镜像

bash
docker build Dockerfile

运行镜像

bash
docker run --rm serafinframework/nodejs <command>

进入运行中的容器

bash
docker exec -ti <container_name> sh

dev 镜像标签的容器允许运行bash甚至zsh shell（推荐）。只需将sh替换为所需的shell即可。

项目开发环境配置

运行包含本地项目的容器：

bash
docker run --name <my_project> -v .:/srv -p 80:80 -p 5858:5858 serafinframework/nodejs-dev

• 端口80用于提供HTTP内容
• 端口5859可映射以附加调试器

可选地，可挂载其他卷以简化开发：

• ~/.ssh/id_rsa:/home/node/.ssh/id_rsa:ro：共享git rsa密钥（git凭证转发）
• ~/.gitconfig:/home/node/.gitconfig:ro：共享git开发者信息（用户***）
• ~/.npmrc:/home/node/.npmrc:ro：共享NPM私有仓库访问权限（NPM凭证转发）

docker-compose.yml配置示例

yaml
version: "2"
services:
    csl:
        image: serafinframework/nodejs-dev
        ports:
            - "80:80"
            - "5858:5859"
        links:
            - memcached
            - dynamodb
        volumes:
            - .:/srv
            - ~/.ssh/id_rsa:/home/node/.ssh/id_rsa:ro
            - ~/.gitconfig:/home/node/.gitconfig:ro
            - ~/.npmrc:/home/node/.npmrc:ro

命令说明

startup.sh

容器入口点运行脚本startup.sh，该脚本附加调试器、运行容器命令，并读取可选环境变量以：

• 调整时区
• 从Git仓库拉取项目

环境变量

• TIMEZONE：可用于定义不同的时区
• BUILD：如果不为空，将根据以下环境变量从Git仓库获取并构建项目：
  • GIT_BUCKET：git项目仓库
  • GIT_BRANCH（可选）：默认master，可指定其他git分支
  • BUILD（可选）：如果值为dev，项目将进行版本控制并包含NPM开发包

示例

bash
docker run -ti -v ~/.ssh/id_rsa:/home/node/.ssh/id_rsa -v ~/.npmrc:/home/node/.npmrc -e TIMEZONE='America/Montreal' -e BUILD=1 -e GIT_BUCKET=git@bitbucket.org:serafinframework/myproject.git GIT_BRANCH=test serafinframework/nodejs

startup-timezone.sh

镜像包含可执行文件*/opt/docker/startup-timezone.sh*，可在运行时用于设置容器时区。时区必须对应Linux tzdata时区名称，例如America/Montreal。

build.sh

镜像包含可执行文件*/opt/docker/build.sh*，可在运行时用于从Git源获取项目。可能需要共享id-rsa密钥以访问仓库。

获取源代码后，将运行npm install命令。如果设置了开发者选项，生成的项目将进行版本控制，并部署NPM开发包；否则，项目将为生产版本。

使用方法

bash
/opt/docker/build.sh [-dh] <git仓库> [<git分支>]