如何为GitLab CI中使用的官方Maven Docker镜像配置自定义全局settings.xml？

嘿，刚上手GitLab CI+Docker确实会碰到些小细节问题，我来一步步帮你解决～

先解决你没法进入Maven镜像bash的问题 #

你之前运行容器的命令可能缺了交互式参数，试试这条命令：

docker run -it --rm maven:3-jdk-8 bash

• -it 是开启交互式终端的关键参数，能让你和容器的bash环境正常交互；
• --rm 会在你退出容器后自动删除它，避免残留无用容器；
  运行这条命令后就能顺利进入镜像的bash环境，查看或修改配置了。

给Maven镜像配置Nexus全局settings.xml的两种方案 #

方案一：直接复用官方镜像（最快上手） #

不用修改官方镜像，直接在项目里自定义settings.xml，然后在CI脚本中指定使用它：

1. 在你的项目根目录创建settings.xml，填入Nexus的部署、镜像仓库配置（示例如下）；
2. 在.gitlab-ci.yml中，通过复制配置到Maven默认路径，让全局生效：

示例.gitlab-ci.yml配置：

stages:
  - deploy

deploy-to-nexus:
  image: maven:3-jdk-8
  stage: deploy
  before_script:
    # 把项目里的settings.xml复制到Maven默认配置目录，全局生效
    - cp ./settings.xml /root/.m2/settings.xml
  script:
    # 执行部署命令，此时会自动使用配置好的Nexus信息
    - mvn clean deploy -DskipTests
  only:
    - main

示例settings.xml的Nexus配置：

<settings>
  <!-- 配置Nexus部署的账号密码（建议在GitLab CI变量中存储敏感信息） -->
  <servers>
    <server>
      <id>nexus-releases</id>
      <username>${NEXUS_USER}</username>
      <password>${NEXUS_PWD}</password>
    </server>
    <server>
      <id>nexus-snapshots</id>
      <username>${NEXUS_USER}</username>
      <password>${NEXUS_PWD}</password>
    </server>
  </servers>

  <!-- 配置Nexus作为中央仓库镜像 -->
  <mirrors>
    <mirror>
      <id>nexus-mirror</id>
      <mirrorOf>central</mirrorOf>
      <url>http://你的Nexus地址/repository/maven-public/</url>
    </mirror>
  </mirrors>

  <!-- 激活Nexus仓库配置 -->
  <profiles>
    <profile>
      <id>nexus-profile</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>http://你的Nexus地址/repository/maven-public/</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>nexus-profile</activeProfile>
  </activeProfiles>
</settings>

注意：敏感信息比如NEXUS_USER和NEXUS_PWD，不要硬编码在文件里！去GitLab项目的「Settings → CI/CD → Variables」中添加这些变量，Maven会自动读取。

方案二：构建自定义Maven镜像（适合团队长期复用） #

如果你的团队都需要用这个带Nexus配置的镜像，最好自己构建一个：

1. 创建Dockerfile：

FROM maven:3-jdk-8

# 把自定义的settings.xml复制到Maven的参考配置目录，官方镜像会自动加载这个路径的配置
COPY settings.xml /usr/share/maven/ref/settings.xml

2. 把settings.xml和Dockerfile放在同一目录，执行构建命令：

docker build -t my-maven-nexus:3-jdk-8 .

3. 把构建好的镜像推送到GitLab容器仓库或者Docker Hub，之后在.gitlab-ci.yml中直接使用这个自定义镜像即可。

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