分类： 研究

具体用法不说了，很多，请自行搜索，比github插件啥的好用多了。

操作系统：ubuntu20

环境：https://github.com/yeszao/dnmp

在宿主机本地安装的jenkins，在jenkins中设置job，composer install，截取部分输出如下：

Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
Package operations: 8 installs, 0 updates, 0 removals
  - Installing sebastian/code-unit-reverse-lookup (2.0.2): Downloading (connecting...)Downloading (100%)             Failed to download sebastian/code-unit-reverse-lookup from dist: /tmp/composer/cache/files/sebastian/code-unit-reverse-lookup does not exist and could not be created.
    Now trying to download from source
  - Installing sebastian/code-unit-reverse-lookup (2.0.2): Cloning ee51f9bb0c

                                                                                                                                                          
  [RuntimeException]                                                                                                                                      
  Failed to clone https://github.com/sebastianbergmann/code-unit-reverse-lookup.git, git was not found, check that it is installed and in your PATH env.  
                                                                                                                                                          
  sh: git: not found                                                                                                                                      
                                                                                                                                                          

install [--prefer-source] [--prefer-dist] [--dry-run] [--dev] [--no-dev] [--no-custom-installers] [--no-autoloader] [--no-scripts] [--no-progress] [--no-suggest] [-v|vv|vvv|--verbose] [-o|--optimize-autoloader] [-a|--classmap-authoritative] [--apcu-autoloader] [--ignore-platform-reqs] [--] [<packages>]...

skipping non-regular file "vendor/bin/carbon"
skipping non-regular file "vendor/bin/commonmark"
skipping non-regular file "vendor/bin/php-parse"
skipping non-regular file "vendor/bin/psysh"
skipping non-regular file "vendor/bin/var-dump-server"
Finished: SUCCESS

直接在宿主机进到相应的项目目录执行composer install显示：

Cannot create cache directory /tmp/composer/cache/repo/https---repo.packagist.org/, or directory is not writable. Proceeding without cache
Cannot create cache directory /tmp/composer/cache/files/, or directory is not writable. Proceeding without cache

                                                                            
  [Composer\Downloader\TransportException]                                  
  Content-Length mismatch, received 44625 bytes out of the expected 604017  
                                                                            

require [--dev] [--prefer-source] [--prefer-dist] [--fixed] [--no-progress] [--no-suggest] [--no-update] [--no-scripts] [--update-no-dev] [--update-with-dependencies] [--update-with-all-dependencies] [--ignore-platform-reqs] [--prefer-stable] [--prefer-lowest] [--sort-packages] [-o|--optimize-autoloader] [-a|--classmap-authoritative] [--apcu-autoloader] [--] [<packages>]...

这里的composer命令是通过在.bashrc中添加以下命令实现的：

# php7 composer
composer () {
    tty=
    tty -s && tty=--tty
    docker run \
        $tty \
        --interactive \
        --rm \
        --user www-data:www-data \
        --volume ~/dnmp/data/composer:/tmp/composer \
        --volume $(pwd):/app \
        --workdir /app \
        dnmp_php composer "$@"
}

提示找不到git，但显然是存在的，搜索发现可能是权限问题，就给~/dnmp/data/composer，还有/var/lib/jenkins/workspace目录改成777，问题解决。

OBS的官网上有win版的虚拟摄像头插件，可是我没有找到mac版的，在github上搜到了https://github.com/johnboiles/obs-mac-virtualcam

安装成功，但是，腾讯的微信和腾讯会议均不支持，无法选择摄像头。钉钉可以，而且默认就是虚拟摄像头。

最近在更新job的配置时经常出现以上的报错，开始还误以为是百度效率云的icode出了问题。跟百度效率云的团队反馈，对方一直没有响应，不知道是解散了（开个玩笑），还是觉得这不是个问题。

检索这个问题，发现很多文章都说取消全局安全配置中的CSRF Protection的勾选即可，但是我的jenkins里没有这个勾选框了。

然后又检索到https://www.cnblogs.com/kazihuo/p/12937071.html说

Jenkins版本自2.204.6以来的重大变更有：删除禁用 CSRF 保护的功能。 从较旧版本的Jenkins 升级的实例将启用 CSRF 保护和设置默认的发行者，如果之前被禁用。

这篇文章给的办法是在启动jenkins时添加一个配置

-Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true

来实现这个关闭。

但是这样很不优雅，尤其是我有两个jenkins，一个基本上是最新版，一个是为了兼容百度效率云的插件而保留的一个很老的版本。最新版是直接在服务器上跑的jar版本，老版本是用的docker。以上的方法就不好玩了。

所以受到https://stackoverflow.com/questions/49888756/how-do-you-disable-jenkins-csrf-with-script的启发，我安装了一个Strict Crumb Issuer插件，然后在跨站请求伪造保护这里，选择这个插件来工作，配置默认。保存就好了。

对应百度效率云的这个文档：https://cloud.baidu.com/doc/XLY/s/Fjwvy8aq6#jenkins-%E6%8F%92%E4%BB%B6%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97

由于官方的文档用起来很多误解，这里做一下简单的说明，方便大家使用。

首先是jenkins的安装。由于百度效率云目前的jenkins插件比较老，用最新版的jenkins无法配置成功，所有需要为百度效率云部署一个专用的jenkins，这里我称之为中继jenkins。最初，我是按百度的文档所提到的方式，下载jenkis.war，并使用

nohup java -Dfile.encoding=utf-8 -Dhudson.model.ParametersAction.keepUndefinedParameters=true -jar jenkins.war –httpPort=8888 &

这个命令来部署，同时我的业务jenkins是用docker的方式部署。后来，我将业务jenkins改为yum install jenkins直接安装在宿主机了，于是需要把这个效率云jenkins改为docker，避免冲突。

部署中继jenkins，我使用的是以下命令：

docker run -d -u root –restart=always -p 8888:8080  -v /jenkins_xly:/var/jenkins_home –name jenkins_xly -idt jenkins:2.19.1

运行后打开IP:8888，即是通常的账户密码初始化过程，接下来是插件，我取消了所有插件的安装，因为这个jenkins实例只用来转发百度效率云的构建推送。

下载百度效率云的jenkins插件

ipipe-agent.hpi，地址在文章开头那个链接中，通过百度网盘下载。在系统管理-插件管理-高级那里上传这个插件。

回到系统管理，找到iPipe agent management，按照提示填写几个字段。

点击Save，正常的情况下就直接跳转了，没有报错，如果有问题，会有报错，比如用最新版的jenkins，可以装上这个插件，但在这里提交时会报错，问题出在有一个JenkinsUUID的参数，在最新版的jenkins上是空的，我跟百度效率云团队提过这个问题，但至今尚未修复。所以只好多此一举，继续用jenkins2.19.1来中继。

创建jenkins的job

item name即项目名称，尽量用英文字母写清楚，前面提到了，这个名字会出现在效率云中作为选择job的依据。

因为我前面部署这个中继时没有安装其他插件，所以我这里只需要选择构建一个自由风格的软件项目即可。而实际上，这个job需要做的也只是转发一下请求。

在job的General配置中，找到iPipe配置，只需要填写项目标识，这个项目标识跟ipipeUrl中那个项目名是一回事儿，但实际上效率云在相应的项目中显示相关job时应该是以这个job中配置的项目名为准，而前面ipipeUrl中那个项目名应该是插件的历史遗留问题，早期只考虑到一个项目的注册方式。

然后在构建Build中添加一个执行shell，只添加一行命令：

curl {你的业务jenkins的某个job的webhook地址}

job的配置到此结束。

接下来，我们先去效率云验证下这个job能否被触发。

按照百度效率云的文档配置流水线即可，需要注意的是我开始有一个误区，就是代码触发时要选merge，而不是change。否则提交代码到代码库时不会触发流水线。

最后，简单提一下我们的业务jenkins需要做什么配置来响应中继jenkins的curl请求，这个未必是最好的方式，因为不能传递参数了，也许应该用触发远程构建之类的实现，我对jenkins还不够了解。

假定按curl的话，我们需要在业务jenkins安装一个generic-webhook-trigger插件，然后在业务jenkins的job中启用这个插件的配置，填写token这个参数，这个token只要在当前的jenkins的jobs中不重复即可，但为了方便识别，我一般会加上项目标识，比如itemname-rR74nddfdsfs23mm

然后上面curl后面的网址就有了，格式是

http://JENKINS_URL/generic-webhook-trigger/invoke?token={token}