feat(github-action): create GitHub Release Action

Author: vscaiceanu-1a

.github/workflows/main.yml

@@ -72,7 +72,10 @@ jobs:
           releaseBranchRegExp: 'release\/(0|[1-9]\d*)\.(0|[1-9]\d*)(\.0-(?:next|prerelease|rc))?$'
       - name: Create release
         if: github.event_name != 'pull_request' && github.event_name != 'merge_group'
-        run: gh release create v${{ steps.newVersion.outputs.nextVersionTag }} --generate-notes ${{ contains( steps.newVersion.outputs.nextVersionTag, '-' ) && '--prerelease' || '' }} --target ${{ github.ref_name }}
+        uses: ./tools/github-actions/release
+        with:
+          version: ${{ steps.newVersion.outputs.nextVersionTag }}
+          target: ${{ github.ref_name }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 

tools/github-actions/README.md

@@ -8,3 +8,4 @@ Actions currently available :
 * Setup action [Documentation](setup/readme.md)
 * Upload build output action [Documentation](upload-build-output/readme.md)
 * Download build output action [Documentation](download-build-output/readme.md)
+* New GitHub Release action [Documentation](release/readme.md)

tools/github-actions/release/LICENSE

@@ -0,0 +1,26 @@
+Copyright Amadeus SAS
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

tools/github-actions/release/action.yml

@@ -0,0 +1,15 @@
+name: Create a new GitHub Release
+description: Creates a new GitHub Release for a given version
+inputs:
+  version:
+    description: 'The version to create the release for'
+    required: true
+  target:
+    description: 'The branch to target'
+    required: true
+runs:
+  using: "composite"
+  steps:
+    - name: Create release
+      shell: bash
+      run: gh release create v${{ inputs.version }} --generate-notes ${{ contains( inputs.version, '-' ) && '--prerelease' || '' }} --target ${{ inputs.target }}

tools/github-actions/release/readme.md

@@ -0,0 +1,23 @@
+# Create a new Github Release
+
+## Overview
+
+GitHub Action for creating a new release on GitHub.
+
+> [!NOTE]
+> This action requires `contents: write` [permission](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/controlling-permissions-for-github_token) in order to create the release.
+
+## Task options
+
+See [Action specifications](./action.yml) directly for more information about the supported parameters.
+
+## Usage example
+
+```yaml
+- name: Create release
+  if: github.event_name != 'pull_request'
+  uses:  AmadeusITGroup/otter/tools/github-actions/release
+  with:
+    version: ${{ nextVersionTag }}
+    target: ${{ github.ref_name }}
+```