Jenkins Pipeline+Maven+Gitlab持续集成构建问题集锦

目录

• 1、全局配置一定要写正确，之前where git 给的地址时E:Gitcmdgit.exe一直报错，其实Windows真正的git.exe在bin目录下
• 2、Windows环境的pipeline调用mvn 需要写成这样
• 3、出现　fatal: Authentication failed for 'http://***.git/'
•  4、出现下图not found
• 5、settings.xml文件配置放置位置

---

问题

回到顶部

1、全局配置一定要写正确，之前where git 给的地址时E:Gitcmdgit.exe一直报错，其实Windows真正的git.exe在bin目录下

　　如果是Linux中，使用whereis git查看git安装地址，一般都在/usr/bin/git

回到顶部

2、Windows环境的pipeline调用mvn 需要写成这样

 bat 'D:\chromeDownload\apache-maven-3.6.0-bin\apache-maven-3.6.0\bin\mvn install'

node {

    stage('Pull Code'){
        
        git branch: 'master', credentialsId: 'gitlab_account', url: 'http://********.git'
        
    }
    
   stage('Code Check') {
            echo "敬请期待！"
         }

   stage('Unit Test') {
         echo "敬请期待！"
      }
     

   stage('Compile') {
       echo '编译开始'
       bat 'D:\chromeDownload\apache-maven-3.6.0-bin\apache-maven-3.6.0\bin\mvn install'
       
    
   }

   stage('Build Images') {
        echo '敬请期待!'
      
    }

    stage('Backup'){
        echo '旧版本软件包已经备份'
    }

    stage('Deploy'){
       echo '敬请期待!'
    }

    stage('Integration Testing') {
          echo "敬请期待！"
       }

    stage('UI Automated Testing') {
          echo "敬请期待！"
       }

    stage('Send Testing Report') {
          echo "敬请期待！"
       }

}

Linux下脚本

node {


    stage('Pull Code'){
        
        git branch: 'master', credentialsId: 'git_account', url: 'http://********.git'
        
    }
    
   stage('Code Check') {
            echo "代码检查！"
         }

   stage('Unit Test') {
         echo "单元测试 ！"
      }
     

   stage('Compile') {
        echo '编译开始'
        sh "/var/tools/apache-maven-3.3.9/bin/mvn install"
   }

   stage('Build Images') {
        echo '敬请期待!'
      
    }

    stage('Backup'){
        echo '旧版本软件包已经备份'
    }
    
    stage('Delete Old war'){
        echo "删除老的包"
    }
    

    stage('Deploy'){
       echo '部署!'
    }

    stage('Integration Testing') {
          echo "敬请期待！"
       }

    stage('UI Automated Testing') {
          echo "敬请期待！"
       }

    stage('Send Testing Report') {
          echo "敬请期待！"
       }

}

回到顶部

3、出现　fatal: Authentication failed for 'http://***.git/'

ERROR: Error cloning remote repo 'origin'
hudson.plugins.git.GitException: Command "/usr/bin/git fetch --tags --progress http*****.git +refs/heads/*:refs/remotes/origin/*" returned status code 128:
stdout: 
stderr: remote: HTTP Basic: Access denied
fatal: Authentication failed for 'http://***.git/'

刚开始怀疑是执行Jenkins机器没有把公钥放在gitlab上，其实不是这个原因。

明显是权限账号问题，检查凭证，是不是账号密码输入错误了，或者pipeline中的脚本 credentialsId 写错了（我就犯了这么低级的错误，哈哈哈）

　　

回到顶部

 4、出现下图not found

[Pipeline] }
[Pipeline] // stage
[Pipeline] stage
[Pipeline] { (Code Check)
[Pipeline] echo
代码检查！
[Pipeline] }
[Pipeline] // stage
[Pipeline] stage
[Pipeline] { (Unit Test)
[Pipeline] echo
单元测试 ！
[Pipeline] }
[Pipeline] // stage
[Pipeline] stage
[Pipeline] { (Compile)
[Pipeline] echo
编译开始
[Pipeline] sh
+ /home/tools/apache-maven-3.3.9/bin/mvn install
/var/jenkins_home/workspace/wechatcapi@tmp/durable-4f4430f6/script.sh: 1: /var/jenkins_home/workspace/wechatcapi@tmp/durable-4f4430f6/script.sh: /home/tools/apache-maven-3.3.9/bin/mvn: not found
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
ERROR: script returned exit code 127
Finished: FAILURE

原因：是因为缺少插件：Pipeline Maven Integration (此原因已排除，读者忽略，仅做记录 )

实际原因：pipeline中脚本要指定容器中mvn地址，而不是宿主机的

stage('Compile') {
echo '编译开始'
sh "/var/tools/apache-maven-3.3.9/bin/mvn clean"
}

这里用了容器的mvn但是容器中还缺少环境变量配置：

vi /etc/profile 又提示：

bash: vi: command not found

安装vi 又提示没有权限

jenkins@443d62de8949:/var/tools$ apt-get install vi
E: Could not open lock file /var/lib/dpkg/lock - open (13: Permission denied)
E: Unable to lock the administration directory (/var/lib/dpkg/), are you root?

解决方法：进入容器时使用root账户进入

sudo docker exec -it -u root e36f /bin/bash

先更新源:

apt-get update

apt-get upgrade

再安装vi

apt-get install vi

如果安装vi不行，那就安装vim

apt-get install vim

 
5.docker安装Jenkins报错is not a directory on the Jenkins master(but perhaps it exists on some agents)

尽量不要使用docker安装Jenkins！！！，有很多的坑。

1.安装docker并启动
2.下载Jenkins的docker镜像
docker pull jenkinsci/blueocean
 3.启动镜像
docker run
-u root
--rm
-d
-p 8080:8080
-p 50000:50000
-v jenkins-data:/var/jenkins_home
-v /var/run/docker.sock:/var/run/docker.sock
jenkinsci/blueocean
4.访问Jenkins，并初始化配置
localhost:8080，需要解锁Jenkins

需要输入密码，密码的位置已经告诉我们了，但是在服务器上是没有这个路径的，需要进入容器内部来获取

查看运行的docker容器，会看到Jenkins的id：docker ps

进入镜像内，-it后填查到的id号：docker exec -it xxxxxx bash

获取密码：cat /var/jenkins_home/secrets/initialAdminPassword

填入网页即可

自定义Jenkins，我选择了推荐的插件

配置配置git、jdk、maven

此时问题开始出现，配置报错maven home不存在，其实本机是存在的。

xxxx is not a directory on the Jenkins master(but perhaps it exists on some agents)

java home也是一样的报错。

解决：

需要将本地的maven和java挂载到Jenkins容器，重新启动安装jenkins：

新建一个Jenkins_home挂载目录
mkdir /var/jenkins_home
 

注意挂载目录授权
sudo chown -R 1000 /var/jenkins_home
 启动：

-v命令进行挂载，其中冒号前面的是本机的目录，将本机的javahome和mavenhome的路径，挂载到Jenkins容器上，冒号后面是容器上的目录，可以写跟本机目录相同。

docker run
-u root
--rm
-d
-p 8080:8080
-p 50000:50000
-v /var/run/docker.sock:/var/run/docker.sock
-v /usr/java/jdk1.8.0_181/bin/java:/usr/java/jdk1.8.0_181/bin/java
-v /usr/java/jdk1.8.0_181:/usr/java/jdk1.8.0_181
-v /usr/local/maven:/usr/local/maven
-v /var/jenkins_home:/var/jenkins_home
jenkinsci/blueocean
这样启动后就本地的容器中/var/jenkins_home 目录下的内容就会存入本机的/var/jenkins_home下，密码也可以从这个目录下获取而不用进入容器内部。

这样解决了大部分问题，其他的还是有一些问题的，所以尽量不要用docker启动Jenkins。
 

6、settings.xml文件配置放置位置

　　可以看到有两个.m2目录，正确的地方是/var/jenkins_home/.m2这个目录下放置settings.xml文件，同时记得修改settings文件中地址：<localRepository>/var/jenkins_home/.m2</localRepository>

root@e36f8029c9f2:~/.m2# find / -name .m2
/root/.m2
/var/jenkins_home/.m2