feat: setup-akka-cli-action

Author: aludwiko

.gitignore

@@ -0,0 +1,2 @@
+node_modules
+.idea

README.md

@@ -0,0 +1,60 @@
+# Akka CLI for GitHub Actions
+
+This [JavaScript action](https://docs.github.com/en/actions/creating-actions/creating-a-javascript-action) for 
+GitHub workflows installs and configures the [Akka CLI](https://doc.akka.io/snapshots/akka-documentation/akka-cli/using-cli.html) tool. After running this action, the `akka` 
+command is 
+available in the workflow. 
+
+
+
+## Usage
+
+The action takes two required parameters to authenticate and set the Akka project ID:
+
+* `token`: The Akka authentication token
+* `project-id`: The Akka project ID you're using
+
+## Example Workflow
+
+The below flow shows how to use this action to list all services in your project
+
+```yaml
+name: akka
+
+on: 
+  push:
+    branches: [ main ]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Install Akka CLI
+        uses: akka/setup-akka-cli-action@v1
+        with:
+          token: ${{ secrets.AKKA_TOKEN }}
+          project-id: ${{ vars.AKKA_PROJECT_ID }}
+      - name: List services
+        run: akka service list
+```
+
+## Building and developing
+
+Follow the [instructions](https://docs.github.com/en/actions/creating-actions/creating-a-javascript-action#commit-tag-and-push-your-action-to-github) to build and push the action.
+
+* run `npm i --target_arch=x64 --target_platform=linux`
+* update index.js file with your changes
+* run `ncc build index.js`
+* commit sources and `dist` folder
+
+## Contributing
+
+We welcome all contributions! [Pull requests](https://github.com/akka/setup-akka-cli-action/pulls) are the preferred way to share your contributions. For major changes, please open [an issue](https://github.com/akka/setup-akka-cli-action/issues) first to discuss what you would like to change.
+
+## Support
+
+This project is an [incubator](https://doc.akka.io/docs/akka-dependencies/current/support-terminology.html#incubating)
+
+## License
+
+See the [LICENSE](./LICENSE)

RELEASING.md

@@ -0,0 +1,6 @@
+* Create a [new release](https://github.com/akka/setup-akka-cli-action/releases/new) with a new tag and the title equal to the tag
+* Choose the version judiciously, as making the version a minor number bump will allow existing users to be upgraded seamlessly. A major number bump will force them to update their action. Follow this [instruction](https://docs.github.com/en/actions/creating-actions/about-custom-actions#using-release-management-for-actions)
+* Move major version tag `v1` to the latest release, e.g. `v1` to `v1.0.2`.
+* When bumping the major version (e.g. from `v1` to `v2`), update the following:
+  * [README.md](README.md)
+  * [Akka Docs](https://doc.akka.io/snapshots/akka-documentation/operations/integrating-cicd/github-actions.html)

action.yml

@@ -0,0 +1,16 @@
+name: 'Setup Akka CLI'
+description: 'Setup and basic configuration of the Akka CLI'
+branding:
+  color: 'green'
+  icon: zap
+inputs:
+  token:
+    #TODO fix docs url
+    description: 'Akka refresh token, see: https://doc.akka.io/snapshots/akka-documentation/operations/integrating-cicd/index.html#create_a_service_token'
+    required: true
+  project-id:
+    description: 'Akka project id, check your project id with `akka projects list`'
+    required: true
+runs:
+  using: 'node20'
+  main: 'dist/index.js'