如何快速掌握 Travis CI 构建工具：从.travis.yml到build.sh的完整指南
项目地址: https://gitcode.com/gh_mirrors/tr/travis-build Travis CI 构建工具是一款能够将.travis.yml配置文件转换为可执行build.sh脚本的强大工具，它为开发者提供了便捷的持续集成解决方案。通过Travis Build暴露的API，Travis Workers和Job Board可以生成bash脚本，该脚本会被复制到作业执行环境中并执行，执行结果会流式返回给Travis。
Travis Build 的核心功能与价值
Travis Build 最初是从 legacy Travis Worker 中提取出来的，经过多次迭代发展成现在的形式。它的核心功能是将开发者编写的.travis.yml文件转换为实际可执行的build.sh脚本，这一过程大大简化了持续集成的配置和执行流程。
快速上手：运行测试 suites
要开始使用 Travis Build，首先需要运行测试 suites。在项目目录下执行以下命令：
bundle exec rake spec
将 Travis Build 用作 Travis CLI 的插件
安装步骤
你可以将 travis-build 设置为 Travis 命令行客户端的插件，具体步骤如下：
- 克隆仓库：
git clone https://gitcode.com/gh_mirrors/tr/travis-build
- 进入项目目录：
cd travis-build
- 创建相关目录并建立链接：
mkdir -p ~/.travis
ln -s $PWD ~/.travis/travis-build
- 安装 bundler 并安装依赖：
gem install bundler
bundle install --gemfile ~/.travis/travis-build/Gemfile
bundler binstubs travis
使用 travis compile 命令
完成上述安装后，你就可以运行 travis compile 命令了，它会生成运行指定作业的 bash 脚本（注意：安全环境变量未定义，构建矩阵扩展也未考虑）。例如：
~/.travis/travis-build/bin/travis compile
⚠️ 重要提示：compile 命令生成的 bash 脚本包含会对执行它的系统进行更改的命令（例如，编辑
/etc/resolv.conf，安装软件）。其中一些命令需要sudo权限，并且不容易撤销。强烈建议在容器或其他虚拟化环境中运行此脚本。
三种调用方式
该命令可以通过以下 3 种方式调用：
- 不带参数：从本地.travis.yml中的操作生成并打印 bash 脚本，不考虑 env 和 matrix 值（travis-build 无法正确扩展这些键）。
~/.travis/travis-build/bin/travis compile
- 带单个整数：为给定构建（或该构建矩阵的第一个作业）生成脚本。
~/.travis/travis-build/bin/travis compile 8
- 带 M.N 形式的参数：为作业 M.N 生成 bash 脚本。
~/.travis/travis-build/bin/travis compile 351.2
生成的脚本可用于紧密模拟 Travis CI 构建环境的容器或虚拟化环境，以帮助你调试构建失败。有关运行此类容器的说明可参考相关文档。
独立 CLI 脚本的使用
除了作为 Travis CLI 插件外，你还可以运行独立的 CLI 脚本：
bundle exec script/compile < payload.json > build.sh
Docker 容器化运行
如果你想在本地机器上运行 travis-build（例如，与 worker 交互），也可以通过 docker-compose 将其作为 docker 容器运行：
构建镜像
docker-compose build web
运行镜像
docker-compose run web
对于本地开发，你可能希望使用不同的设置。以下命令显示在development环境中运行travis-build，将 Docker 镜像的 4000 端口转发到主机的 4000 端口：
docker-compose run -e RACK_ENV=development -p 4000:4000 web
运行后，会创建一个容器，其中travis-build仓库的内容位于/usr/src/app目录，并从该目录开始。从那里，你可以运行作为 Travis CLI 的插件使用部分中列出的命令，使 compile 命令在容器内可用于 Travis CLI。
深入了解项目结构
Travis Build 项目包含多个重要的目录和文件，例如：
- lib/travis/build/script.rb：构建脚本相关的核心代码
- spec/build/script/shared/appliances/env.rb：环境相关的测试代码
- script/compile：独立的编译脚本
通过探索这些文件和目录，你可以更深入地了解 Travis Build 的工作原理和实现细节。
总结
通过本文的介绍，你已经了解了 Travis CI 构建工具从.travis.yml到build.sh的转换过程以及相关的使用方法。无论是将其作为 Travis CLI 的插件，还是运行独立的 CLI 脚本，亦或是通过 Docker 容器化运行，Travis Build 都能为你的持续集成工作流提供强大的支持。开始使用 Travis Build，提升你的开发效率吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
