如何为Eclipse JGit设置推送凭证？BitBucket Pipeline认证失败排查

嘿，我之前刚好碰到过和你几乎一模一样的问题！咱们一步步拆解排查：

1. 核心原因：Pipeline环境没有本地的Git认证凭证 #

本地能正常推送是因为你的机器上有SSH密钥或已保存的Git凭证，但BitBucket Pipeline是全新的隔离环境，默认没有这些认证信息，所以触发了Auth fail错误。

2. 优先排查：SSH凭证的Pipeline配置 #

你用的是git@bitbucket.org的SSH地址，首先得给Pipeline配置合法的SSH访问权限：

• 生成一对全新的SSH密钥对（别用本地的，避免泄露）
• 把公钥添加到你的BitBucket账户「Settings > SSH keys」中
• 把私钥添加到仓库的「Settings > Pipelines > Repository variables」，比如命名为BITBUCKET_SSH_PRIVATE_KEY
• 在Pipeline脚本里先配置SSH环境，再执行Maven构建：

  pipelines:
    default:
      - step:
          script:
            # 配置SSH目录与密钥
            - mkdir -p ~/.ssh
            - echo "$BITBUCKET_SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
            - chmod 600 ~/.ssh/id_rsa
            # 添加BitBucket到已知主机，避免首次连接的确认提示
            - ssh-keyscan bitbucket.org >> ~/.ssh/known_hosts
            # 执行你的Maven构建命令
            - mvn clean install your-tagging-plugin-goal
  

3. 适配自定义插件的JGit配置 #

如果你是自己开发的JGit插件，要确保它能读取到Pipeline里的SSH密钥：

• 在插件代码中从环境变量读取私钥内容，写入临时文件（必须设置600权限，否则SSH会拒绝）
• 配置JGit的SSH会话工厂使用这个临时密钥，示例代码：

  import org.eclipse.jgit.transport.*;
  import org.eclipse.jgit.util.FS;
  import com.jcraft.jsch.Session;
  import java.nio.file.Files;
  import java.nio.file.Path;
  import java.nio.file.attribute.PosixFilePermissions;
  
  // 读取Pipeline环境变量中的私钥
  String privateKey = System.getenv("BITBUCKET_SSH_PRIVATE_KEY");
  if (privateKey == null) {
      throw new IllegalStateException("BITBUCKET_SSH_PRIVATE_KEY environment variable not set");
  }
  
  // 创建临时密钥文件并设置权限
  Path tempKey = Files.createTempFile("jgit-ssh", ".key");
  Files.write(tempKey, privateKey.getBytes());
  Files.setPosixFilePermissions(tempKey, PosixFilePermissions.fromString("rw-------"));
  
  // 配置JGit使用该密钥
  JschConfigSessionFactory sessionFactory = new JschConfigSessionFactory() {
      @Override
      protected void configure(OpenSshConfig.Host host, Session session) {
          // 关闭严格主机检查（或提前配置known_hosts更安全）
          session.setConfig("StrictHostKeyChecking", "no");
          getJSch(host, FS.DETECTED).addIdentity(tempKey.toString());
      }
  };
  
  // 给PushCommand绑定会话工厂
  PushCommand pushCommand = git.push();
  pushCommand.setTransportConfigCallback(transport -> {
      SshTransport sshTransport = (SshTransport) transport;
      sshTransport.setSshSessionFactory(sessionFactory);
  });
  

4. 备选方案：改用HTTPS方式推送 #

如果SSH配置太繁琐，可切换到HTTPS，用BitBucket的App Password认证：

• 在BitBucket账户「Settings > App passwords」生成一个拥有Repository write权限的App Password
• 在仓库的Pipeline变量中添加BITBUCKET_USERNAME（你的BitBucket用户名）和BITBUCKET_APP_PASSWORD（刚才生成的密码）
• 在Pipeline脚本中修改Git远程地址为HTTPS格式：

  pipelines:
    default:
      - step:
          script:
            - git remote set-url origin https://${BITBUCKET_USERNAME}:${BITBUCKET_APP_PASSWORD}@bitbucket.org/testrepo/test-tagging.git
            - mvn clean install your-tagging-plugin-goal
  

  这样Maven插件推送时会自动使用URL中的凭证，无需额外配置JGit。

5. 测试验证 #

在Pipeline中先加一个测试步骤，确认Git能正常访问远程仓库：

- step:
    script:
      - ssh-keyscan bitbucket.org >> ~/.ssh/known_hosts
      - git fetch origin
      - echo "Git connection successful!"

如果这一步失败，说明是基础权限问题，优先解决后再排查插件逻辑。

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