Pipeline optimization: Docker Compose

This guide describes how to deploy the pipeline optimization service (referred to as groundswell in the configuration file) for Seqera Platform Enterprise using Docker Compose.

Prerequisites

Other than the basic requirements already listed in the Pipeline Optimization installation overview, you will need:

• Docker Engine and Docker Compose

New installation

1. Set the TOWER_ENABLE_GROUNDSWELL environment variable in tower.env to true. This enables the service at the default URL http://groundswell:8090.

   To use a custom URL, set GROUNDSWELL_SERVER_URL instead.

2. In your docker-compose.yml file, uncomment the groundswell section.

3. To create a schema on the local MySQL container, uncomment the init.sql script in the volumes section.

4. Download the init.sql file and store it in the mount path of your docker-compose.yml.

5. Start your Platform instance:

   docker compose up -d

Existing installation

1. Set the TOWER_ENABLE_GROUNDSWELL environment variable in tower.env to true.

   To use a custom URL, set GROUNDSWELL_SERVER_URL instead.

2. In your docker-compose.yml file, uncomment the groundswell section.

3. Create the Groundswell database schema:

   CREATE DATABASE IF NOT EXISTS `swell`;
   CREATE USER 'swell'@'%' IDENTIFIED BY 'swell';
   GRANT ALL PRIVILEGES ON *.* TO 'swell'@'%';
   FLUSH PRIVILEGES;

   For managed database services (RDS, Cloud SQL, etc.):

   CREATE DATABASE IF NOT EXISTS `swell`;
   CREATE USER 'swell'@'%' IDENTIFIED BY 'swell';
   GRANT ALL PRIVILEGES ON `%`.* TO 'swell'@'%';
   FLUSH PRIVILEGES;

4. Download the groundswell.env file and update the database URLs:

   TOWER_DB_URL=mysql://db:3306/tower
   SWELL_DB_URL=mysql://db:3306/swell

5. Restart your Platform instance:

   docker compose up -d

Verify

When pipeline optimization is active, pipelines with at least one successful run display a lightbulb icon in the Launchpad.

Configuration

See Pipeline optimization for additional configuration options.