Skip to content
Melloware edited this page Jun 13, 2025 · 2 revisions

Release a new MAJOR version

Perform a Release

Follow these steps to trigger a new release:

  1. Open the Release Workflow

    • Navigate to the Actions tab in the GitHub repository.
    • Select the "Release" workflow from the list.
  2. Run the Workflow

    • Click the "Run workflow" button.
    • When prompted, provide the following inputs:
      • Branch: master
      • Version to release: e.g., 17.0.0
      • Next development version: e.g., 17.0.0-SNAPSHOT
  3. What the Workflow Does Automatically

    • Updates all pom.xml files with the specified release version.
    • Creates and pushes a corresponding Git tag.
    • Builds and deploys artifacts to Maven Central.
    • Bumps the version to the specified next development version.

Post-Release Tasks

After completing a release, follow these steps to prepare the Short-Term Support (STS) version:

  1. Create the STS Branch

    • If master is now 17.0.0-SNAPSHOT, create a new branch from the latest 16.0.0 tag:
      git checkout -b 16.X tags/16.0.0
  2. Provision a New App on DigitalOcean

    • Create a new application specifically for the STS version (e.g., version 16).
  3. Update Showcase Deployment

    • In the 16.X branch, edit the GitHub Actions workflow:
      • File: .github/workflows/deploy-showcase.yml
      • Change the app_name to:
        app_name: primefaces16-showcase
  4. Update Release Workflow

    • In the 16.X branch, edit the release workflow file:
      • File: .github/workflows/release.yml
      • Update the branch environment variable:
        env:
          BRANCH: '16.X'

Release a new MINOR version

Perform a Release

Follow these steps to trigger a new release:

  1. Open the Release Workflow

    • Navigate to the Actions tab in the GitHub repository.
    • Select the "Release" workflow from the list.
  2. Run the Workflow

    • Click the "Run workflow" button.
    • When prompted, provide the following inputs:
      • Branch: 16.X
      • Version to release: e.g., 16.0.5
      • Next development version: e.g., 16.0.6-SNAPSHOT
  3. What the Workflow Does Automatically

    • Updates all pom.xml files with the specified release version.
    • Creates and pushes a corresponding Git tag.
    • Builds and deploys artifacts to Maven Central.
    • Bumps the version to the specified next development version.

image

Clone this wiki locally