DevOpsCI/CDCLI开发工具运维【免费下载链接】deployerThe PHP deployment tool with support for popular frameworks out of the box项目地址https://gitcode.com/gh_mirrors/de/deployer点击查看免费下载本篇技术指南围绕 Deployer 项目The PHP deployment tool with support for popular frameworks out of the box的 Node.js 供给provisioning配方展开聚焦provision:node任务如何通过 Fast Node Managerfnm在目标服务器上自动化安装指定版本的 Node.js 与 npm 包。读完本文你将掌握node_version配置项的作用与取值方式、provision:node任务在 x86/ARM 不同架构下的完整安装链路以及如何将该任务嵌入 Deployer 整体的服务器初始化流程中。一、配方的定位与适用场景Deployer 的 Provision 体系用于从零初始化一台全新的服务器目前主要面向 Ubuntu 20.04 LTS 及以上版本。recipe/provision/nodejs.php是该体系中的 Node.js 子配方对应文档 docs/recipe/provision/nodejs.md职责非常单一在目标机器上安装 Node.js 运行时并使其可通过 npm 直接安装全局包。典型的使用场景包括新购 VPS 后一键初始化 PHP Node.js Nginx/Caddy 混合应用环境需要在前端资源构建如 Vite、Webpack Encore阶段使用固定版本 Node.js 的 CI/CD 服务器团队统一 Node.js 版本避免各机器环境漂移。二、引入方式在 Deployer 部署脚本deploy.php中通过标准require引入该配方require recipe/provision/nodejs.php;引入后Deployer 即注册了配置项node_version与任务provision:node。你也可以只引入此子配方单独执行 Node.js 安装或通过引入聚合配方 recipe/provision.php 将 Node.js 安装纳入完整供给流程详见下文第五节。三、配置项node_version原文档记录了唯一的核心配置项node_version其定义位于 recipe/provision/nodejs.phpset(node_version, --lts);项目说明配置名node_version默认值--lts含义传给fnm install的 Node.js 版本参数取值示例--lts长期支持版、18、20.11.1、latest等 fnm 支持的版本标识在provision:node任务中该值通过{{node_version}}插值语法被传入远程命令fnm install {{node_version}}。从源码实现recipe/provision/nodejs.php可以看出它最终被拼接到 shell 命令中执行因此取值必须符合 fnm 对版本参数的解析规则——既可以是语义化版本号也可以是--lts/latest这类特殊标记。默认取--lts意味着开箱即用即可获得 Node.js 长期支持版本这符合生产环境对稳定性的一般要求。注意配置名为node_version单数 node。早期版本使用过的nodejs_version已被废弃若在配置中误用会直接抛出运行时异常详见第六节。四、核心任务provision:node 的完整工作流程任务provision:node的任务描述为 “Installs npm packages”安装 npm 包其完整实现位于 recipe/provision/nodejs.php。尽管描述简洁实际执行链路包含以下五个关键步骤。4.1 切换为供给用户并做废弃项校验任务首先执行set(remote_user, get(provision_user));即所有远程命令以provision_user身份执行该参数在 recipe/provision.php 中默认值为root。随后进行废弃配置项检查if (has(nodejs_version)) { throw new \RuntimeException(nodejs_version is deprecated, use node_version instead.); }这是 Deployer 配方中常见的向前兼容策略一旦检测到旧的nodejs_version配置立即抛出\RuntimeException提示开发者改用node_version从而避免新旧配置并存导致的行为歧义。4.2 远程架构探测与 fnm 二进制选择接下来通过远程命令获取目标机器的 CPU 架构$arch run(uname -m);随后依据架构选择对应的 fnm 发行包文件名recipe/provision/nodejs.phpuname -m输出选择的发行包arm或以armv7开头fnm-arm32以aarch开头或以armv8开头fnm-arm64其他x86_64 等fnm-linux这一逻辑意味着该配方天然支持 ARM 与 x86 两种主流通用架构例如树莓派、ARM 云主机与常规 x86 服务器无需人工指定平台。4.3 下载与解压 fnmfnm 从 GitHub Releases 的 latest 通道下载对应平台的 zip 包$url https://github.com/Schniz/fnm/releases/latest/download/$filename.zip; run(rm -rf /tmp/$filename.zip); run(curl -sSL $url --output /tmp/$filename.zip); run(unzip /tmp/$filename.zip -d /tmp);其中rm -rf先清理可能残留的旧安装包curl -sSL静默跟随重定向下载随后用unzip解压到/tmp。该过程依赖目标机器已安装curl与unzip——这两个包正是聚合供给流程中provision:install任务会预装的基础软件见 recipe/provision.php 的软件清单。4.4 安装 fnm 到系统目录并执行版本安装run(mv /tmp/fnm /usr/local/bin/fnm); run(chmod x /usr/local/bin/fnm); run(fnm install {{node_version}});fnm可执行文件被移动到/usr/local/bin/fnm并赋予执行权限随后立即调用fnm install {{node_version}}安装指定版本的 Node.js。此时fnm会自行下载对应 Node.js 发行版并建立版本缓存因此该任务同时完成了 fnm版本管理器与 Node.js运行时两层的安装。4.5 配置 shell 环境并持久化最后一步将 fnm 的环境初始化脚本写入全局 profilerun(echo . quote(eval fnm env) . /etc/profile.d/fnm.sh);fnm env会输出把 fnm 与当前 Node.js 版本注入 PATH 所需的 shell 代码将其写入/etc/profile.d/fnm.sh后所有登录 shell包括后续以deployer用户执行的部署命令都能自动加载 fnm 环境保证 npm / node 命令全局可用。这里 Deployer 的quote()帮助函数负责对嵌套引号进行正确转义确保远程 shell 正确解析双反引号命令替换。4.6 节点级幂等性任务末尾声明-oncePerNode();这是 Deployer 的任务修饰器表示每个节点只执行一次。在多次执行供给任务或对同一主机反复部署时provision:node不会重复下载安装避免浪费带宽并保持环境幂等。五、与 provision 聚合任务的集成Node.js 子配方通过 recipe/provision.php 被聚合进完整的服务器供给流程require __DIR__ . /provision/nodejs.php;聚合任务provision是一个 Group Task按固定顺序编排了从检查、配置、更新、安装到建站、验证的 15 个子任务recipe/provision.php其中provision:node位于provision:php与provision:databases之间。这意味着在完整供给流程中Node.js 环境会在系统软件包含nodejs基础包安装完成之后、数据库初始化之前就绪。相关配方文档见 docs/recipe/provision.md。六、实战配置示例在deploy.php中为特定主机定制 Node.js 版本require recipe/provision/nodejs.php; host(prod) -set(provision_user, root) // 供给默认以 root 执行 -set(node_version, 20.11.1); // 指定精确版本或单独执行该任务配合架构探测与 fnm 安装dep provision:node prod完整服务器初始化会依次执行检查、配置、系统更新升级、软件包安装、SSH/防火墙、用户、PHP、Node.js、数据库、站点配置与验证dep provision prod关于provision主流程中各参数如domain、public_path、db_type等的交互式收集逻辑可参阅 recipe/provision/website.php 与 recipe/provision/databases.php。七、注意事项与使用限制Ubuntu 支持前提Provision 体系整体以 Ubuntu20 及以上为目标平台recipe/provision.php 中provision:check会读取/etc/os-release校验发行版与版本非 Ubuntu 或过旧版本会给出警告并要求确认。因此provision:node在非 Ubuntu 环境下的行为不受保证。废弃配置切勿使用旧的nodejs_version会触发RuntimeException。网络依赖fnm 发行包与 Node.js 均从 GitHub 下载目标服务器需能访问外网首次执行耗时取决于网络与所选版本。执行身份任务默认以provision_user默认root执行以便写入/usr/local/bin与/etc/profile.d/等系统路径。幂等性oncePerNode()保证单节点只执行一次重复运行provision不会重复安装。八、延伸阅读配方源码recipe/provision/nodejs.php官方文档docs/recipe/provision/nodejs.md聚合供给配方recipe/provision.php 与 docs/recipe/provision.md配套子配方PHP 环境、数据库、用户、站点赞分享DevOpsCI/CDCLI开发工具运维【免费下载链接】deployerThe PHP deployment tool with support for popular frameworks out of the box项目地址https://gitcode.com/gh_mirrors/de/deployer点击查看免费下载相关推荐fnm 配置指南自定义你的 Node.js 版本管理策略fnm 配置指南自定义你的 Node.js 版本管理策略 你是否曾在多个 Node.js 项目间切换时频繁遭遇版本冲突是否厌烦了手动执行 nvm use 或开发工具CLIDeployer 的 Env Recipedeploy:env 任务与 .env 配置文件的自动化管理Deployer 的 Env Recipedeploy:env 任务与 .env 配置文件的自动化管理 导读 本文围绕 Deployerdeployphp/DevOpsCI/CDCLI开发工具运维配置Node.js多版本管理NVM_DIR与NVM_NODEJS_ORG_MIRROR环境变量深度指南配置Node.js多版本管理NVM_DIR与NVM_NODEJS_ORG_MIRROR环境变量深度指南 引言Node.js开发者的版本管理痛点 作为NodeCLI开发工具版本控制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考