Skip to content

CF Deployment Concourse Task Release

Jochen Ehret edited this page Feb 6, 2023 · 4 revisions

Brief

The goal of this guide is help you create a new CF-D Concourse Task public release. Please free to make changes based on your experience with the guide.

CF-Deployment Concourse Task (also cf-decota)

cf-decota contains set of concourse tasks for component teams to stitch together a CF pipeline for their product pipelines. Using cf-decota, teams can validate their changes with different CF-D environments. For e.g. a component team can test their new changes against master branch of CF-D to get quick feedback on their changes against a stable foundation.

Release Process

cf-decota is maintained by the same folks who maintain cf-deployment and the release is entirely up to their discretion. Releases tend to contain these two types of changes:

  1. Docker images are automatically updated by the concourse job whenever a team publishes a new release of their binary.
  2. Updates made to concourse tasks (new tasks, updates or removal of tasks).

Overview

After completing these steps, you will have the following:

  1. A published set of release notes
  2. A main branch tagged with the release version

Cut a new release of cf-decota.

💡 Increment the major version if there are any breaking changes. Otherwise, increment the minor version. If any of the concourse tasks have breaking changes, as in it will require users of concourse tasks to re-configure their existing CI pipelines, then make this a major release.

  1. Choose the type of semver bump
    1. For a minor version, navigate to the minor release concourse job.
    2. For a major version, navigate to the major release concourse job.
  2. Trigger a new build, which can take 5+ minutes. (Now is a good time to start compiling release notes.) Once completed, the job will create a new version tag.
  3. Navigate to cf-decota releases section and click "Edit" on the Draft release.
  4. Browse the relevant set of commits and update the release notes appropriately.
  5. Finally, click on Publish Release button.

Resources used in this guide