新手必看：Nexus自动化部署 | 15分钟学会

▌ 技术引导
Nexus自动化部署不难，但要实打实落地，得把工具链吃透。我见过不少新手连基础配置都搞不定，更别说自动化了。关键是在构建流水线时，别犯低级错误，比如环境变量没填对，或者脚本没加退出码检查。真实踩坑经验告诉我，Nexus的runner配置必须精准，尤其在多节点部署时，要搞清楚每个runner对应的agent标签和机器资源。别光看文档，得看实际执行过程里的日志，日志里藏着90%的真相。自动化部署的核心是把手动操作转化为可复用的脚本，不是写个shell就完事。必须用具体的命令，比如`nexus3 run --cwd /opt/app --env-vars-file /opt/app/env.yaml`，这种格式才能保证稳定性。别以为用docker就能搞定一切，有些依赖需要宿主机挂载，不然运行时会报错。我见过有人用CI/CD工具去构建Nexus镜像，结果没考虑到缓存策略，导致每次构建都重新拉取依赖，效率炸裂。记住，自动化不是为了省事，而是为了可控和高效。

▌ 技术参考

一 Nexus自动化部署的本质是把重复性操作封装成脚本，避免人工干预。我见过很多项目直接在CI系统里写`nexus3 run`命令，但没注意到runner的agent标签配置不一致，导致任务执行失败。实际部署时，runner必须精确匹配容器标签，例如`runner-ubuntu-2204`，否则Nexus会无视该runner的存在。在配置文件里，要确保`runner.agent.label`和实际环境一致，这个配置项在`/etc/nexus3/config.yaml`中设定，写错一次整个流水线就崩。如果用docker-compose启动Nexus，记得在`docker-compose.yml`里加上`labels`，比如`- nexus-runner-ubuntu-2204`，这样runner才能识别。别小看这个配置，它直接决定了哪些任务能被执行。

二 实际操作中，要写一个完整的`env.yaml`文件，里面包含`NEXUS_HOST`、`NEXUS_PORT`、`NEXUS_USER`、`NEXUS_PASSWORD`等关键变量。注意这些变量要放在`/opt/app/env.yaml`路径下，否则`nexus3 run`命令会找不到。举个例子，`NEXUS_HOST`填的是宿主机IP，而不是容器内部的DNS名称，这点容易误操作。在CI系统中，可以使用`--env-vars-file`参数指定，或者直接在命令行里用`-e`传参。别以为环境变量随便填就行，要确保它们和Nexus的登录凭据一致，否则会报`401 Unauthorized`。我之前用Jenkins做CI，就因为没把环境变量传进去，导致每次任务都失败。环境变量是自动化部署的命门，必须精准到位。

三 踩坑场景常见于runner的资源限制和依赖缺失。比如在Kubernetes环境中，如果runner的CPU或内存不够，Nexus任务会卡死或崩溃。我之前用K8s部署，结果没给runner分配足够的资源，导致部署卡在`Waiting for runner`状态。解决办法是直接在Deployment配置里加上`resources`，比如`resources: memory: 2Gi`，这样系统才能识别。另一个问题是依赖包没挂载到容器里，比如`npm install`失败，是因为宿主机的node_modules没挂载到容器。解决办法是用`-v /path/to/node_modules:/opt/app/node_modules`挂载目录，这样就能复用之前安装的包。别以为这是小事，它直接决定了部署效率和稳定性。

四 性能影响主要体现在缓存策略和并行执行上。如果Nexus任务每次都重新下载依赖，部署时间会拉长。我记得有一次用Jenkins做CI，每次构建都从零开始，导致部署时间翻倍。后来改用`--cache-source`参数，指定缓存路径，比如`--cache-source /opt/app/cache`，这样就能复用之前的依赖。此外，并行执行也是个关键点，Nexus支持`--parallel`参数，设置为`3`的话，最多同时执行3个任务，这样能大幅缩短部署时间。别小看这个参数，它直接影响效率。如果项目是多模块的，合理设置并行度能省不少时间。

五 适用场景主要是在CI/CD流程中进行镜像构建和依赖管理，局限性在于需要预先配置好runner和环境变量。比如在GitLab CI里，如果runner的标签没正确设置，任务就会找不到可用的agent。这种情况下，必须在`.gitlab-ci.yml`里设置`variables`，并用`rules`来控制只有匹配标签的runner才能执行任务。另外，Nexus不支持直接对本地文件进行部署，必须通过容器或脚本方式。我之前有个项目直接用Nexus部署静态文件，结果发现不支持，只能改用脚本方式或者直接写入容器。这种限制需要提前了解，否则部署流程会卡在中间环节。

六 替代方案是用Docker BuildKit和Nexus Registry联动，这样可以避免runner配置的复杂性。BuildKit支持缓存复用，可以通过`--build-arg NEXUS_REGISTRY_HOST=your-host`设置镜像仓库地址，然后用`docker build`命令构建镜像并推送到Nexus。这种方案更轻量，也不需要额外配置runner。不过缺点是需要手动管理镜像版本，不像Nexus自动化那样能自动追踪依赖版本。我见过一个团队用这种方式，但每次部署前都要确认镜像是否正确，否则会出错。如果项目对镜像版本控制要求不高，这种方案值得一试。

七 在配置runner时，必须确保其能访问Nexus的API端点。比如在Kubernetes里，runner的ServiceAccount需要有`nexus-registry`的访问权限，或者直接配置`NEXUS_HOST`为`http://nexus-registry:8081`，让runner能通过服务名访问。如果用的是云服务，比如AWS ECS，要确保runner的网络策略允许访问Nexus的端口，否则部署就会断连。我之前用ECS跑任务，结果runner连不上Nexus，后来发现是因为安全组没放行8081端口。这种网络问题很隐蔽，但会影响整个自动化流程，必须提前排查。

八 Nexus的Runner日志是排查问题的关键，特别是在部署失败时。日志里会显示`Failed to connect to Nexus`或者`Missing environment variable`等错误，这些信息直接暴露问题所在。记得在日志中查找`runner`和`nexus3`相关的关键词，避免误看其他模块的日志。比如在`/var/log/nexus3/runner.log`里，会记录runner是否被正确识别，是否获取了任务。我之前在调试时，发现日志里有`Runner not found`，后来发现是runner标签写错了，这直接导致任务无法分发。日志是部署过程中最直观的诊断工具，必须学会看。

九 使用`nexus3 run`命令时，必须指定`--cwd`参数，否则任务会在错误的目录下执行，导致找不到配置文件或依赖包。比如`nexus3 run --cwd /opt/app --env-vars-file /opt/app/env.yaml`，这个命令结构是必须的，不能省略。如果目录路径写错，比如`--cwd /opt/app2`，任务会直接报错，因为没有找到`package.json`或`pom.xml`等关键文件。我之前就因为这个参数写错了，导致部署流程中断，浪费了两个小时。记住，`--cwd`是执行上下文，必须正确指向项目根目录。

十 在配置Nexus Runner时，如果遇到权限问题，最常见的解决办法是调整容器的读写权限。比如用`--priviledged`参数启动容器，或者在Dockerfile中加入`USER root`，再运行`nexus3 run`命令。有时候权限不足会导致镜像无法写入或推送，这时候日志里会提示`Permission denied`。我之前在docker中运行任务，发现无法推送镜像，后来发现是因为容器以非root用户运行，没有写入权限。解决办法是直接在CI系统里配置runner为root用户，或者用`sudo`执行命令，但要确保安全策略允许这样做。权限问题往往隐藏在细节里，但影响很大。

十一 如果是多环境部署，比如dev、test、prod，必须用不同的环境变量文件。比如`env.dev.yaml`、`env.test.yaml`、`env.prod.yaml`，每个文件对应不同的Nexus地址和认证信息。在CI系统中，可以通过`--env-vars-file`动态加载不同的文件，比如在Jenkins里用`env.VARIABLES_FILE`变量控制。我见过有人直接用一个文件，结果部署到prod时用了dev的凭据，导致严重错误。环境变量分离是防止误操作的关键，别把所有变量混在一个文件里。

十二 在CI/CD工具链中，Nexus Runner的生命周期和任务调度要配合好。比如在GitLab中，runner的`exclusive`模式可以保证任务独占运行，避免资源冲突。配置时要加`exclusive: true`，这样就不会和其他任务同时占用runner资源。我在一个项目里因为没设这个参数，导致多个任务同时运行，结果runner资源耗尽，整个流程卡死。这种问题在高并发部署时非常常见，必须提前考虑资源隔离。

十三 有些项目会结合Kubernetes和Nexus Runner做混合部署，这时候需要特别注意runner的调度策略。比如在K8s中用`nodeSelector`指定runner只能在特定标签的节点上运行，比如`node-role=ci`。配置时要写在`Deployment`的`spec.template.spec.nodeSelector`字段里。我之前用这种方式，但没考虑到节点数量有限，结果任务堆积，导致CI系统资源耗尽。调度策略必须和实际资源匹配，否则会引发连锁问题。

十四 Nexus的Runner在某些情况下会因为镜像版本问题无法启动，此时要确保使用的镜像标签是最新的稳定版。比如`nexus3-runner:latest`可能不稳定，建议手动指定标签，比如`nexus3-runner:2.4.0`。我之前用过latest，结果在某个更新后镜像崩了，任务无法执行。镜像版本控制是自动化部署中的隐形门槛，必须熟练掌握版本管理技巧。

十五 如果部署环境存在代理或网络隔离，必须在runner的Dockerfile里配置`--add-host=nexus:your-nexus-ip`，这样容器就能访问Nexus。同时，在`/etc/docker/daemon.json`里配置`"hosts": ["tcp://0.0.0.0:2375", "fd://"]`，让Docker能够通过代理访问外部资源。我之前在内网环境用这种方式，结果发现代理没配置好，导致请求超时。网络配置是部署中最容易出问题的环节，必须提前测试和验证。如果遇到`Connection refused`，先检查docker socket权限和网络策略。