Pipeline optimization: Docker Compose

This guide describes how to deploy the pipeline resource optimization service (Groundswell) for Seqera Platform Enterprise with Docker Compose.

Prerequisites

Before you begin, you need:

• A running Seqera Platform Enterprise Docker Compose deployment
• Access to your MySQL database

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 resource optimization for additional configuration options.