Docker中布置Jenkins实现Android项目的自动化构建

因项目需要,要在服务器上使用Jenkins完成Android项目的自动化构建,但服务器上登录的账户没有管理员权限,无法用sudo命令,因此需要把相应环境布置在docker中。

环境搭建

docker容器相关命令

创建容器

docker create -it containerName

containerName自己定义,参数说明:i: 交互式操作 t: 操作终端

运行容器

docker start containerName

进入容器(已有运行的容器的情况下)

docker exec -it containerName sh

查看正在运行的容器

docker ps

docker容器保存为镜像

bash 复制代码
docker commit -m "My message" my_container my_image:v1.0

启动镜像容器,并给启动的容器命名"mycontainer"

bash 复制代码
docker run -it --name mycontainer myimage

小技巧:docker命令不会用,可以使用 docker 命令名 --help查看如何写命令,eg:

docker exec --help

安装jenkins及所需环境

下载jenkins,这里下载的是2.455版本

apt install curl
curl -L0 https://mirrors.aliyun.com/jenkins/debian/jenkins_2.455_all.deb --output jenkins_2.455_all.deb

安装jenkins所需依赖,主要是java运行环境

apt install openjdk-17-jre-headless
apt install maven
apt install net-tools

安装并启动jenkins

dpkg -i jenkins_2.455_all.deb

安装Android编译环境

安装gradle:

如果gradle版本在4.4.1以下,直接用apt命令就可以

apt install gradle

如果要求更高的gradle版本,则需要下载-解压-设置环境变量

curl -L https://github.com/gradle/gradle-distributions/releases/download/v8.2.0/gradle-8.2-all.zip --output gradle-8.2-all.zip
mkdir /opt/gradle 
unzip -d /opt/gradle gradle8.7all.zip

这里用的8.2.0,其它版本可以在android官网找下载地址;解压后需要设环境变量,并将gradle路径加到最后面(见添加环境变量):export PATH=$PATH:/opt/gradle/gradle-8.2/bin

安装命令行工具

1)下载命令行工具并解压,下载地址从android官网找

curl -L https://googledownloads.cn/android/repository/commandlinetools-linux-11076708_latest.zip --output commandlinetools-linux.zip
unzip /tmp/commandlinetools-linux-<version>.zip -d /opt/android-sdk

解压完需添加到环境变量:export PATH=/android/cmdline-tools/latest/bin:$PATH

2)用sdkmanager下载需要的工具包

查看可用的工具包列表

sdkmanager --list

部分可用的工具包

下载需要的工具包

sdkmanager "具体文件名,带版本号"

需要下载的工具包包括 build-tools,cmdline-tools,cmake,ndk 等

其它需要安装的

包括git,vim等,直接使用 apt install命令安装即可

添加环境变量

1)打开profile文件

vim /etc/profile

2)按"i"键进入编辑模式,在文件末尾添加 export PATH=xxx:$PATH,按esc,再按:wq 退出并保存文本

3)使更改生效

source /etc/profile (或者 . /etc/profile)

Jenkins配置

jenkins启动与关闭

关闭jenkins

bash 复制代码
service jenkins stop

重启jenkins

bash 复制代码
service jenkins restart

初始化

jenkins默认8080端口,在浏览器中输入ip:8080,开始进行jenkins初始化,在页面提示的路径中找到密码填入,完成初始化;创建用户名和密码,用于登录。

插件初始化安装:初始化时建议安装所有推荐的插件,系统管理-插件管理,可以看安装的插件

系统配置

系统管理-系统配置--全局属性,可以设置自定义的环境变量,包括android路径和gradle路径

新建任务

在主页中,点击左边菜单的"新建任务"进入新建任务页面,建议选择流水线。

点击确定进入下一步,进入设置页。

配置流水线脚本并保存,然后点击左侧菜单"立即构建"开始打包。

流水线脚本

最外层是pipeline{},里面填写构建流程,可以参考左侧菜单中的"流水线语法"

例如,在示例步骤选择"git:Git"选项,配置仓库URL、分支名,添加凭据(用户名及密码),点击"生成流水线脚本"按钮,在下方文本框中会生成相应的脚本

也可参考

史上最全 Jenkins Pipeline流水线详解

pipeline脚本示例

bash 复制代码
pipeline{
    agent any
    stages{
        stage("check-branch"){
            //从git下拉代码
            steps{
                git branch: 'develop', credentialsId: '8abcd0123-ffff-fffd-9fff-ffffffffffee', url: 'http://gitlab.xxx.com/TestProject'
            }
        }

        stage("build"){
            steps{
                // 使用 sh 步骤在 shell 中执行 Gradle 命令
                sh 'chmod +x ./gradlew'
                sh './gradlew assembleRelease'
                sh "sudo nsenter -m -u -i -n -p -t 1 sh -c 'docker cp dde250865b41:/var/lib/jenkins/workspace/TestProject/app/build/outputs/apk/release/app-release.apk /home/aaa/share/xxx/test.apk'"
            }
        }
    }
}

分为三个步骤:下拉代码、编译、复制编译好的文件到指定路径

遇到的问题及解决方案

1)无权限执行gradlew命令

解决方案:在执行前添加执行权限

bash 复制代码
sh 'chmod +x ./gradlew'

2)在docker容器中将生成的apk复制出来

参考Docker容器内执行宿主机指令。在docker容器中无法直接执行"docker cp"命令,需要使用nsenter命令执行宿主机命令:

2.1)启动镜像容器时加参数 --pid=host --privileged=true。

bash 复制代码
docker run -itd --pid=host --privileged=true -p 8088:8080 android-compiler:v1.0

"-p 8088:8080"将容器中的8080端口映射到宿主机的8088端口

2.2)调用宿主机命令

bash 复制代码
sh "sudo nsenter -m -u -i -n -p -t 1 sh -c 'docker cp dde250865b41:/var/lib/jenkins/workspace/TestProject/app/build/outputs/apk/release/app-release.apk /home/aaa/share/xxx/test.apk'"

2.3)无权限复制问题:

实测发现在pipeline脚本中执行无权限,需要在前面加上sudo;docker容器中默认是没有"sudo"的,需要先安装,然后配置sudo无需密码:visudo(编辑sudoers文件),在文件中添加 jenkins ALL=(ALL) NOPASSWD:ALL,参考添加环境变量的操作。

相关推荐
明 庭1 小时前
Ubuntu下通过Docker部署NGINX服务器
服务器·ubuntu·docker
dessler3 小时前
Docker-run命令详细讲解
linux·运维·后端·docker
野蛮的大西瓜3 小时前
开源呼叫中心中,如何将ASR与IVR菜单结合,实现动态的IVR交互
人工智能·机器人·自动化·音视频·信息与通信
陌北v13 小时前
Docker Compose 配置指南
运维·docker·容器·docker-compose
只会copy的搬运工4 小时前
Jenkins 持续集成部署——Jenkins实战与运维(1)
运维·ci/cd·jenkins
阿里嘎多学长4 小时前
docker怎么部署高斯数据库
运维·数据库·docker·容器
明 庭5 小时前
Ubuntu下通过Docker部署Caddy服务器
服务器·ubuntu·docker
测试杂货铺5 小时前
如何用postman做接口自动化测试及完美的可视化报告?
自动化测试·软件测试·测试工具·职场和发展·jenkins·压力测试·postman
G_whang6 小时前
windos 安装docker
运维·docker·容器
Mitch3116 小时前
【漏洞复现】CVE-2021-45788 SQL Injection
sql·web安全·docker·prometheus·metersphere