Languages & Other Image Customizations

Languages

We install a range of languages in many different versions in the default image.

Java

We install several Java versions, and currently support the following versions:

java-1.7.0-openjdk-amd64, java-7-oracle, and java-8-oracle

build:
    environment:
        java: java-8-oracle

You can also set up Java versions with SDKMAN! which provides access to a wider range of Java versions you can choose from:

build:
    environment:
        sdkman:
            - [email protected]

Node

We install a few node versions by default. If you specify a version which is not listed here, it will automatically be downloaded and installed in your build environment.

All released versions are supported, some examples are:

0.10.29, 0.11.13, 0.12.4, v4.2.2, v5.1.0, v6.2.0, iojs-v1.3.0, iojs-v1.8.4, iojs-v2.5.0, iojs-v3.3.1

build:
    environment:
        node: v6.2.0

For node, we also support installation of any released version on-the-fly. You can type nvm ls-remote in SSH debug mode to retrieve a list of all available versions.

PHP

We use phpenv for managing PHP versions and currently support the following versions:

5.4.41, 5.5.25, 5.6.9, 5.6.16, 7.0.8, 7.0.20, 7.1.1, 7.1.6, 7.1.12, 7.2.0 and hhvm

build:
    environment:
        php: 7.0.6

Python

We use pyenv for managing Python versions and currently support the following versions:

2.7.7, 3.2.5, 3.3.5, 3.4.1, 3.4.6, 3.5.0, 3.6.0, 3.6.3, jython-2.5.3, jython-2.7.0, pypy-2.3.1, stackless-3.3.5, pypy-2.4.0, pypy-2.6.1, pypy-4.0.0, pypy-5.6.0, pypy2-5.6.0, pypy3-2.4.0, stackless-3.4.1

build:
    environment:
        python: 3.5.0

Ruby

We use rbenv for managing Ruby versions and currently support the following versions:

1.8.7-p375, 1.9.2-p320, 1.9.3-p547, 2.0.0-p481, 2.1.2, 2.1.5, 2.2.0, 2.2.3, 2.3.1, 2.4.0, 2.4.2, jruby-1.7.9, 'jruby-1.7.19, jruby-9.0.4.0, jruby-9.1.1.0

build:
    environment:
        ruby: 2.3.1

Go

We use gvm for managing Go versions and currently support the following versions:

go1.4.2, go1.3.3, go1.5.1 , go1.6.2, go1.7.3, go1.8.5 and go1.9.2

build:
    environment:
        go: go1.6.2

Groovy

We use SDKMAN! for managing Groovy version:

build:
    environment:
        sdkman:
            - [email protected]

For more details about available Groovy versions supported by SDKMAN, please check SDKMAN! documentation <http://sdkman.io/sdks.html>

Scala SBT

We install several scala sbt versions. The following are supported currently:

sbt-0.12.4, sbt-0.13.2

Other Image Customizations

Besides languages, we also allow you to customize our default image through simple configuration settings instead of requiring you to run complex commands inside the container.

Apache2

If you would like your website to be accessible via the Apache webserver, you can define a basic set-up and we will generate the necessary configuration files automatically. You can optionally rewrite the Apache rules by adding them under the rule key.

build:
    nodes:
        functional-tests:
            environment:
                apache2:
                    modules: ['rewrite']
                    sites:
                        symfony_app:
                            web_root: 'web/'
                            host: 'local.dev'
                            rules:
                                - 'RewriteCond %{HTTP_REFERER} !^$'
                                - 'RewriteCond %{HTTP_REFERER} !^http://(www.)?example.com/ [NC]'
                                - 'RewriteRule .(gif|jpg|png)$ - [F]'

The above configuration will generate the following configuration file for Apache2:

<VirtualHost *:80>
    DocumentRoot /home/scrutinizer/build/web/
    ServerName local.dev

    LogLevel warn
    ErrorLog /home/scrutinizer/artifacts/symfony_app-error.log
    CustomLog /home/scrutinizer/artifacts/symfony_app-access.log combined

    <Directory /home/scrutinizer/build/web/>
        Options All
        AllowOverride All
        Require all granted

        DirectoryIndex index.php
        DirectoryIndex app.php
    </Directory>

    RewriteCond %{HTTP_REFERER} !^$
    RewriteCond %{HTTP_REFERER} !^http://(www.)?example.com/ [NC]
    RewriteRule .(gif|jpg|png)$ - [F]

    LoadModule php7_module /home/scrutinizer/.phpenv/versions/7.0/libexec/libphp7.so
    <FilesMatch \.php[0-9]*$>
        SetHandler application/x-httpd-php
    </FilesMatch>
</VirtualHost>

NGINX

Scrutinizer also allows you to access your website with NGINX webserver via PHP-FPM, we will automatically generate configuration files for NGINX based on your configuration.

build:
  nodes:
    functional-tests:
      environment:
        nginx:
              sites:
                symfony_app:
              host: 'local.dev'
              web_root: 'web/'

              # These are optional and usually do not require changing.
              index: 'index.php index.html'

              # By default Scrutinizer will generate the following location block for the configuration file.
              # But you can simply overwrite it with your own location blocks by adding them under ``locations``

              locations:
                - >
                   location ~ [^/]\.php(/|$) {
                       try_files $uri $uri/ /index.php /index.html;
                       fastcgi_index index.php;
                       fastcgi_split_path_info ^(.+?\.php)(/.*)$;
                       fastcgi_pass 127.0.0.1:9000;
                       include fastcgi_params;
                   }

PHP-FPM is using default address (127.0.0.1:9000). Please set fastcgi_pass to 127.0.0.1:9000 in your location block.

For the above configuration, we will generate following configuration file for Nginx:

# /etc/nginx/sites-enabled/symfony_app
server {
    server_name local.dev;

    root web/;
    index index.php index.html;

    location ~ [^/]\.php(/|$) {
        try_files $uri $uri/ /index.php /index.html;
        fastcgi_index index.php;
        fastcgi_split_path_info ^(.+?\.php)(/.*)$;
        fastcgi_pass 127.0.0.1:9000;
        include fastcgi_params;
    }

    error_log /home/scrutinizer/artifacts/nginx-symfony_app-error.log;
    access_log /home/scrutinizer/artifacts/nginx-symfony_app-access.log;
}

Setting the timezone

By default, we use UTC as timezone. If you need something else, just set the tz identifier in the configuration:

build:
    environment:
        timezone: 'US/Pacific'

Defining hostnames

If you would like to define custom hostnames, f.e. to be able to access the webserver via this host, you can define these in the environment section, too:

build:
    environment:
        hosts:
            local.dev: '127.0.0.1'

Selenium

If you would like to run Selenium tests, you can start a Selenium server configured with Firefox and Google Chrome. Simply add the following to your configuration:

build:
    environment:
        selenium: true

The Selenium server will then listen at the default address 127.0.0.1:4444. Please refer to our Selenium page for configuration details and installed versions.

Google Chrome

If you would like us to download the most recent Google Chrome version along with the respective Chrome-driver, you can enable the edge version in your configuration:

build:
    environment:
        google_chrome:
            use_latest: true