Trusty Build Containers for Enterprise

System Setup #

Platform Requirements: To use the Trusty build containers, the Travis CI installation must be at 2.1.9 or higher. Please be sure to upgrade, if needed, before getting started.

Worker Requirements:

We recommend using a machine with 8 vCPUs and 15 GiB of memory and at least 40 GiB of disk space. If you’re using AWS that will be their c4.2xlarge instance type. Also, you’ll want to run Ubuntu 16.04 or later. Port 22 must be open for SSH during installation and operation.

Precise build containers and Trusty build containers must be on different instances. To run both Precise and Trusty builds, at least two worker instances are required.

Installation with Travis CI Enterprise 2.2+ #

Once a worker instance is up and running, travis-worker can be installed as follows:

curl -sSL -o /tmp/installer.sh https://enterprise.travis-ci.com/install/worker

sudo bash /tmp/installer.sh \
--travis_enterprise_host="[travis.yourhost.com]" \
--travis_enterprise_security_token="[RabbitMQ Password/Enterprise Security Token]"

This installer uses Docker’s aufs storage driver. If you have any questions or concerns, please get in touch with us to discuss alternatives.

Installation with Travis CI Enterprise 2.1.9+ #

The Travis CI Enterprise 2.1 series has the Precise [Legacy] as it’s default worker. However, starting with version 2.1.9+, it is possible to use Trusty build environments, assuming the feature flags are set. Otherwise, the installation process is very similar to the Enterprise 2.2 series.

Enabling the Trusty Beta Feature Flag #

  1. SSH into the platform machine
  2. Run travis console
  3. Then run Travis::Features.enable_for_all(:template_selection); Travis::Features.enable_for_all(:multi_os)
  4. Type in exit to leave the console
  5. Disconnect from the Travis Enterprise platform machine

Installation (Travis CI Enterprise 2.1.9+) #

Once a worker instance is up and running, travis-worker can be installed as follows:

curl -sSL -o /tmp/installer.sh https://enterprise.travis-ci.com/install/worker

sudo bash /tmp/installer.sh \
--travis_enterprise_host="[travis.yourhost.com]" \
--travis_enterprise_security_token="[RabbitMQ Password/Enterprise Security Token]"

This installer uses Docker’s aufs storage driver. If you have any questions or concerns, please get in touch with us to discuss alternatives.

Running builds on Trusty on Travis CI Enterprise 2.1.9+ #

To run builds on a worker with Trusty images, please add dist: trusty to your .travis.yml. If that key is not present in your project’s .travis.yml, the build will routed to the default (Precise) build environments instead.

Restarting travis-worker #

After installation, or when configuration changes are applied to the worker, restart the worker as follows:

sudo service travis-worker restart

Worker configuration changes are applied on start.

Contact Enterprise Support #

To get in touch with us, please write a message to enterprise@travis-ci.com. If possible, please include as much of the following as you can:

  • Description of the problem - what are you observing?
  • Which steps did you try already?
  • A support bundle (You can get it from https://yourdomain:8800/support)
  • Log files from all workers (They can be found at /var/log/upstart/travis-worker.log - please include as many as you can retrieve).
  • If a build failed or errored, a text file of the build log

Have you made any customizations to your setup? While we may be able to see some information (such as hostname, IaaS provider, and license expiration), there are many other things we can’t see which could lead to something not working. Therefore , we’d like to ask you to also answer the questions below in your support request (if applicable):

  • How many machines are you using?
  • Do you use configuration management tools (Chef, Puppet)?
  • Which other services do interface with Travis CI Enterprise?
  • Do you use Travis CI Enterprise together with github.com or GitHub Enterprise?
  • If you’re using GitHub Enterprise, which version of it?

We’re looking forward to helping!