Creating a release

A Release object informs Konflux that an Application’s Snapshot is ready to be released, in accordiance with its associated ReleasePlan.

Creating a Release object

The development team creates a Release object in the developer tenant namespace. The Release object includes a reference to the application snapshot that the development team wants to release, along with release plan that will be used to release the application.

Prerequisites

  • You have an existing Development tenant namespace.

  • You have completed the steps listed in the Getting started in the CLI page.

  • You have completed the steps for creating a ReleasePlanAdmission and a matching ReleasePlan.

Procedures

  1. Create a Release.yaml object locally.

    Example Release.yaml object for a manually created release

    apiVersion: appstudio.redhat.com/v1alpha1
kind: Release
metadata:
 generateName: <name-of-this-release-prefix> (1)
 namespace: dev-tenant-namespace (2)
 labels:
   release.appstudio.openshift.io/automated: "false" (3)
   release.appstudio.openshift.io/author: my-userid (4)
spec:
 releasePlan: <release-plan-name> (5)
 snapshot: <application-snapshot-name> (6)
 data: <key> (7)
    1 The prefix of the release’s name. Konflux will append a unique suffix when the Release object is created.
    2 The development team’s tenant namespace.
    3 Label indicating that the release was not automatically created by Konflux. This value must be set to "false" using quotation marks.
    4 The ID of the user who created the release. This is required for manually created releases.
    5 The name of the release plan specifying the pipeline to run.
    6 The name of the application snapshot that you want to release.
    7 Optional: An unstructured key used for providing data for the managed release Pipeline.

  2. In the development tenant namespace, create the Release object using the kubectl command line:

    $ kubectl create -f Release.yaml
Verification

  1. In the Konflux UI, select the Applications tab

  2. Click on the application that is being released

  3. Click on the Releases tab

  4. See the recent releases that have been created for the application.

  5. You can find a link to the release pipeline run by clicking on the name of the release that you created.