Arbess CICD实践(1) - 使用Arbess+GitPuk+Docker实现Java项目自动化部署

原创 已于 2025-09-11 20:15:29 修改 · 1.4k 阅读 · 24 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Arbess #开源CICD工具 #Jenkins #tiklab

于 2025-09-04 19:49:50 首次发布

Arbess 是一款开源免费的 CI/CD 工具，包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块。本文将详细介绍使用Arbess+GitPuk+Docker实现自动化构建部署。

1、GitPuk 安装与配置

本章节将介绍如何使用CentOS搭建GitPuk服务器，并将代码存放在GitPuk服务器，提供给Arbess拉取。

1.1 安装

本文以CentOS操作系统为例。

  • 下载，CentOS安装包下载地址：GitPuk下载，点击CentOS下载，下载完成后得到类似tiklab-gitpuk-x.x.x.rpm的文件。
  • 安装，上传到服务器上，在文件同级目录执行npm命令安装。

rpm -ivh --replacefiles --nodeps tiklab-gitpuk-x.x.x.rpm

  • 启动，系统默认安装路径为/opt目录，进入/opt/tiklab-gitpuk/bin目录下，执行sh startup.sh即可启动成功。

使用 http://ip:9800 进行访问。使用初始用户名密码admin\123456登录，首次登录需要修改管理员密码，修改完成之后成功登录。成功登录后展示GitPuk首页。

首页

1.2 配置

GitPuk登录成功，需要添加代码仓库，GitPuk支持新建仓库上传代码和从其他软件导入仓库两种方式。

  • 新建仓库

在仓库页面点击右上角“新建仓库”。

创建仓库

新建的仓库可通过HTTP和SSH方式按步骤上传代码。

上传代码

  • 导入仓库

GitPuk也支持从外部仓库导入。

导入仓库

以私有Gitlab为例，导入需要提供私有Gitlab地址，以及访问密钥。

添加GitLab信息

添加完成后，选择Gitlab的仓库，进行导入。

导入仓库

2、Arbess 安装与配置

2.1 安装

本文以CentOS操作系统为例。

  • 下载，服务端安装包含Agent安装，CentOS安装包下载地址：Arbess下载，点击CentOS下载，下载完成后得到类似tiklab-arbess-x.x.x.rpm的文件。
  • 安装，上传到服务器上，在文件同级目录执行npm命令安装。

rpm -ivh --replacefiles --nodeps tiklab-arbess-x.x.x.rpm

  • 启动，系统默认安装路径为/opt目录，进入/opt/tiklab-arbess/bin目录下，执行sh startup.sh即可启动成功。

启动Arbess

使用 http://ip:9200 进行访问。使用初始用户名密码admin\123456登录，首次登录需要修改管理员密码，修改完成之后成功登录。成功登录后展示Arbess首页。

首页

2.2 配置

Arbess流水线采用可视化设计，实现Java项目自动化部署，在流水线中可克隆GitPuk仓库代码、构建并部署Docker安装包。创建流水线，进入流水线设计页面进行操作。

2.2.1 配置GitPuk任务

  • 配置GitPuk服务集成

在配置GitPuk之前，需要先添加GitPuk服务集成，在系统设置→集成与开放→服务集成页面添加相关服务。授权类型选择GitPuk、填写名称、服务地址（即文章1部分安装的GitPuk地址)、用户名、密码。

添加源码集成

  • 添加GitPuk源码任务

服务集成完毕之后，进入流水线详情→设计，进行设计流水线，创建流水线会默认通用Git源码，一个流水线只能配置一个源码类型的的任务，修改其他类型的源码仓库，需要先删除之前的源码仓库。鼠标移动到通用Git源码，点击右侧删除按钮。

删除源码

删除后，点击流水线最左侧“+”号，添加任务，点击新阶段→源码→自建GitPuk。需要填入任务名称、Git版本、自检GitPuk服务、仓库、分支等信息。

添加源码

字段

描述

任务名称

任务名称清晰地标识项目或对象。

Git版本

Arbess所在服务器Git安装路径。

自建GitPuk服务

自建GitPuk服务地址。

仓库

选择授权信息后点击仓库，程序会自动获取凭证权限下的仓库列表，管理者只需选择需要配置的仓库即可。

分支

选择代码的分支。填写需要拉取远程仓库具体的分支，不填默认为master分支，填写错误会导致任务执行失败。

2.3.2 配置Docker构建

点击新阶段→构建→Docker构建。添加成功之后，弹出Docker构建配置。

Docker构建

字段

描述

任务名称

任务名称清晰地标识项目或对象。

DockerFile地址

定义和自动化构建Docker镜像的脚本文件地址。

执行命令

执行Docker构建的命令。

2.2.3 配置Docker部署

点击新阶段→部署→Docker部署。添加成功之后，弹出Docker部署配置。

编辑部署任务

字段

描述

任务名称

任务名称清晰地标识项目或对象。

主机地址Docker部署文件生成的主机，远程SSH认证凭证。

部署镜像名称

需要部署的镜像名称。

部署位置

生成部署文件的位置。

启动命令

镜像启动命令。

3、运行流水线

  • 运行流水线

流水线设计完毕之后，Arbess支持自动触发、Webhook触发、手动触发三种运行模式。点击右上角“运行”按钮，手动触发流水线。

运行流水线

流水线运行同时，点击认为标签右下角“日志”，可查看运行实时日志。

查看运行日志

流水线运行成功，使用docker images查看Docker部署结果。

查看部署结果

也可以通过日志来查看Docker项目生成安装包位置。

查看运行详细日志

  • 查看运行历史

可以在Arbess历史页面查看到流水线运行历史。点击运行历史序号，即可查看详细的运行日志。

查看运行历史

至此，使用Arbess成功搭建流水线，用来拉取GitPuk源码、Docker部署并构建安装包。

jenkins+docker实现可持续自动化部署springboot项目
congge
04-06 1万+
jenkins+docker实现可持续自动化部署springboot项目
基于gitlab+docker实现CICD
qq_33816243的博客
07-09 1712
利用Docker、Gitlab、Gitlab Runner、SonarQube、Harbor、Jmeter、Maven、Java技术，搭建一个完整的 CI/CD 管道，实现当开发人员完成代码提交后，开始流水线工作，完成编译打包、单元测试、源码扫描、上传制品、部署服务到Docker容器、自动化测试工作。通过自动化构建、测试、代码质量检查和容器化部署，将开发人员从繁琐的手动操作中解放出来，提高团队的开发效率、软件质量和安全性，实现持续更新迭代和持续部署交付。
Argo CD与Arbess，一文从安装、功能、体验等全方面对比
zhangzh1978的博客
10-25 635
Argo CD是是一款基于Kubernetes遵循声明式 GitOps 理念的持续部署CD工具，Arbess是一款开源免费的持续集成与交付(CICD)工具，两款工具各有特点。本文将从安装配置、功能、系统集成、用户体验几个方面对两款软件进行详细对比。
Arbess V2.1.7版本发布，新增任务AliYun OSS上传、下载功能，新增流水线评审功能
最新发布
tiklab2021的博客
11-14 933
Arbess 是一款国产开源免费的 CI/CD 工具，产品开源免费，简洁易用。本周Arbess V2.1.7版本发布，新增任务AliYun OSS上传、下载功能，新增流水线评审功能，LDAP/企业微信/钉钉登录帐号集成及登录认证调整为社区版本功能。
Arbess安装教程，3分钟快速上手
tiklab2021的博客
10-10 906
允许用户自定义应用的启动端口，以便在特定网络环境下避免端口冲突或满足其他配置需求。​端口配置属性值serer.port系统启动的端口号（可更改）。支持自定义数据库连接方式，用户可以选择使用内嵌数据库或指定外部数据库地址。根据需求配置数据库连接。​数据库配置属性说明数据库驱动程序。jdbc.url默认是：jdbc:postgresql://localhost:9201/tiklab_arbess?其中 9201 为端口号，tiklab_arbess为数据库名字。数据库登录名。
Arbess，一款国产开源免费的CICD工具，超级轻量、简洁
tiklab2021的博客
09-28 648
Arbess包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块，支持串行并行可视化设计方式，支持丰富多样的任务类型，支持分布式执行流水线，界面操作简洁明了、开源免费。
Jenkins配置有些繁琐，推荐一款开源免费、简洁易用的CICD工具-Arbess
zhangzh1978的博客
01-17 1569
Arbess包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块，支持串行并行可视化设计方式，支持丰富多样的任务类型，支持分布式执行流水线，界面操作简洁明了、开源免费。Arbess简介。
Arbess从入门到实战(4) - 使用Arbess+GitLab+SonarQube搭建Java自动化部署
tiklab2021的博客
09-27 941
Arbess 是一款国产开源免费的 CI/CD 工具，相比老牌Jenkins工具有着轻量、简洁易用等特点。本文将详细介绍如何安装配置使用GitLab、SonarQube、Arbess系统，使用流水线拉取GitLab源码、使用SonarQube进行代码扫描，构建安装包并部署到远程主机。
FreeWheel-CICD实践-——-构建并行化docker测试环境.pdf
04-24
FreeWheel-CICD实践-——-构建并行化docker测试环境.pdf
GitLab+Docker搭建CICD自动化部署.docx
02-16
CICD是最近几年比较火的技术，顾名思义就是持续集成（Continuous Integration）和持续部署（Continuous Deployment）简称，指在开发过程中自动执行一系列脚本来减低开发引入 bug 的概率，在新代码从开发到部署的过程...
Kaelthas - 一款开源免费的一体化监控管理工具
tiklab2022的博客
11-14 1481
在监控领域，已经存在Zabbix、Nagios、Prometheus 和 SwkingWalking等工具帮助企业管理复杂的基础设施并保持系统稳定。下面推荐一款监控工具 - kaelthas，它涵盖了服务器和主机监控、数据库监控等多个方向的监控，并且开源免费，操作简单。。
比Jenkins轻量简洁，一款国产开源免费的CICD工具 - Arbess
tiklab2021的博客
09-21 1010
允许用户自定义应用的启动端口，以便在特定网络环境下避免端口冲突或满足其他配置需求。​端口配置属性值serer.port系统启动的端口号（可更改）。支持自定义数据库连接方式，用户可以选择使用内嵌数据库或指定外部数据库地址。根据需求配置数据库连接。​数据库配置属性说明数据库驱动程序。jdbc.url默认是：jdbc:postgresql://localhost:9201/tiklab_arbess?其中 9201 为端口号，tiklab_arbess为数据库名字。数据库登录名。
CICD实战(2) - 使用Arbess+GitLab+SonarQube搭建Java CICD自动化部署
zhangzh1978的博客
09-01 1004
Arbess 是一款国产开源免费的 CI/CD 工具，包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块。本文将详细介绍如何安装配置使用GitLab、SonarQube、Arbess系统，进行代码扫描，构建并部署到主机。
平替Jenkins，推荐一款国产开源免费的CICD工具 - Arbess
zhangzh0910的博客
09-21 1010
允许用户自定义应用的启动端口，以便在特定网络环境下避免端口冲突或满足其他配置需求。​端口配置属性值serer.port系统启动的端口号（可更改）。支持自定义数据库连接方式，用户可以选择使用内嵌数据库或指定外部数据库地址。根据需求配置数据库连接。​数据库配置属性说明数据库驱动程序。jdbc.url默认是：jdbc:postgresql://localhost:9201/tiklab_arbess?其中 9201 为端口号，tiklab_arbess为数据库名字。数据库登录名。
Jenkins VS Arbess，CICD工具一文全面对比分析
tiklab2021的博客
09-20 1093
在CICD工具的选择中，Jenkins作为一个老牌的CICD工具是广为人知的，Arbess作为一款新兴的国产开源免费的CICD工具，两款工具各有特点。本文将从安装配置、功能特性、用户体验等几个方面对两款软件进行详细对比。
Arbess V1.1.4版本发布，支持Mysql数据库，Ubuntu系统，新增SSH及Hadess上传下载任务
tiklab2021的博客
08-24 1132
Arbess 是一款国产开源免费的 CI/CD 工具，包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块，支持丰富多样的任务类型，界面操作简洁明了、开源免费。本周Arbess V1.1.4 版本发布，支持Mysql数据库，Ubuntu系统，增加SSH及Hadess上传下载任务。
Arbess V1.1.6版本发布，支持sonarQube/sourcefare代码扫描，有效保障代码质量
tiklab2021的博客
08-25 697
Arbess 是一款国产开源免费的 CI/CD 工具，包含流水线管理、流水线设计、流水线执行、测试报告、统计分析等模块，支持丰富多样的任务类型，界面操作简洁明了、开源免费。Arbess V1.1.6 版本发布，支持sonarQube/sourcefare代码扫描，有效保障代码质量。
Arbess入门教程(1) - 安装配置
tiklab2020的博客
11-28 1734
Arbess 是一款开源免费的 CI/CD 工具，快速安装和配置 Arbess，帮助开发者迅速启动自动化构建、测试与发布流程。无论是新手还是资深开发者，Arbess 的简洁安装流程和强大功能都将带你迈向高效开发之路！。
前后端分离的springboot项目通过docker+gitlb实现自动化cicd
05-28
<think>好的，我现在需要帮助用户实现前后端分离的SpringBoot项目的自动化CI/CD流程，使用Docker和GitLab。首先，我得回顾一下用户提到的引用内容，虽然这些引用可能不完全相关，但需要从中提取有用的信息。用户提到GitLab Runner的安装和注册，以及SSH免密登录的问题。这说明在配置过程中，Runner的安装和权限设置是关键步骤。同时，用户希望使用Docker，所以需要考虑如何在CI/CD流程中集成Docker镜像的构建和推送。接下来，我需要分步骤来规划整个流程。首先，安装和配置GitLab Runner，这包括在服务器上安装Runner，并注册到GitLab项目中。然后，编写.gitlab-ci.yml文件，定义不同的阶段，比如构建、测试、打包、部署等。对于前后端分离的项目，可能需要分别处理前端和后端的部分。 前端部分，通常使用npm或yarn进行构建，生成静态文件，然后通过Docker镜像部署到Nginx之类的服务器。后端SpringBoot项目则需要打包成Jar文件，构建Docker镜像，并推送到镜像仓库，最后部署到目标服务器。另外，用户提到了Docker的缓存问题，需要优化构建过程，比如使用Maven的缓存来加速构建。同时，SSH免密登录可能用于自动化部署，确保GitLabRunner能够访问目标服务器执行部署脚本。 还需要考虑环境变量的配置，比如数据库连接信息、API密钥等，这些可以通过GitLab的CI/CD变量功能来管理，避免硬编码在配置文件中。 最后，测试整个流程，确保每个阶段都能正确执行，处理可能出现的错误，比如网络问题、权限不足等，特别是502Bad Gateway的问题，可能需要检查Runner和服务器之间的通信是否正常。总结下来，步骤大致是：1.安装配置GitLabRunner；2.编写CI/CD配置文件，定义前后端的构建和部署流程；3.集成Docker构建和推送；4.配置环境变量和SSH免密登录；5.测试和优化流程。</think>### 分步实现 Docker+GitLab 的 SpringBoot 前后端分离 CI/CD 流程 #### 一、基础环境准备 1. **安装 GitLab Runner** 在 CentOS 服务器上执行以下命令： ```bash # 添加 GitLab 官方仓库 curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash # 安装 GitLab Runner sudo yum install gitlab-runner # 注册 Runner（需替换 YOUR_GITLAB_URL 和 REGISTRATION_TOKEN） sudo gitlab-runner register --url YOUR_GITLAB_URL --token REGISTRATION_TOKEN --executor docker --description "Docker Runner" ``` *提示：注册时选择 `docker` 执行器，并指定基础镜像如 `alpine:latest`[^3]。* 2. **配置 Docker 权限** 确保 Runner 用户有 Docker 操作权限： ```bash sudo usermod -aG docker gitlab-runner ``` --- #### 二、后端 SpringBoot 项目配置 1. **编写 Dockerfile** 在项目根目录创建 `Dockerfile`： ```dockerfile FROM maven:3.8.6-jdk-11 AS build WORKDIR /app COPY . . RUN mvn clean package -DskipTests FROM openjdk:11-jre-slim COPY --from=build /app/target/*.jar app.jar EXPOSE 8080 ENTRYPOINT ["java","-jar","/app.jar"] ``` 2. **定义 `.gitlab-ci.yml` 阶段** ```yaml stages: - build - test - deploy variables: DOCKER_IMAGE: registry.example.com/backend:latest build-backend: stage: build script: - docker build -t $DOCKER_IMAGE . - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD registry.example.com - docker push $DOCKER_IMAGE only: - main deploy-backend: stage: deploy script: - ssh -o StrictHostKeyChecking=no user@server "docker pull $DOCKER_IMAGE && docker-compose up -d" ``` *注：需在 GitLab 设置 `CI_REGISTRY_USER` 和 `CI_REGISTRY_PASSWORD` 变量[^1]。* --- #### 三、前端 Vue/React 项目配置 1. **前端 Dockerfile** ```dockerfile FROM node:16 AS build WORKDIR /app COPY package*.json ./ RUN npm install COPY . . RUN npm run build FROM nginx:alpine COPY --from=build /app/dist /usr/share/nginx/html EXPOSE 80 ``` 2. **CI/CD 前端任务** ```yaml build-frontend: stage: build script: - docker build -t registry.example.com/frontend:latest . - docker push registry.example.com/frontend:latest artifacts: paths: - dist/ deploy-frontend: stage: deploy script: - ssh user@server "docker-compose -f /path/to/frontend-compose.yml up -d" ``` --- #### 四、关键问题解决方案 1. **SSH 免密登录配置** ```bash # 在 GitLab Runner 服务器生成密钥 ssh-keygen -t rsa -b 4096 -C "gitlab-runner" # 将公钥复制到目标服务器 ssh-copy-id user@target-server ``` 在 GitLab CI 变量中设置 `SSH_PRIVATE_KEY`，并在脚本中加载： ```yaml before_script: - mkdir -p ~/.ssh - echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa - chmod 600 ~/.ssh/id_rsa ``` 2. **Maven/Gradle 缓存优化** 在 `.gitlab-ci.yml` 中添加缓存配置： ```yaml cache: paths: - .m2/repository - target/ ``` --- #### 五、完整流程验证 1. **触发条件** - 代码推送到 `main` 分支自动触发流水线 - 手动触发回滚部署 2. **监控与日志** 通过 GitLab Pipeline 界面实时查看构建状态，失败时可通过日志定位问题（如 Docker 镜像推送权限错误或 SSH 连接超时）。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值