Write the Code. Change the World.

2月 21

版权声明

原文档 Travis CI Documentation 属 Travis CI GmbH 版权所有,采用MIT许可协议。

本译文版权已受 Travis CI 认可,同样采用MIT许可协议。

相关说明

翻译水平有限,有些地方翻译的不好,请谅解,如果您能指出来,我会非常感激并会在第一时间做出修改。

主要在Github发布,博客同步更新。


Travis CI 文档中文翻译(一) 入门

原文档:http://docs.travis-ci.com/user/getting-started/

Travis CI 概述

Travis CI 提供持续集成的服务。它与 Github 结合,给下面一些语言提供一流的支持:

C
C++
Clojure
C#
D
Dart
Erlang
F#
Go
Groovy
Haskell
Java
JavaScript (with Node.js)
Julia
Objective-C
Perl
PHP
Python
Ruby
Rust
Scala
Visual Basic

Travis CI 的构建环境为不同的语言提供不同的运行时,例如 Ruby, PHP, Node.js 的多种版本。它也有一些预设的数据存储和常用工具,例如 message brokers。

你能够很容易地测试使用不同语言甚至不同数据存储的项目。

第一步:登录

登录你的Github账号来开始使用 Travis CI。打开 Travis CI ,点击顶部的登录链接。

注意,https://travis-ci.org/ 你只能看到你的公共库,而在 https://travis-ci.com/ 你就可以看到你的私有库了

当你登录的时候,Github 将会代表我们请求你的一些权限。我们详细列出了这些权限和它们的作用

第二步:激活 Github Webhook

一旦你登录成功,我们会开始从 Github 上同步你的仓库。你可以访问你的公共库个人资料页或者私有库个人资料页

你会看到你所属的组织和你所有的仓库,但只有那些你管理的仓库才能开启服务钩子。

为你想开启服务的仓库打开开关。

第三步:在仓库中添加 .travis.yml 文件

为了能让 Travis CI 成功构建你的项目,你需要告诉系统一些项目的信息。你需要在仓库的根目录添加 .travis.yml 文件。

本指南只涉及 .travis.yml 的基本选项。最重要的选项是 language 字段,它告诉 Travis CI 为你的项目选择哪个语言环境。

例如 Ruby 项目通常跟 Clojure 和 PHP 项目使用不同的构建工具和构建方式,所以 Travis CI 需要知道它要做什么。

如果仓库中没有 .travis.yml 文件或拼写错误或不符合 YAML, Travis CI 就会忽略它,并认为你的项目用 Ruby 作为编程语言,一切使用默认值。

注意

language 字段是大小写敏感的。如果你写成了 language: C,那么项目会被认为是 Ruby 项目。

这里有一些 .travis.yml 的基本例子

C

查看更多关于 C 项目的 .travis.yml 选项

C++

查看更多关于 C++ 项目的 .travis.yml 选项

Clojure

使用 Leiningen 1 的项目:

使用 Leiningen 2 的项目:

查看更多关于 Clojure 项目的 .travis.yml 选项

C#, F#, and Visual Basic

查看更多关于 C# 项目的 .travis.yml 选项

Dart

查看更多关于 Dart 项目的 .travis.yml 选项

Erlang

查看更多关于 Erlang 项目的 .travis.yml 选项

Haskell

查看更多关于 Haskell 项目的 .travis.yml 选项

Go

查看更多关于 Go 项目的 .travis.yml 选项

Groovy

查看更多关于 Groovy 项目的 .travis.yml 选项

Java

查看更多关于 Java 项目的 .travis.yml 选项

Julia

查看更多关于 Julia 项目的 .travis.yml 选项

Node.js

查看更多关于 Node.js 项目的 .travis.yml 选项

Objective-C

查看更多关于 Objective-C 项目的 .travis.yml 选项

Perl

查看更多关于 Perl 项目的 .travis.yml 选项

PHP

查看更多关于 PHP 项目的 .travis.yml 选项

Python

查看更多关于 Python 项目的 .travis.yml 选项

Ruby

查看更多关于 Ruby 项目的 .travis.yml 选项

Scala

查看更多关于 Scala 项目的 .travis.yml 选项

验证 .travis.yml 文件

我们推荐你使用 travis-lint (命令行工具)或者 .travis.yml validation Web app 来验证你的 .travis.yml 文件。

travis-lint 需要安装 Ruby 1.8.7+ 和 RubyGems。 用下面的命令来获取:

对你的 .travis.yml 使用:

travis-lint 将这样来验证:

  • .travis.yml 文件 符合 YAML
  • 存在 language 字段
  • 指定的运行时环境(Ruby, PHP, OTP 等)被 Travis CI 环境 支持
  • 你没使用已被弃用的特征或运行时别名 ……

travis-lint 是你的得力助手,快来用吧٩(๑`н´๑)۶

第四步:Push 代码来触发第一次构建

一旦 GitHub hook 装配好,push 一次 commit,向仓库中添加 .travis.yml。这样应该能在 Travis CI 的其中一个队列添加一个构建任务,当其编程语言的一个 worker 空闲时,构建任务就会开始执行。

如果你想重新构建,可以执行以下操作:

  1. Commit 和 push 一些东西到你的仓库。
  2. 打开你仓库的设置页,点击左边菜单的 “Webhooks & Services” 按钮,选择 “Services” 标签里的 “Travis CI”,点击 “Test service” 按钮。

请注意,你不能用 Test service 按钮来触发第一次构建任务。第一次只能用 push 代码来触发。

第五步:调整构建配置

也许,你的项目需要对构建过程做一些自定义。可能你需要在运行测试之前创建一个数据库,或者你需要跟 Travis CI 默认选项不同的构建工具。不用担心,Travis CI 允许你修改几乎所有的东西。

学习怎样 自定义你的构建任务 或者 怎样为你的项目安装依赖

.travis.yml 做了改变后,不要忘了检查它是否 符合 YAML,运行 travis-lint 来验证它。

第六步:了解更多

一个 Travis CI worker 自带很多你可能会依赖的服务,包括 MySQL, PostgreSQL, MongoDB, Redis, CouchDB, RabbitMQ, memcached 等。

点击 安装数据库 来了解怎样为你的测试连接数据库。关于我们测试环境的更多信息可以在 另一份指南 中找到。

第七步:有我们帮助你!

如果你有任何问题,欢迎使用 IRC 与我们联系 #travis on chat.freenode.net。

发表评论

电子邮件地址不会被公开。 必填项已用*标注

活捉 13 条