张朝煌 · 更新于 2017-10-24 11:00:25

TeamCity 安装和配置

  • TeamCity

本文初衷

  • 让大家了解持续集成(CI),以及入门了解 JetBrains 家的 TeamCity 的一些简单实用。
  • TeamCity 的一些复杂使用我暂时也不会,一样也是要看文档的,所以不管怎样你都要养成看官网文档的习惯。
  • TeamCity 和 Jenkins、Hudson 其实是非常一样的,基本流程都是差不多的,所以如果你会其他的几个 CI 工具的话,学习起来很快。
  • Docker 已经开始在引入到 CI、CD(持续交付)过程中,可以大大简化整体的过程,也许这是未来的一个方向,有兴趣的可以了解更多。

它是什么

为什么会出现

哪些人喜欢它

哪些人不喜欢它

  • Google 不到结果,应该是没人不喜欢,只是有些人用不惯

为什么学习它

  • 更好地保证项目质量

同类工具

TeamCity 入门

TeamCity 安装部署(Linux 环境)

  • 在我讲之前,如果你英文还可以,就到官网这里看下:
  • Installation Quick Start
  • 安装环境要求:
    • JDK 1.7 以上,如果你要使用的是 2016 最新的 TeamCity 9.1 的话,JDK 官网推荐的 1.8
  • 安装包下载:https://www.jetbrains.com/teamcity/download/#section=linux-version
  • 开始安装(eg:TeamCity-9.1.6.tar.gz):
    • 解压压缩包(解压速度有点慢):tar zxf TeamCity-9.1.6.tar.gz
    • 解压完的目录结构讲解:https://confluence.jetbrains.com/display/TCD9/TeamCity+Home+Directory
    • 下载的 tar.gz 的本质是已经里面捆绑了一个 Tomcat,所以如果你会 Tomcat 的话,有些东西你可以自己改的。
    • 按我个人习惯,把解压缩的目录放在 usr 目录下:mv TeamCity/ /usr/program/
    • 进入解压目录:cd /usr/program/TeamCity/
    • 启动程序:/usr/program/TeamCity/bin/runAll.sh start
    • 停止程序:/usr/program/TeamCity/bin/runAll.sh stop
    • 启动需要点时间,最好能给它一两分钟吧

首次进入

  • 假设我们已经启动了 TeamCity
  • 访问(TeamCity 默认端口是:8111):http://192.168.1.113:8111/
  • 如果访问不了,请先关闭防火墙:service iptables stop
  • 你也可以选择把端口加入白名单中:
    • sudo iptables -I INPUT -p tcp -m tcp --dport 8111 -j ACCEPT
    • sudo /etc/rc.d/init.d/iptables save
    • sudo service iptables restart
  • 如果你要改变端口,找到下面这个 8111 位置:vim /usr/program/TeamCity/conf/server.xml
<Connector port="8111" ...
  • 在假设你已经可以访问的情况,我们开始进入 TeamCity 的设置向导:
  • TeamCity 向导
  • TeamCity 向导
    • 如上图英文所示,TeamCity 的一些构建历史、用户信息、构建结果等这类数据是需要放在关系型数据库上的,而默认它给我们内置了一个。
    • 如果你要了解更多 TeamCity External Database,你可以看:https://confluence.jetbrains.com/display/TCD9/Setting+up+an+External+Database
    • 首次使用,官网是建议使用默认的:Internal(HSQLDB),这样我们无需在一开始使用的就考虑数据库迁移或安装的问题,我们只要好好感受 TeamCity 给我们的,等我们决定要使用了,后续再更换数据也是可以的。但是内置的有一个注意点:'TeamCity with the native MSSQL external database driver is not compatible with Oracle Java 6 Update 29, due to a bug in Java itself. You can use earlier or later versions of Oracle Java.'
    • 假设我们就选 Internal(HSQLDB) ,则在创建初始化数据库的过程稍微需要点时间,我这边是几分钟。
  • TeamCity 向导
    • 如上图所示,接受下协议
  • TeamCity 向导
    • 如上图所示,我们要创建一个顶级管理员账号,我个人习惯测试的账号是:admin123456
  • TeamCity 向导

项目的构建、管理

  • 建议可以看下官网:https://confluence.jetbrains.com/display/TCD9/Configure+and+Run+Your+First+Build
  • 现在让我们开始创建一个项目进行构建
  • 项目管理地址:<http://192.168.1.113:8111/admin/admin.html?item=projects >
  • 假设我现在有一个项目的结构是这样的:
    • Youshop-Parent,输出是 pom
      • Youshop-manage,输出是 pom
        • Youshop-pojo,输出 jar
  • 我们现在以 Youshop-pojo 为例,让它自动构建并发布到 Nexus 中,其他项目道理是一样的,这里就不多说。
  • TeamCity 向导
  • 如上图,由于目前只要是公司的项目都应该是在版本控制的,所以这里我们选择:Create project from URL
  • TeamCity 向导
  • 如上图,我们可以看出 TeamCity 也支持 HTTP、SVN、Git 等链接方式。
  • TeamCity 向导
  • 输入你项目托管商的账号密码,我这里用的是 oschina 的。
  • TeamCity 向导
  • 账号、密码验证通过,现在可以给这个项目配置一个项目基本信息。
  • TeamCity 向导
  • 在从版本控制中下载文件和扫描文件
  • TeamCity 向导
  • TeamCity 自动扫描到我是用 Maven 构建的项目,所以把 POM 文件找出来了,如果你一个项目有多种构建方式,有对应的配置文件的话,这里都会显示出来的。
  • 我们勾选 Maven 前面的复选框,点击:Use Selected
  • TeamCity 向导
  • 由于我们的目标是构建完自动发布到 Nexus,所以我们的 Maven Goals 应该是:clean install deploy,这里我们应该点击:Edit,进行编辑。
  • 如果你不懂 Maven Goals,那你需要学习下,这个很重要。
  • TeamCity 向导
    • 如上图,这台服务器必须装有 Maven、JDK
    • 如上图,Goals 我们的目标是 clean install deploy
    • 如上图,Maven Home 我建议是自己自定义路径,这样肯定不会有问题。所以你服务器上的 Maven 安装路径是什么你就在这里填写上去。Maven 目前支持的最高版本是:3.2.5
    • 如上图,Java Parameters 我建议也是自己自定义路径,别选择其他选项。
  • TeamCity 向导
    • 如上图,点击 run,开始手动构建该项目
  • TeamCity 向导
    • 如上图,我们看到简略的构建日志
  • TeamCity 向导
  • TeamCity 向导
    • 如上 2 张图,我们看到详细的构建内容
  • TeamCity 向导
    • 如上图,当我们版本控制中有提交的时候,TeamCity 会识别到记录
  • TeamCity 向导
    • 如上图,我们可以看到提交的 Commit Message 信息。
    • 如上图,右边红圈的三个按钮是用来处理这次提交的,常用的是第一次按钮,点击对此次版本进行构建
  • TeamCity 向导
    • 如上图,如果你要看所有的提交记录,可以在 Change Log 看到并且指定版本构建
  • TeamCity 向导
    • 如上图,如果在你不想要这个项目的时候可以进行删除
  • TeamCity 向导
    • 如上图,因为 Goals 里面有 deploy 命令,所以构建完成会发布到 Nexus 中,这样团队的人就可以用到最新的代码了
  • TeamCity 向导
    • 如上 gif 图演示,项目常去的几个配置地方就是这样些了

配置自动构建触发行为

  • 官网提供的触发行为有:https://confluence.jetbrains.com/display/TCD9/Configuring+Build+Triggers
  • 下面我们举例说常见的:VCS TriggerSchedule Trigger
  • TeamCity 向导
    • 如上图,点击 Add new trigger 添加触发器
  • TeamCity 向导
    • 如上图,常见的触发器就这些了
  • TeamCity 向导
    • 如上图,配置好 VCS Trigger 效果是,当我们有代码提交的时候,TeamCity 检查到新版本之后自动构建,这个最常用
  • TeamCity 向导
    • 如上图,Schedule Trigger 的作用就是定时构建,除了常用的几个输入框设置定时外,TeamCity 还可以使用 Cron 语法进行设置
    • TeamCity 采用的 Cron 语法是 Quartz,具体你可以看:Quartz CronTrigger Tutorial
    • 如果你不懂 Cron 语法那就算了,但是我想做 Java 这个应该要会的

集成 IntelliJ IDEA

  • 安装 IntelliJ IDEA:https://confluence.jetbrains.com/display/TCD9/IntelliJ+Platform+Plugin
  • TeamCity 向导
    • 如上图,我们可以直接连上 TeamCity 服务器,这里的用户名密码是 TeamCity 的账号系统。
  • TeamCity 向导
    • 如上图,连上去的效果是这里会打钩
  • TeamCity 向导
    • 如上图,我们可以直接把别人提交的内容做 patch 直接用 IntelliJ IDEA 进行整合
    • 还有其他很多结合玩法大家可以自己去尝试下

其他