How-To Create a Docker-Compose Override File

Preface

In this guide we’ll learn how to create a docker-compose override file. The Compose file is a YAML file defining services, networks and volumes. Skyformation provides a docker-compose.yml which contains the base configuration. You may want to add configuration override for existing services - for example, preferred  ports, volumes etc. This section will show where you can find the default Skyformation docker-compose.yml file, and how to create a docker-compose.override.yml file. 

Steps

Find the docker-compose.yml file

You may find the docker-compose.yml file in /opt/exabeam/data/sk4 on Exabeam type deployment, or in /opt/sk4 in standalone deployments. You can find its location by looking at the Exabeam Cloud Connector’s service file /etc/systemd/system/sk4compose.service.

Create a docker-compose.override.yml file 

In that directory, you may create a docker-compose.override.yml file and add the configurations you want. Make sure you add the service name and the configurations you would like to override or add.

For example, we can change the ports of the sk4tomcat container. The docker-compose.yml file will look like:

version: '3'
services:
  sk4tomcat:
    ports:
    - "8443:8443"

And the docker-compose.override.yml will look like: 

version: '3'
services:
  sk4tomcat:
    ports:
    - "8080:8080"

Update the Exabeam cloud connector’s service file docker-compose execute command

In the etc/systemd/system/sk4compose.service file add a -f flag with the docker-compose.override.yml file:

ExecStart=/usr/local/bin/docker-compose -f <path to docker-compose.yml> -f <path to docker-compose.yml.override.yml> up

ExecStop=/usr/local/bin/docker-compose -f <path to docker-compose.yml> -f <path to docker-compose.override.yml> down

*When the path to the docker-compose.yml and docker-compose.override.yml files is in /opt/exabeam/data/sk4 on Exabeam type deployment, or in /opt/sk4 in standalone deployments.