

Ubuntu 18.04 Image#

The ubuntu1804 is a customized image based on Ubuntu 18.04 LTS optimized for CI/CD. It comes with a set of preinstalled languages, databases, and utility tools commonly used for CI/CD workflows. The image can be paired with any Linux machine type when defining the agent of your pipeline or block.

The ubuntu1804 is a virtual machine (VM) image. The user in the environment, named semaphore, has full sudo access. The image will be updated bi-weekly, on first and third Monday of every month. Updates can be followed on Semaphore Changelog.

The ubuntu1804 VM uses an APT mirror that is in the same data center as Semaphore's build cluster, which means that caching packages will have little effect.

Using the ubuntu1804 OS image in your agent configuration#

To use the ubuntu1804 OS image, define it as the os_image of your agent's machine.

version: 1.0
name: Ubuntu18 Based Pipeline

agent:
  machine:
    type: e1-standard-2
    os_image: ubuntu1804

blocks:
  - name: "Unit tests"
    task:
      jobs:
        - name: Tests
          commands:
            - make test

The ubuntu1804 OS image can be used in combination with all Linux machine types: e1-standard-2, e1-standard-4, e1-standard-8.

Toolbox#

The ubuntu1804 comes with two utility tools. One for managing background services and database, and one for managing language versions.

Version control#

Following version control tools are pre-installed:

Git (2.x)
Git LFS (Git Large File Storage)
Mercurial (4.5.x)
Svn (1.9.x)

Browsers and Headless Browser Testing#

Firefox 68.9
geckodriver 0.26.0
Google Chrome 83
chrome_driver 83
xvfb (X Virtual Framebuffer)
phantomjs 2.1.1

Chrome and Firefox both support headless mode. You shouldn't need to do more than install and use the relevant Selenium library for your language. Refer to the documentation of associated libraries when configuring your project.

Docker#

Docker toolset is installed and following versions are available:

Docker 19.03
docker-compose 1.26.0

Cloud CLIs#

aws-cli
eb-cli
ecs-cli
doctl
gcloud
kubectl
heroku

Network utilities#

httpie
curl
rsync

Languages#

Erlang and Elixir#

Erlang versions are installed and managed via kerl. Elixir versions are installed with kiex.

Erlang: 20.3, 21.3, 22.3, 23.0
Elixir: 1.7.4, 1.8.0, 1.8.1, 1.8.2, 1.9.0, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10.1, 1.10.2

Additional libraries:

rebar: 2.6.4
rebar3: 3.12.1

Go#

Versions:

1.10.8
1.11.13
1.12.17
1.13.12
1.14.4

Java and JVM languages#

Java: 8u242, 11.0.6
Scala: 2.11.11, 2.12.10
Leiningen: 2.9.1 (Clojure)
sbt

Additional build tools#

Maven: 3.6.3
Gradle: 5.2

JavaScript via Node.js#

Node.js versions are managed by nvm. You can install any version you need with nvm install [version]. Installed version:

v8.17.0 (set as default, with alias 8.17)
v10.19.0
v12.16.0

Additional tools#

Yarn: 1.22.4
Bower: 1.8.8

PHP#

PHP versions are managed by phpbrew. Installed versions:

7.0.33
7.1.33
7.2.31
7.3.18
7.4.6

The default installed PHP version is 7.2.29.

Additional libraries#

phpunit: 7.5.20

Python#

Python versions are installed and managed by virtualenv. Installed versions:

2.7
3.6
3.7
3.8

Supporting libraries:

pypy: 5.8.0
pypy3: 5.8.0
pip: 20.0.2
pip3: 19
venv: 16.0.0

Ruby#

Available versions:

1.8.7-p375
1.9.2-p330
1.9.3-p551
2.0.0-p648
2.1.0 to 2.1.10
2.2.0 to 2.2.10
2.3.0 to 2.3.8
2.4.0 to 2.4.10
2.5.0 to 2.5.8
2.6.0 to 2.6.6
2.7.0 and 2.7.1
jruby-9.2.11.1

Installing dependencies with apt package manager#

The Semaphore Ubuntu:18.04 image has most of the popular programming languages, tools and databases preinstalled.

If the dependency you need is not present in the list above, you can install it with the Ubuntu package manager or using an alternative method such as compiling it from the source, or manually downloading binaries.

To install dependecies using the package manager (apt-get) you can use the template command below and add it to your pipeline:

sudo apt-get update
sudo apt-get install -y [your-dependency]