feat(helm-release-oci): Add input to override apiVersion (#60)

Author: bohdantverdyi

.github/actions/helm-release-oci/action.yaml

@@ -31,6 +31,10 @@ inputs:
     description: Optional values file for helm lint (path is resolved from chart_path working directory)
     required: false
     default: ""
+  chart_version:
+    description: Helm chart version (overrides appVersion-derived version when provided)
+    required: false
+    default: ""
 
 outputs:
   chart_name:
@@ -96,6 +100,8 @@ runs:
     - name: Update versions
       shell: bash
       working-directory: ${{ inputs.chart_path }}
+      env:
+        CHART_VERSION_OVERRIDE: ${{ inputs.chart_version }}
       run: |
         if [[ "$GITHUB_REF_TYPE" == "branch" ]]
         then
@@ -108,14 +114,20 @@ runs:
         else
           APP_VERSION="${GITHUB_REF_NAME##*/}"
         fi
-        
+
+        if [[ -n "$CHART_VERSION_OVERRIDE" ]]; then
+          CHART_VERSION="$CHART_VERSION_OVERRIDE"
+        else
+          CHART_VERSION="$(echo "$APP_VERSION" | sed 's/^v//')"
+        fi
+
         echo "Updating Chart.yaml"
 
-        APP_VERSION="$APP_VERSION" yq -i '
-          .version = (strenv(APP_VERSION) | sub("^v"; "")) |
+        APP_VERSION="$APP_VERSION" CHART_VERSION="$CHART_VERSION" yq -i '
+          .version = strenv(CHART_VERSION) |
           .appVersion = strenv(APP_VERSION)
         ' Chart.yaml
-        
+
         cat Chart.yaml
 
     - name: Read chart metadata

.github/workflows/helm-release-ecr.yaml

@@ -50,6 +50,11 @@ on:
         type: string
         required: false
         default: ""
+      chart_version:
+        description: Helm chart version (overrides appVersion-derived version when provided)
+        type: string
+        required: false
+        default: ""
       runner:
         description: GitHub Actions runner to use. Supports a single label or a JSON array of labels.
         type: string
@@ -139,3 +144,4 @@ jobs:
           bump_version_git_branch: ${{ inputs.bump_version_git_branch }}
           lint_enabled: ${{ inputs.lint_enabled }}
           lint_values_file: ${{ inputs.lint_values_file }}
+          chart_version: ${{ inputs.chart_version }}

.github/workflows/helm-release-gar.yaml

@@ -50,6 +50,11 @@ on:
         type: string
         required: false
         default: ""
+      chart_version:
+        description: Helm chart version (overrides appVersion-derived version when provided)
+        type: string
+        required: false
+        default: ""
       runner:
         description: GitHub Actions runner to use. Supports a single label or a JSON array of labels.
         type: string
@@ -144,3 +149,4 @@ jobs:
           bump_version_git_branch: ${{ inputs.bump_version_git_branch }}
           lint_enabled: ${{ inputs.lint_enabled }}
           lint_values_file: ${{ inputs.lint_values_file }}
+          chart_version: ${{ inputs.chart_version }}

.github/workflows/helm-release-github.yaml

@@ -41,6 +41,11 @@ on:
         type: string
         required: false
         default: ""
+      chart_version:
+        description: Helm chart version (overrides appVersion-derived version when provided)
+        type: string
+        required: false
+        default: ""
       runner:
         description: GitHub Actions runner to use. Supports a single label or a JSON array of labels.
         type: string
@@ -118,3 +123,4 @@ jobs:
           bump_version_git_branch: ${{ inputs.bump_version_git_branch }}
           lint_enabled: ${{ inputs.lint_enabled }}
           lint_values_file: ${{ inputs.lint_values_file }}
+          chart_version: ${{ inputs.chart_version }}

.github/workflows/helm-release-oci-test.yaml

@@ -24,6 +24,7 @@ jobs:
           push_chart: "false"
           bump_version_in_git: "false"
           lint_enabled: "true"
+          chart_version: "" # test empty
 
   case_github_wrapper_success:
     name: Case - GitHub wrapper succeeds
@@ -34,6 +35,7 @@ jobs:
       push_chart: false
       bump_version_in_git: false
       lint_enabled: true
+      chart_version: "1.0.0-override" # test override
 
   case_ecr_wrapper_success:
     name: Case - ECR wrapper succeeds

docs/helm-release.md

@@ -22,6 +22,7 @@ Legacy note:
 - `bump_version_git_branch` (`string`, optional, default `""`): Override target branch for bump commit. If empty, uses current ref name.
 - `lint_enabled` (`boolean`, optional, default `true`): Run `helm lint` before package.
 - `lint_values_file` (`string`, optional, default `""`): Optional values file for helm lint (path is resolved from `chart_path`).
+- `chart_version` (`string`, optional, default `""`): Optional helm chart version (overrides appVersion-derived version when provided).
 
 Note:
 - Version bump commit is intentionally tied to `push_chart=true`.
@@ -45,6 +46,7 @@ Inputs:
 - `bump_version_git_branch` (optional, default empty)
 - `lint_enabled` (optional, default `true`)
 - `lint_values_file` (optional, default empty)
+- `chart_version` (`string`, optional, default `""`): Optional helm chart version (overrides appVersion-derived version when provided).
 
 Secrets:
 - `token` (required when `push_chart=true`): token used for GHCR login.
@@ -94,6 +96,7 @@ Inputs:
 - `bump_version_git_branch` (optional, default empty)
 - `lint_enabled` (optional, default `true`)
 - `lint_values_file` (optional, default empty)
+- `chart_version` (`string`, optional, default `""`): Optional helm chart version (overrides appVersion-derived version when provided).
 
 Secrets:
 - `GITHUB_APP_ID` and `GITHUB_APP_KEY` (optional): only needed when both `push_chart=true` and `bump_version_in_git=true`.
@@ -142,6 +145,7 @@ Inputs:
 - `bump_version_git_branch` (optional, default empty)
 - `lint_enabled` (optional, default `true`)
 - `lint_values_file` (optional, default empty)
+- `chart_version` (`string`, optional, default `""`): Optional helm chart version (overrides appVersion-derived version when provided).
 
 Secrets:
 - `GITHUB_APP_ID` and `GITHUB_APP_KEY` (optional): only needed when both `push_chart=true` and `bump_version_in_git=true`.