Update release workflow descriptions and improve tag handling logic

Author: niwo

.github/workflows/release.yml

@@ -11,7 +11,7 @@ on:
   workflow_dispatch:
     inputs:
       tag:
-        description: 'Existing git tag to release, for example v1.6.12'
+        description: 'Release tag to publish, for example v1.6.12'
         required: true
         type: string
 
@@ -38,7 +38,11 @@ jobs:
           if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
             RELEASE_TAG='${{ github.event.inputs.tag }}'
             git fetch --force --tags origin
-            git checkout "$RELEASE_TAG"
+
+            if git rev-parse "refs/tags/$RELEASE_TAG" >/dev/null 2>&1; then
+              git checkout "$RELEASE_TAG"
+            fi
+
             VERSION="$(ruby -e 'require "./lib/cloudstack-cli/version"; print CloudstackCli::VERSION')"
           elif [ "$GITHUB_REF_TYPE" = "tag" ]; then
             RELEASE_TAG="$GITHUB_REF_NAME"
@@ -68,15 +72,15 @@ jobs:
             exit 1
           fi
 
-      - name: Create release tag from main
-        if: github.ref_type == 'branch'
+      - name: Create release tag from branch
+        if: github.ref_type == 'branch' || github.event_name == 'workflow_dispatch'
         run: |
           RELEASE_TAG='${{ steps.release.outputs.release_tag }}'
 
           git fetch --force --tags origin
 
-          if git rev-parse "$RELEASE_TAG" >/dev/null 2>&1; then
-            TAG_SHA="$(git rev-list -n 1 "$RELEASE_TAG")"
+          if git rev-parse "refs/tags/$RELEASE_TAG" >/dev/null 2>&1; then
+            TAG_SHA="$(git rev-list -n 1 "refs/tags/$RELEASE_TAG")"
 
             if [ "$TAG_SHA" != "$GITHUB_SHA" ]; then
               echo "Tag $RELEASE_TAG already exists on $TAG_SHA, expected $GITHUB_SHA."

README.md

@@ -207,7 +207,7 @@ The `Update bundle` workflow runs monthly and can also be started manually from
 
 ### Releases
 
-The `Release gem` workflow publishes to RubyGems when a tag like `v1.6.12` is pushed. It also runs when `lib/cloudstack-cli/version.rb` changes on `main`, creates the matching tag automatically, and publishes that version. You can still trigger it manually for an existing tag from the Actions tab.
+The `Release gem` workflow publishes to RubyGems when a tag like `v1.6.12` is pushed. It also runs when `lib/cloudstack-cli/version.rb` changes on `main`, creates the matching tag automatically, and publishes that version. You can also trigger it manually from the Actions tab with a release tag like `v1.6.12`; if the tag does not exist yet, the workflow creates it from the selected branch before publishing.
 
 Add the `RUBYGEMS_API_KEY` repository secret before using the release workflow.