Goal Changes

This page documents the changes to Maven goals between Filegen 5.x and 6.0.

DevOps Goals

5.x 6.0 Maven 6.0 Copier CLI

mvn filegen:generate-skaffold

mvn filegen:copier-init -Dcopier.template=devops

copier copy https://…​ngss-devops-template.git . --trust

mvn filegen:generate-kubernetes

(manual regeneration)

mvn filegen:copier-update -Dcopier.template=devops

copier update -a .copier-answers/devops.yaml

Backstage Goals

5.x 6.0 Maven 6.0 Copier CLI

mvn filegen:init-backstage-files

mvn filegen:copier-init -Dcopier.template=backstage

copier copy https://…​ngss-backstage-template.git . --trust

mvn filegen:copy-backstage-readme filegen:copy-backstage-changelog filegen:copy-openapi-json

mvn filegen:copier-update -Dcopier.template=backstage

copier update -a .copier-answers/backstage.yaml
The "backstage file update" functionality is conventionally handled via the backstage-tile Maven config which binds the generate-sources phase to the three goals listed in the 5.x column above.

Initialize All Standard Templates

To initialize all standard templates (currently DevOps and Backstage) at once:

# Maven - initializes devops and backstage
mvn filegen:copier-init

# Copier CLI - run separately for each
copier copy https://coderepo.mobilehealth.va.gov/scm/ckm/ngss-devops-template.git . --trust
copier copy https://coderepo.mobilehealth.va.gov/scm/ckm/ngss-backstage-template.git . --trust

Legacy Goals (Still Available)

These goals remain unchanged in 6.0 and continue to use static template generation from ckm-deployment-templates:

Goal Description Output

filegen:jenkins-yaml

Jenkins CI/CD pipeline configuration

jenkins.yaml

filegen:generate-vv

Verification & Validation configuration

vv.yaml

filegen:generate-dibr

Deployment, Installation, Backout, Rollback guide

dibr.md

 
mvn filegen:jenkins-yaml    # jenkins.yaml
mvn filegen:generate-vv     # vv.yaml
mvn filegen:generate-dibr   # dibr.md

Version Selection

By default, Copier selects the latest release tag. To use a specific version:

# Maven
mvn filegen:copier-init -Dcopier.template=devops -Dcopier.version=v2.0.0
mvn filegen:copier-update -Dcopier.template=devops -Dcopier.version=v1.3.0

# Copier CLI
copier copy https://...ngss-devops-template.git . --trust --vcs-ref=v2.0.0
copier update -a .copier-answers/devops.yaml --vcs-ref=v1.3.0

See Template Versioning for more details.

Skip Flags

All copier goals respect skip flags:

# Skip copier goal execution
mvn filegen:copier-init -Dcopier.template=devops -Dcopier.skip=true

# Skip all filegen goals
mvn install -DskipAll=true