Add wave.build.template config option

[pditommaso]

Summary

Add support for specifying build templates in Wave container builds. This allows users to select optimized multi-stage build templates for smaller container images.

Changes

• Added template field to BuildOpts in WaveConfig.groovy
• Added buildTemplate() getter method in WaveConfig
• Added buildTemplate field to SubmitContainerTokenRequest
• Updated WaveClient to include buildTemplate in API requests
• Added wave.build.conda.baseImage config option for multi-stage builds
• Added tests for the new configuration options
• Updated documentation in docs/wave.md and docs/reference/config.md

Configuration

wave {
    enabled = true
    build {
        template = 'conda/pixi:v1'
        conda {
            baseImage = 'debian:12'  // Custom base image for final stage
        }
    }
}

Supported Templates

Template	Description
(default)	Standard Micromamba v1 single-stage build
conda/micromamba:v2	Multi-stage build using Micromamba 2.x
conda/pixi:v1	Multi-stage build using Pixi package manager
cran/installr:v1	R/CRAN packages using installr

New Configuration Options

Option	Description	Default
wave.build.template	Build template to use	conda/micromamba:v1
wave.build.conda.baseImage	Base image for final stage in multi-stage builds	ubuntu:24.04

Note: wave.build.conda.baseImage only applies when using conda/micromamba:v2 or conda/pixi:v1 templates.

Benefits of Multi-stage Templates

• Smaller images: Build tools excluded from final image (30-50% size reduction)
• Reproducibility: Lock files generated for exact package versions
• Security: Fewer binaries reduces attack surface

Test Plan

• Added unit test for buildTemplate configuration
• Added unit test for baseImage configuration
• Updated toString() test to include new fields
• Verified compilation passes
• All nf-wave tests pass

🤖 Generated with Claude Code

[netlify]

✅ Deploy Preview for nextflow-docs-staging ready!

Name	Link
🔨 Latest commit	75a56da
🔍 Latest deploy log	https://app.netlify.com/projects/nextflow-docs-staging/deploys/6939af38249c4e0008aef06b
😎 Deploy Preview	https://deploy-preview-6639--nextflow-docs-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[christopher-hakkaart]

Docs are already very good.

Minor point, I think the default behavior could also be described in terms of how it is set.

I.e., Can (or should) a user set wave.build.template = 'default' to get the default behavior? Or just not set anything?

[pditommaso]

Fair! add a look at latest commit