Setting up Travis CI Enterprise Worker Machine

The Travis CI Enterprise Worker machine manages build containers and reports build statuses back to the platform. It must be installed on a separate machine instance from the Platform. We recommend using compute optimized instance with 8vCPU and 16GB RAM running with Ubuntu 16.04 or later.

Prerequisites #

1. Enterprise 3.x or Enterprise 2.x Platform is set up
2. You need the RabbitMQ password and the hostname from the Platform Dashboard.

Setting up the Worker #

1. On your virtual machine management platform, create a Travis CI Worker Security Group

   If you’re setting up Worker image for the first time, you will need to create a Security Group or Firewall rules. From the management console, create an entry for each port in the table below:

   Port	Service	Description
   22	SSH	Allow inbound SSH traffic in order to access Worker Machine from your local machine.

2. On your new virtual machine, download and run the following installation script:

    $ curl -sSL -o /tmp/installer.sh https://raw.githubusercontent.com/travis-ci/travis-enterprise-worker-installers/master/installer.sh
    $ sudo bash /tmp/installer.sh --travis_enterprise_host="<enterprise host>" --travis_enterprise_security_token="<rabbitmq password>"
   

Installing Workers behind a web proxy #

If you are behind a web proxy and Docker fails to download the image(s), when you run the worker installation script, edit /etc/default/docker and set your proxy there. Then rerun the installation script.

If you need Docker itself to use an HTTP proxy, export it before each docker command:

export http_proxy="http://proxy.mycompany.corp:8080/" docker <COMMAND>

Older versions of Travis CI Enterprise #

After setting up a new instance for the worker, please follow the respective guides for your Travis CI Enterprise version.

Setting up the LXD Worker #

1. On your virtual machine management platform, create a Travis CI Worker Security Group

   If you’re setting up Worker image for the first time, you will need to create a Security Group or Firewall rules. From the management console, create an entry for each port in the table below:

   Port	Service	Description
   22	SSH	Allow inbound SSH traffic in order to access Worker Machine from your local machine.

2. On your new virtual machine, download and run the following installation script:

    $ curl -sSL -o /tmp/lxd_install.sh https://raw.githubusercontent.com/travis-ci/travis-enterprise-worker-installers/master/lxd/lxd_install.sh
    $ sudo bash /tmp/lxd_install.sh --travis_enterprise_host="<enterprise host>" --travis_enterprise_security_token="<rabbitmq password>" --travis_build_images_arch=”<architecture>”
   

   Focal images are installed by default, you can change this by providing a --travis_build_images parameter.

Advanced Configuration #

You can change the LXC storage for instances from the default by using a --travis_storage_for_instances flag. You can change the LXC storage for data from the default by using a --travis_storate_for_data flag.

By default, the installer creates an IP4 network for LXC and assigns address 192.168.0.1 to it. The IP6 network is off by default. To alter these parameters, use the following installation flags: