使用Jenkins Pipeline自动化推送Git标签遇问题求助

尝试通过Jenkins Pipeline自动化创建并推送Git分支与标签至远程仓库，执行失败。相关脚本及报错如下：

Jenkins Pipeline脚本 #

stage("Create New Release Branch") {
    sh 'chmod 777 -R ./jenkins-scripts'
    sh './jenkins-scripts/lock-branch.sh'
}

对应的Shell脚本（lock-branch.sh） #

#!/usr/bin/env bash
    
git branch "release/R.$(date +%Y/%m/5d)"
sleep 5
git push -u origin "release/R.$(date +%Y/%m/%d)"
sleep 10
    
release_tag="release/R.$(date +%Y/%m/%d)"
echo $release_tag
sleep 5
    
git tag -a $release_tag
sleep 10
git push origin tag $release_tag

Jenkins报错日志 #

[Pipeline] stage
[Pipeline] { (Create New Release Branch)
[Pipeline] sh
+ chmod 777 -R ./jenkins-scripts
[Pipeline] sh
+ ./jenkins-scripts/lock-branch.sh
fatal: could not read Username for 'https://github.company.com': No such device or address
release/R.2025/01/31

*** Please tell me who you are.

Run

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

to set your account's default identity.
Omit --global to set the identity only in this repository.

fatal: unable to auto-detect email address (got 'unknown@4b1399564e64.(none)')
error: src refspec refs/tags/release/R.2025/01/31 does not match any.
error: failed to push some refs to 'https://github.company.com/some-org/some-repo.git'
[Pipeline] }

1. Git认证失败（无法读取用户名） #

• 原因：Jenkins执行Git操作时未配置远程仓库的访问凭证，导致无权限推送内容。
• 解决：
  • 在Jenkins项目配置中添加Git仓库的凭证（用户名+个人访问令牌/密码），并在Pipeline拉取代码的git步骤中指定凭证ID；
  • 若直接在Shell中执行Git命令，可在仓库URL中嵌入凭证：https://<用户名>:<令牌>@github.company.com/some-org/some-repo.git，或通过Jenkins凭证管理将凭证注入环境变量后使用。

2. Git身份未配置（user.name/user.email缺失） #

• 原因：Git要求提交类操作必须设置用户名和邮箱，Jenkins执行环境未配置该项。
• 解决：在Shell脚本开头添加仓库级别的身份配置：

  git config --local user.name "Jenkins CI"
  git config --local user.email "jenkins@company.com"
  

  使用--local仅对当前仓库生效，避免影响全局配置。

3. 分支创建命令的日期格式错误 #

• 原因：脚本中创建分支的命令用了date +%Y/%m/5d，其中5d是笔误，应为%d，导致创建的分支与后续推送的分支名称不一致。
• 解决：修正分支名称的日期格式：

  git branch "release/R.$(date +%Y/%m/%d)"
  

4. Git标签创建与推送错误 #

• 原因：
  • git tag -a创建附注标签时需指定提交消息，否则会触发交互式编辑器，在Jenkins非交互式环境下会卡住，导致标签创建失败；
  • 推送标签的命令格式错误，正确的单个标签推送命令应为git push origin <tagname>；
  • 标签名称包含斜杠，虽Git允许，但部分仓库管理工具可能存在兼容问题。
• 解决：修改标签相关命令：

  # 可选：用横杠替代斜杠，避免兼容问题
  release_tag="release/R.$(date +%Y-%m-%d)"
  echo $release_tag
  
  # 创建带消息的附注标签
  git tag -a $release_tag -m "Release $release_tag"
  
  # 推送标签
  git push origin $release_tag
  

5. 冗余sleep命令移除 #

脚本中的sleep命令无实际作用，Git操作完成后会自动进入下一步，可直接删除以简化脚本。

#!/usr/bin/env bash

# 配置Git身份
git config --local user.name "Jenkins CI"
git config --local user.email "jenkins@company.com"

# 创建并推送Release分支
branch_name="release/R.$(date +%Y-%m-%d)"
git branch $branch_name
git push -u origin $branch_name

# 创建并推送Release标签
release_tag="release/R.$(date +%Y-%m-%d)"
git tag -a $release_tag -m "Release $release_tag"
git push origin $release_tag

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