如何在GitLab CI中使用官方Node.js Docker镜像的node用户

你当前用su node -c的方案虽然可用，但确实存在命令转义麻烦、多命令场景可读性差的问题，可根据你的Runner版本选择更优雅的方案：

方案1：使用官方user配置项（推荐） #

GitLab Runner 13.1及以上版本的Docker/Kubernetes executor原生支持user配置，可直接在全局或单个Job中指定运行用户，不需要额外封装命令，缓存、构件功能完全不受影响：

image: node:14

stages:
  - Init

# 全局配置：所有Job都默认用node用户执行
# user: node

init:
  stage: Init
  # 单Job配置：仅当前Job用node用户执行，优先级高于全局配置
  user: node
  script:
    - npm ci --cache .npm --prefer-offline
  cache:
    key: npm
    paths:
      - .npm/

注意事项： #

• 官方node镜像默认已创建uid为1000的node用户，如果你使用自定义镜像，请确保镜像内已提前创建对应普通用户
• 如果之前用root身份生成过缓存，首次切换用户时可能会报权限错误，临时执行一次chown -R node:node .npm修复目录权限即可
• 该配置仅对Docker/Kubernetes executor生效，shell executor不支持

方案2：低版本Runner兼容方案 #

如果你的GitLab Runner版本低于13.1，可以用runuser替代su，更适合非交互式CI场景，同时可以统一修改目录权限避免每次执行都加用户前缀：

init:
  stage: Init
  script:
    # 仅首次切换用户时需要执行，后续缓存已为node权限可删除该行
    - chown -R node:node .npm $CI_PROJECT_DIR
    - runuser -u node -- npm ci --cache .npm --prefer-offline
  cache:
    key: npm
    paths:
      - .npm/

如果有多条命令需要用node用户执行，可以把所有命令写入一个脚本文件，再用runuser -u node -- bash your-script.sh调用，可读性会更好。

内容的提问来源于stack exchange，提问作者user3032481