make-release.sh

#!/bin/bash
# Release process automation script. 
# Used to create branch/tag, update VERSION files
# and trigger release by force pushing changes to the release branch 

# set to 1 to actually trigger changes in the release branch
TRIGGER_RELEASE=0 
NOCOMMIT=0
TMP=""
REPO=git@github.com:eclipse-che/che-plugin-registry

while [[ "$#" -gt 0 ]]; do
  case $1 in
    '-t'|'--trigger-release') TRIGGER_RELEASE=1; NOCOMMIT=0; shift 0;;
    '-v'|'--version') VERSION="$2"; shift 1;;
    '-tmp'|'--use-tmp-dir') TMP=$(mktemp -d); shift 0;;
    '-n'|'--no-commit') NOCOMMIT=1; TRIGGER_RELEASE=0; shift 0;;
  esac
  shift 1
done

usage ()
{
  echo "Usage: $0  --version [VERSION TO RELEASE] [--trigger-release]"
  echo "Example: $0 --version 7.27.0 --trigger-release"; echo
}

performRelease() 
{
  SHORT_SHA1=$(git rev-parse --short HEAD)
  VERSION=$(head -n 1 VERSION)
  BUILDER=docker SKIP_FORMAT=true SKIP_LINT=true SKIP_TEST=true ./build.sh --tag "${VERSION}"
  docker tag quay.io/eclipse/che-plugin-registry:"${VERSION}" quay.io/eclipse/che-plugin-registry:"${SHORT_SHA1}"
  docker push quay.io/eclipse/che-plugin-registry:"${SHORT_SHA1}"
  docker push quay.io/eclipse/che-plugin-registry:"${VERSION}"
}

if [[ ! ${VERSION} ]]; then
  usage
  exit 1
fi

# derive branch from version
BRANCH=${VERSION%.*}.x

# if doing a .0 release, use main; if doing a .z release, use $BRANCH
if [[ ${VERSION} == *".0" ]]; then
  BASEBRANCH="main"
else 
  BASEBRANCH="${BRANCH}"
fi

fetchAndCheckout ()
{
  bBRANCH="$1"
  git fetch origin "${bBRANCH}:${bBRANCH}"; git checkout "${bBRANCH}"
}

# work in tmp dir if --use-tmp-dir (not required when running as GH action)
if [[ $TMP ]] && [[ -d $TMP ]]; then 
  pushd "$TMP" > /dev/null || exit 1
  # get sources from ${BASEBRANCH} branch
  echo "Check out ${REPO} to ${TMP}/${REPO##*/}"
  git clone "${REPO}" -q
  cd "${REPO##*/}" || true
fi
fetchAndCheckout "${BASEBRANCH}"

# create new branch off ${BASEBRANCH} (or check out latest commits if branch already exists), then push to origin
if [[ "${BASEBRANCH}" != "${BRANCH}" ]]; then
  git branch "${BRANCH}" || git checkout "${BRANCH}" && git pull origin "${BRANCH}"
  git push origin "${BRANCH}"
  fetchAndCheckout "${BRANCH}"
fi

commitChangeOrCreatePR()
{
  if [[ ${NOCOMMIT} -eq 1 ]]; then
    echo "[INFO] NOCOMMIT = 1; so nothing will be committed. Run this script with no flags for usage + list of flags/options."
  else
    aVERSION="$1"
    aBRANCH="$2"
    PR_BRANCH="$3"

    if [[ ${PR_BRANCH} == *"add"* ]]; then
      COMMIT_MSG="chore: release: add ${aVERSION} plugins in ${aBRANCH}"
    else 
      COMMIT_MSG="chore: release: bump to ${aVERSION} in ${aBRANCH}"
    fi

    # commit change into branch
    git add -A || true
    git commit -s -m "${COMMIT_MSG}"
    git pull origin "${aBRANCH}"

    PUSH_TRY="$(git push origin "${aBRANCH}")"
    # shellcheck disable=SC2181
    if [[ $? -gt 0 ]] || [[ $PUSH_TRY == *"protected branch hook declined"* ]]; then
      # create pull request for main branch, as branch is restricted
      git branch "${PR_BRANCH}"
      git checkout "${PR_BRANCH}"
      git pull origin "${PR_BRANCH}"
      git push origin "${PR_BRANCH}"
      gh pr create -f -B "${aBRANCH}" -H "${PR_BRANCH}"
    fi
  fi
}

# update che-editors.yaml; also update the VERSION file
updateEditors () {
  newVERSION="$1"
  thisVERSION="$2" # if false, don't update che-editors.yaml and VERSION file; otherwise use this value in VERSION, and new version in che-editors.yaml 
  pwd

  # Now do che-code in che-editors.yaml
  cheCode="che-incubator/che-code"
  sed -i "che-editors.yaml" \
      -e "s#id: ${cheCode}/\([0-9]\+\.[0-9]\+\.[0-9]\+\)#id: ${cheCode}/${newVERSION}#"
  sed -i "che-editors.yaml" \
      -e "s#name: ${cheCode}/\([0-9]\+\.[0-9]\+\.[0-9]\+\)#name: ${cheCode}/${newVERSION}#"
  sed -i "che-editors.yaml" \
      -e "s#image: \(['\"]*\)quay.io/${cheCode}:\([0-9]\+\.[0-9]\+\.[0-9]\+\)\1#image: \1quay.io/${cheCode}:${newVERSION}\1#"
  # update .metadata.attributes.version to latest released version
  cheCodeDesc="Microsoft Visual Studio Code - Open Source IDE for Eclipse Che"
  # shellcheck disable=SC2016
  yq -Yi --arg ver "${newVERSION}" --arg desc "${cheCodeDesc}"  \
    '.editors[] |= if .metadata.description == $desc then .metadata.attributes.version |= $ver else . end' "che-editors.yaml"
 
  # update package.json with the new version
  sed -i -r -e "s/(\"version\": )(\".*\")/\1\"${newVERSION}\"/" tools/build/package.json

  # for .z releases, VERSION files should not be updated in main branch (only in .z branch)
  if [[ ${thisVERSION} != "false" ]]; then
    # update VERSION file with VERSION or NEWVERSION
    echo "${thisVERSION}" > VERSION
  fi
}

# update che-editors.yaml and bump VERSION file to VERSION
updateEditors "${VERSION}" "${VERSION}"

# commit change into branch
commitChangeOrCreatePR "${VERSION}" "${BRANCH}" "pr-${BRANCH}-to-${VERSION}"

if [[ $TRIGGER_RELEASE -eq 1 ]]; then
  # push new branch to release branch to trigger CI build
  fetchAndCheckout "${BRANCH}"
  performRelease

  # tag the release
  git checkout "${BRANCH}"
  git tag "${VERSION}"
  git push origin "${VERSION}"
fi

# now update ${BASEBRANCH} to the new snapshot version
fetchAndCheckout "${BASEBRANCH}"

# change VERSION file + commit change into ${BASEBRANCH} branch
if [[ "${BASEBRANCH}" != "${BRANCH}" ]]; then
  # bump the y digit
  [[ $BRANCH =~ ^([0-9]+)\.([0-9]+)\.x ]] && BASE=${BASH_REMATCH[1]}; NEXT=${BASH_REMATCH[2]}; (( NEXT=NEXT+1 )) # for BRANCH=7.10.x, get BASE=7, NEXT=11
  NEXTVERSION="${BASE}.${NEXT}.0-SNAPSHOT"
else
  # bump the z digit
  [[ $VERSION =~ ^([0-9]+)\.([0-9]+)\.([0-9]+) ]] && BASE="${BASH_REMATCH[1]}.${BASH_REMATCH[2]}"; NEXT="${BASH_REMATCH[3]}"; (( NEXT=NEXT+1 )) # for VERSION=7.7.1, get BASE=7.7, NEXT=2
  NEXTVERSION="${BASE}.${NEXT}-SNAPSHOT"
fi

# update che-editors.yaml and bump VERSION file to NEXTVERSION
updateEditors "${VERSION}" "${NEXTVERSION}"
commitChangeOrCreatePR "${NEXTVERSION}" "${BASEBRANCH}" "pr-${BASEBRANCH}-to-${NEXTVERSION}"

# now, if we're doing a 7.y.z release, push new plugins into main branch too (#16476)
if [[ ${BASEBRANCH} != "main" ]]; then
  fetchAndCheckout "main"

  # update che-editors.yaml; do not update VERSION file in main
  updateEditors "${VERSION}" false
  commitChangeOrCreatePR "${VERSION}" "main" "pr-add-${VERSION}-plugins-to-main"
fi

# cleanup tmp dir
if [[ $TMP ]] && [[ -d $TMP ]]; then
  popd >/dev/null || true
  rm -fr "$TMP"
fi