Add release workflow for the restate repository

The release workflow will be triggered by pushing a version tag. It will
then build a docker file for this version, the binaries of the CLI and
finally creates a release with the binaries attached.

This fixes #347.

.github/workflows/ci.yml

@@ -2,6 +2,7 @@ name: CI
 
 on:
   pull_request:
+  workflow_call:
   workflow_dispatch:
   push:
     branches:

.github/workflows/docker.yml

@@ -1,9 +1,7 @@
 name: Build Docker image
 
 on:
-  push:
-    tags:
-      - v**
+  workflow_call:
   workflow_dispatch:
 
 env:

.github/workflows/release.yml

@@ -0,0 +1,46 @@
+name: Create new release
+
+on:
+  push:
+    tags:
+      - v**
+
+jobs:
+  run-tests:
+    name: Test release
+    uses: ./.github/workflows/ci.yml
+
+  build-docker-image:
+    name: Build release Docker image
+    needs: [run-tests]
+    uses: ./.github/workflows/docker.yml
+
+  build-cli-binaries:
+    name: Build release cli binaries
+    needs: [run-tests]
+    uses: ./.github/workflows/cli.yml
+
+  create-release:
+    name: Create release
+    runs-on: ubuntu-latest
+    needs: [build-docker-image, build-cli-binaries]
+
+    steps:
+      - name: Download cli binaries
+        uses: actions/download-artifact@v3
+
+      - name: Package cli binaries
+        id: package-cli-binaries
+        run: |
+          for cli in restate-cli-*; do zip -j ${cli}.zip ${cli}/restate-cli; done
+          echo "PACKAGES<<EOF" >> $GITHUB_OUTPUT
+          ls -1 restate-cli-*.zip >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create release
+        uses: softprops/action-gh-release@v1
+        with:
+          # create a draft release which needs manual approval
+          draft: true
+          files: ${{ steps.package-cli-binaries.outputs.PACKAGES }}
+

docs/dev/README.md

@@ -10,4 +10,6 @@ This directory contains documentation relevant for Restate developers.
 
 [rust-guidelines.md](rust-guidelines.md) contains guidelines for coding Rust.
 
-[debug.md](debug.md) contains some tips for debugging the runtime.
+[debug.md](debug.md) contains some tips for debugging the runtime.
+
+[release.md](release.md) contains explanation for how to release the runtime.

docs/dev/release.md

@@ -0,0 +1,11 @@
+# Releasing the Restate runtime
+
+In order to release the Restate runtime, you have to create a tag of the form `vX.Y.Z` and push it to the repository.
+The tag will trigger the [release.yml](/.github/workflows/release.yml) workflow which does the following:
+
+* Running the local tests
+* Creating and pushing the Docker image with the runtime
+* Creating the CLI binaries
+* Creating a draft release with the CLI binaries attached
+
+In order to finish the release, you have to publish it [here](https://github.com/restatedev/restate/releases).