GitLab手动流水线中Maven版本更新推送的Git认证问题

没错，你碰到的这个问题确实是Git命令缺访问凭证闹的——Maven SCM插件在执行git clone或者推送操作时，拿不到GitLab仓库的访问权限，才会抛出那个fatal: could not read Username for 'gitlabAdress': No such device or address错误。解决的核心就是给流水线配好GitLab的访问凭证，一般用**项目访问令牌（Project Access Token）或者个人访问令牌（Personal Access Token）**就行，下面给你一步步说怎么操作：

• 第一步：生成GitLab访问令牌
  你有两种令牌可选：

  • 项目访问令牌：打开你的GitLab项目页面，进入「Settings」→「Access Tokens」，新建一个令牌，勾选write_repository权限（毕竟要推送代码），设置好有效期后生成，一定要把令牌值存好——它只会显示这一次。
  • 个人访问令牌：如果是你自己的个人项目，也可以用个人令牌，在GitLab个人设置的「Access Tokens」里创建，同样要勾选write_repository权限。

• 第二步：在流水线中注入凭证
  有两种常用的配置方式，选哪种都可以：

  1. 通过环境变量传递
     先去项目的「Settings」→「CI/CD」→「Variables」里添加两个变量：
     • GIT_USERNAME：如果用项目令牌，用户名填gitlab-ci-token；如果是个人令牌，就填你自己的GitLab用户名。
     • GIT_PASSWORD：把刚才生成的令牌值填进去。
       然后在Maven命令里，把SCM的URL改成带凭证的格式，比如：

     mvn scm:tag -Dscm.url=scm:git:https://${GIT_USERNAME}:${GIT_PASSWORD}@gitlabAdress/your-project-path.git
     

  2. 通过Maven settings.xml配置
     你可以在流水线里自定义一个Maven的settings文件，添加服务器配置：

     <settings>
       <servers>
         <server>
           <id>gitlab-server</id>
           <username>gitlab-ci-token</username>
           <password>${GIT_PASSWORD}</password>
         </server>
       </servers>
     </settings>
     

     接着在项目的pom.xml里，给SCM配置加上这个server的id：

     <scm>
       <connection>scm:git:https://gitlabAdress/your-project-path.git</connection>
       <developerConnection>scm:git:https://gitlabAdress/your-project-path.git</developerConnection>
       <url>https://gitlabAdress/your-project-path.git</url>
       <id>gitlab-server</id>
     </scm>
     

     最后执行Maven命令时，加上-s settings.xml参数指定这个配置文件就行。

• 第三步：确认权限没问题
  一定要确保你的令牌有足够的权限（至少write_repository），如果是项目令牌的话，它本身就属于这个项目，权限范围刚好匹配，不用额外操心。

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