initial commit (#1)

Signed-off-by: 20k-ultra <3946250+20k-ultra@users.noreply.github.com>

Author: 20k-ultra

README.md

@@ -1 +1,82 @@
-## GitHub Action for Lagon
+# Lagon Action
+
+Easily integrate [Lagon](https://lagon.dev) CLI into your Github workflows. Deploy new functions, retrieve a list of existing functions, promote functions, etc. This action supports any [arbitrary input](#other-commands) of what to do!
+
+## Usage
+
+Create the following workflow in your function's repository:
+
+_./github/workflows/lagon.yml_
+
+```yml
+name: Lagon
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - uses: actions/checkout@v2
+      - uses: lagonapp/github-action@latest
+        with:
+          lagon_token: ${{ secrets.LAGON_API_TOKEN }}
+      - name: Log Function URL
+        run: |
+          url=$(grep -o 'https://[^[:space:]]*' lagon.output)
+          echo "Function available at: $url"
+```
+
+This will deploy your source code to the specified function after a commit is pushed into main.
+
+_NOTE: Make sure the repository that gets checked out contains a `.lagon/config.json` file that specifies information such as the function_id and organization_id or pass in a config via the config input value mentioned below!_
+
+#### Other commands
+
+If you want to run a different command just specify it with the `command` input:
+
+```bash
+        with:
+          lagon_token: ${{ secrets.LAGON_API_TOKEN }}
+          command: ls
+```
+
+See [CLI](https://docs.lagon.app/cli) docs for more commands.
+
+## Inputs
+
+Inputs are provided using the `with:` section of your workflow YML file.
+
+| key         | Description                  | Required | Default                |
+| ----------- | ---------------------------- | -------- | ---------------------- |
+| lagon_token | Your Lagon API token         | true     |                        |
+| command     | The Lagon CLI command to run | false    | deploy --prod          |
+| site_url    | Specify Lagon API domain     | false    | https://dash.lagon.app |
+| config      | Config file for function     | false    |                        |
+
+`site_url` is used to specify a custom endpoint if you are using a self-hosted instance of Lagon.
+
+`config` allows you to override a repositories existing config or maybe it never existed because you didn't want to commit it:
+
+```bash
+        with:
+          lagon_token: ${{ secrets.LAGON_API_TOKEN }}
+          config: |
+            {
+              "function_id": "${{ vars.lagon_function_id }}",
+              "organization_id": "${{ vars.lagon_org_id }}",
+              "index": "hello.ts",
+              "client": null,
+              "assets": null
+            }
+```
+
+This example is setting the function and org ID with [variables](https://docs.github.com/en/actions/learn-github-actions/variables#creating-configuration-variables-for-a-repository).
+
+## Outputs
+
+Since the action allows you to run any command, there are no outputs. Instead, the CLI stdout will be saved to a local file called `lagon.output`.

action.yml

@@ -0,0 +1,71 @@
+name: "Lagon CLI"
+description: "Easily integrate Lagon CLI operations into your Github workflow"
+branding:
+  icon: code
+  color: blue
+inputs:
+  lagon_token:
+    description: "Your Lagon API token"
+    required: true
+  command:
+    description: 'The Lagon CLI command to run. For example: "deploy" - will publish your Function'
+    required: false
+    default: "deploy --prod"
+  site_url:
+    description: "Specify custom url for self-hosted Lagon instances"
+    required: false
+    default: "https://dash.lagon.app"
+  config:
+    description: "Pass in .lagon/config.json file for your function"
+    required: false
+    default: ""
+outputs:
+  cli_stdout:
+    description: "The raw stdout from the CLI command executed"
+    value: ${{ steps.cli.outputs.cli_stdout }}
+runs:
+  using: "composite"
+  steps:
+    - name: "Install Node.js"
+      uses: actions/setup-node@v3
+      with:
+        node-version: 18
+
+    - name: "Install CLI"
+      shell: bash
+      run: |
+        npm install --global @lagon/cli esbuild
+
+    - name: "Execute CLI"
+      id: cli
+      env:
+        LAGON_TOKEN: ${{ inputs.lagon_token }}
+        LAGON_COMMAND: ${{ inputs.command }}
+        LAGON_URL: ${{ inputs.site_url }}
+        LAGON_CONFIG: ${{ inputs.config }}
+      shell: bash
+      run: |
+        echo "Configuring Lagon CLI..."
+        if [[ -z "${LAGON_TOKEN}" ]]; then
+            echo "LAGON_API_TOKEN input is not set"
+            exit 1
+        fi
+
+        # Setup config folders
+        mkdir -p "$HOME/.lagon"
+
+        # Setup auth
+        echo \{\"token\":\""${LAGON_TOKEN}"\",\"site_url\":\""${LAGON_URL}"\"\} | jq >"$HOME/.lagon/config.json"
+
+        # Setup lagon function config if one was provided
+        if [[ -n "${LAGON_CONFIG}" ]]; then
+            echo "LAGON_CONFIG variable set from environment...applying to local directory"
+            mkdir -p .lagon
+            echo "$LAGON_CONFIG" | jq >.lagon/config.json
+        fi
+
+        # Run CLI
+        echo "Executing CLI..."
+        eval "lagon $LAGON_COMMAND" | tee lagon.output
+        # Action is done!
+        exit $?