aseba/jenkins

Aseba Jenkins 镜像

镜像概述和主要用途

Aseba Jenkins镜像为Aseba组件的构建提供Jenkins代理环境，基于resources/buildfarm/docker/Dockerfile构建，支持在Jenkins 2中实现Aseba项目的自动化构建流程。该镜像集成了构建Aseba所需的依赖环境和Jenkins插件，同时提供全局库函数简化构建配置。

核心功能和特性

全局库支持

将仓库声明为https://github.com/jenkinsci/workflow-cps-global-lib-plugin/blob/master/README.md%E5%90%8E%EF%BC%8C%E5%8F%AF%E6%8F%90%E4%BE%9B%E4%BB%A5%E4%B8%8B pipeline 步骤函数：

CMake 函数

用于配置、构建和安装程序，参数说明如下：

• sourceDir：源代码目录（默认：工作目录）
• getGenerator：构建生成器（默认：'Unix Makefiles'）
• buildType：构建类型（默认：'Debug'）
• buildDir：构建目录（默认：工作目录 + '/build'）
• installDir：安装目录（默认：工作目录 + '/dist'）
• makeInvocation：make命令（默认：'make'）
• makeInstallInvocation：make install命令（默认：'make install'）
• getCmakeArgs：额外的CMake参数（列表或单个字符串，无默认值）
• label：可选子目录，追加到buildDir和installDir

注：此函数是临时解决方案，等待https://wiki.jenkins-ci.org/display/JENKINS/CMake+Plugin%E6%94%AF%E6%8C%81Jenkins Pipeline（参见https://issues.jenkins-ci.org/browse/JENKINS-34998%EF%BC%89%E3%80%82%E5%85%B6%E5%8F%82%E6%95%B0%E8%AE%BE%E8%AE%A1%E4%B8%8Ehttps://wiki.jenkins-ci.org/display/JENKINS/CMake+Build+Configuration%E4%BF%9D%E6%8C%81%E4%B8%80%E8%87%B4%EF%BC%8C%E5%90%8C%E6%97%B6%E6%89%A7%E8%A1%8CCMake%E9%85%8D%E7%BD%AE%E5%92%8C%E6%9E%84%E5%BB%BA%EF%BC%88make%E3%80%81make install）。

FindAvailableNodes 函数

过滤候选节点标签列表（默认：['debian','windows','macos']），仅返回当前Jenkins实例中可用的节点标签。

资源文件

Ansible Playbooks

resources/buildfarm目录包含Ansible playbooks，用于在Linux、macOS和Windows上安装Aseba编译所需的开发环境。使用前需自定义hosts inventory以匹配实际安装环境。

Docker环境配置

resources/buildfarm/docker目录包含Dockerfile，用于构建包含Aseba构建依赖和Jenkins插件的Debian构建环境，可直接运行Jenkins容器提供构建节点。

使用场景和适用范围

适用于Aseba项目的持续集成/持续部署（CI/CD）流程，尤其适合需要在多操作系统（Linux、macOS、Windows）环境下自动化构建、测试Aseba组件的开发团队。

详细使用方法和配置说明

全局库配置

1. 在Jenkins中配置全局库：
   • 进入Manage Jenkins > Configure System > Global Pipeline Libraries
   • 添加库名称，选择"Modern SCM"，配置仓库地址
   • 设置默认版本（如分支或标签）

CMake函数使用示例

groovy
pipeline {
    agent any
    stages {
        stage('Build Aseba') {
            steps {
                script {
                    CMake(
                        sourceDir: 'src',
                        buildType: 'Release',
                        getCmakeArgs: '-DCMAKE_INSTALL_PREFIX=/opt/aseba',
                        label: 'aseba-build'
                    )
                }
            }
        }
    }
}

FindAvailableNodes函数使用示例

groovy
def availableNodes = FindAvailableNodes(['debian', 'ubuntu', 'windows'])
echo "Available build nodes: ${availableNodes}"

Docker部署示例

构建镜像

bash
cd resources/buildfarm/docker
docker build -t aseba-jenkins-agent .

运行Jenkins容器

bash
docker run -d -p 8080:8080 -p 50000:50000 --name aseba-jenkins docker.xuanyuan.run/aseba-jenkins-agent

Docker Compose配置（docker-compose.yml）

yaml
version: '3'
services:
  jenkins:
    image: docker.xuanyuan.run/aseba-jenkins-agent
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
volumes:
  jenkins_home:

Ansible Playbooks使用

1. 自定义hosts inventory文件：

ini
[linux]
build-linux-1 ansible_host=192.168.1.100
build-linux-2 ansible_host=192.168.1.101

[macos]
build-macos-1 ansible_host=192.168.1.200

[windows]
build-windows-1 ansible_host=192.168.1.300

2. 运行playbook安装开发环境：

bash
ansible-playbook -i hosts resources/buildfarm/linux.yml
ansible-playbook -i hosts resources/buildfarm/macos.yml
ansible-playbook -i hosts resources/buildfarm/windows.yml