Skip to content

CI/CD release workflow

examples/ci_cd_release_workflow.php uses an Okatana ticket as a release record.

Flow

  1. Build a stable marker (e.g., [release:2026.08.30]).
  2. Search project tickets for the marker.
  3. Create an open ticket if no marker is found.
  4. Resolve board IDs and transition the ticket to in-progress.
  5. Add a CI validation comment.
  6. On success, add a completion comment and transition to deployed.
  7. On failure, add a failure comment and transition to hold if available.
  8. Notify specified organization users.

Example invocation:

export OKATANA_PROJECT="01..."
export RELEASE_VERSION="2026.08.30"
export GIT_SHA="2f4d8c..."
export DEPLOYMENT_SUCCEEDED="true"
export OKATANA_NOTIFY_USERS="01USERA,01USERB"
php examples/ci_cd_release_workflow.php

The script does not retry creation on timeouts. The release marker serves as the reconciliation key.