1. 问题和思路
目前存在的问题:
- 打包操作由开发人员完成,这样开发进度容易被打断
解决问题的思路:
- 将打包操作交测试/产品/开发人员来完成,主要是测试/开发
按照以上的思路,那么jenkins+gradle的解决方案是比较经济的,实现起来难度不大,下面我们详细介绍一下搭建过程
2. 搭建过程
2.1. 服务器的准备
- 普通配置PC一台
- 安装ubuntu20.04(或者vmware 虚拟ubuntu也可以)
- 可配置上网;关闭防火墙;开启ssh服务
2.2 docker安装jenkins
2.2.1 在ubuntu下安装dokcer(略)
2.2.2 使用下面的命令拉取jenkins的docker镜像,这里我是用的是lts的长期支持版本,你可以到jenkins官网自由选择其他版本
sudo docker pull jenkins/jenkins:lts
2.2.3 配置宿主机映射到容器的目录,之后jenkins的一些配置文件都将会存储到该目录下,这个目录可以自己定,但是我建议遵守我这样的规范,便于日后查找和管理
sudo mkdir /home/jenkins_home # 创建jenkins_home目录
sudo chown zhq:zhq /home/jenkins_home #设置该目录的所有者和所属的组(zhq是常用登录到机器的账号)
ps zhq是常用登录到机器的账号,这样为了避免一些有关操作权限的问题
2.2.4 启动jenkins的docker镜像,并设置相关参数,参数解释:
-d
表示以后台模式运行
--name
为容器定义一个名字(后面可以代替容器id使用)
-p
表示映射容器的端口到宿主机的端口
-v
表示映射宿主机的目录到容器的目录
-u zhq
使用zhq用户运行,与登录到ubuntu的账号一致,避免后面出现的一些执行权限问题
-v /home/jenkins_home:/var/jenkins_home
映射jenkins_home,将数据存储到宿主机,这样配置就不会随容器丢失
-v /var/run/docker.sock:/var/run/docker.sock
与 -v /usr/bin/docker:/usr/bin/docker 把宿主机docker 映射到容器内,可以直接在容器内使用宿主机docker
-v /usr/lib/x86_64-linux-gnu/libltdl.so.7:/usr/lib/x86_64-linux-gnu/libltdl.so.7 \
容器内docker运行需要的库文件
-v /opt:/opt \
自主安装的一些运行时软件(如java/maven/git...)
-v /etc/timezone:/etc/timezone
映射时区文件,保证容器的时区和宿主机相同(官网的jenkins容器时区不是中国的时区)
最后的jenkins/jenkins:lts是要启动的镜像
sudo docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -u $(id -u) \
-v /home/jenkins_home:/var/jenkins_home \
-v /var/run/docker.sock:/var/run/docker.sock -v /usr/bin/docker:/usr/bin/docker \
-v /usr/lib/x86_64-linux-gnu/libltdl.so.7:/usr/lib/x86_64-linux-gnu/libltdl.so.7 \
-v /opt:/opt \
-v /etc/timezone:/etc/timezone jenkins/jenkins:lts
ps: 可使用以下命令查看container 是否运行成功:
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
3c20dfcbb16e jenkins/jenkins:lts "/sbin/tini -- /usr/…" 2 minutes ago Up 2 minutes 0.0.0.0:8080->8080/tcp, 0.0.0.0:50000->50000/tcp jenkins
2.2.5 容器启动后,就可以访问ip:8080看到jenkins首次运行的首页了,然后通过下面命令查看初始密码,填入之后跳转到安装插件的页面,选择第一个就好,会默认安装一些插件
sudo cat /home/jenkins_home/secrets/initialAdminPassword
ps: 上面路径与在浏览器中访问jenkins提示的地址不一样哦,那个是container中的地址,我们要查宿主机中映射的地址,见上面的命令,不要搞错。
2.2.6 插件安装很慢,所以我们要设置的插件的国内镜像url进行提速,具体可参考文章:
https://www.cnblogs.com/hellxz/p/jenkins_install_plugins_faster.html
替换完成后,需要执行以下命令,重启容器:
sudo docker ps # 获取container 的id
sudo docker container restart 获取的container_id
再次访问jenkins页面可以发现插件安装飞快
2.2.7 创建一个自由风格的项目
- 在项目配置中,添加git地址,分支名称
- 保存退出,回到项目列表,点击右侧的构建按钮
- 校验代码是否拉取成功
cd /home/jenkins_home/workspace
ls -l
drwxr-xr-x 12 zhq zhq 18 4月 21 16:28 HelloWorld # 如果展示了项目名称,代表拉取代码成功
- 暂停当前操作,我们先在本地使用gradle打包,然后再和jenkins进行结合
2.3 gradle打本地包
2.3.1 下载解压java SDK, Android SDK 和gradle
~$ mkdir soft
~$ cd soft
~$ wget ftp://biguser:www.jb51.net@big.gxkjbg.com:8021/201704/tools/jdk-linux-x64.tar.gz
~$ wget http://dl.google.com/android/android-sdk_r24.4.1-linux.tgz
~$ wget https://services.gradle.org/distributions/gradle-5.4.1-all.zip
~$ tar -zxvf jdk-linux-x64.tar.gz -C /opt/java/
~$ tar -zxvf android-sdk_r24.4.1-linux.tgz
~$ unzip gradle-5.4.1-all.zip
2.3.2 配置java,android环境变量
~$ sudo vim /etc/profile
在文件底部添加以下内容:
export JAVA_HOME=/opt/java/jdk1.8.0_131
export PATH=${JAVA_HOME}/bin:${PATH}
export ANDROID_HOME=/home/zhq/soft/android-sdk-linux
保存退出后,导入新的配置:
~$ source /etc/profile
2.3.3 验证
以我们当前项目做例子,可执行下面命令:
~$ ./soft/gradle-5.4.1/bin/gradle --parallel -b /home/jenkins_home/workspace/HelloWorld/build.gradle assemble_test
其中:
/home/jenkins_home/workspace/
是文中jenkins用来存放项目代码的目录;
/HelloWorld/build.gradle
我们项目build.gradle所在目录,如果打包其他项目应做响应替换;
assemble_test
是项目的buildType,一般都会有assembleDebug 和 assembleRelease,项目不同可能会有其他类型,比如我们用到的assemble_test
以上操作,有错误产生,和当前所使用的android SDK 没有升级相关版本有关系,由于下载的Android SDK无法启动android SDK manger,所以我安装了android studio,在启动的时候提示指定SDK路径,启动已经下载了的项目,按照提示更新SDK即可。
android studio 在ubuntu下安装比较容易,在此不做详细说明了。
2.4 把jenkins和gradle进行结合
2.4.1 把打包命令写成一个脚本test.sh
#!/bin/bash +x
. /etc/profile
~/soft/gradle-5.4.1/bin/gradle --parallel -b /home/jenkins_home/workspace/HelloWorld/build.gradle
保存退出后,增加执行权限:
chmod +x test.sh
2.4.2 在jenkins项目中添加构建shell
把刚才文件的绝对路径添加进去,下面我们就准确的 掉坑里了
,执行项目构建发现构建失败,提示test.sh没有找到,这是因为jenkins执行的时候,是在容器中进行的,我们刚才那个路径在容器中不存在,我们需要把宿主机当作一台远程机器ssh到机器上执行脚本:
- 给jenkins安装SSH插件
-
在系统管理-->系统配置中按照填写宿主机ip/端口/凭证(登录账号密码)如下图
配置样图 - 保存退出,重新构建
至此,这台机器已经可以成功打包了。
2.5 扫尾工作
- 安装存放到指定位置
对于上面提到的test.sh可以进行修改,把apk放到指定位置,代码修改如下:
#!/bin/sh +x
. /etc/profile
~/soft/gradle-5.4.1/bin/gradle --parallel -b /home/jenkins_home/workspace/Hellworld/build.gradle assemble_test
app_path='/home/jenkins_home/workspace/{项目apk存放的位置,根据项目不同进行修改替换}'
target_path='/home/zhq/webroot/apks/' # 此处是自定义存放位置
if [ "`ls -A ${app_path}`" = "" ];
then
echo "${app_path} is empty"
else
mv $app_path/*.apk $target_path
rm -rf $app_path/*
fi
- 把列表发布到网络,可以通过浏览器访问:
- 使用docker 安装lnmp服务器
- 映射apk存放目录到nignx服务器
以上内容不是很难,略掉了哈
3. 鸣谢
- 操作过程得到大神liuyanggofurther的大力支持,在此特别感谢
- 引用了大神们的神作,在此一并谢过,并附上链接