Update Taskfile (#460)

* add install deps to task file
* gha updated to use task file

Signed-off-by: Jordan Rash <[email protected]>

Author: jordan-rash

.github/workflows/schema_generation.yml

@@ -18,18 +18,14 @@ jobs:
         uses: actions/setup-go@v4
         with:
           go-version: '1.23'  # Specify your Go version
-
-      - name: Install Protoc
+      
+      - name: Install Taskfile
         run: |
-          curl -LO https://github.com/protocolbuffers/protobuf/releases/download/v28.3/protoc-28.3-linux-x86_64.zip
-          sudo unzip protoc-28.3-linux-x86_64.zip -d /usr/local
-          rm protoc-28.3-linux-x86_64.zip
+          go install github.com/go-task/task/v3/cmd/task@latest
 
-      - name: Install dependencies
+      - name: Install Dependencies
         run: |
-          go install github.com/go-task/task/v3/cmd/task@latest
-          go install github.com/atombender/go-jsonschema@latest
-          go install google.golang.org/protobuf/cmd/[email protected]
+          task install-deps
 
       - name: Run 'task gen-schema'
         run: |

README.md

@@ -12,41 +12,37 @@
 Leverage and extend your investment in NATS infrastructure to deploy functions and services, turning NATS into the ultimate platform for building distributed applications.
 
 ## Prerequisites
+
 ### Taskfile
+
 Nex uses [Task](https://taskfile.dev) for building, testing, and releasing. You can install Task by following the
 instructions [here](https://taskfile.dev/installation)
 
-### Protobuf
-Nex relies on Protobuf for defining the API and messages. While many linux distros have Protobuf available in their 
-package repositories, it is recommended to install the latest version from the official releases. You can find the 
+### Protobuf | Go-jsonschema
+
+Nex relies on Protobuf and Go-jsonschema for defining the API and messages. While many linux distros have Protobuf available in their
+package repositories, it is recommended to install the version matching what is defined in CI from the official releases. You can find the
 latest release [here](https://github.com/protocolbuffers/protobuf/releases)
 
-On linux, once downloaded, you can extract the archive and run the following commands to install it:
-```shell
-unzip protoc-xxx.zip -d protoc3
-sudo cp protoc3/bin/* /usr/local/bin/
-sudo cp protoc3/include/* /usr/local/include/
-```
+The included Taskfile has a task defined for downloading and installing the required dependencies.
 
-Also make sure to install `protoc-gen-go` by running:
 ```shell
-go install google.golang.org/protobuf/cmd/protoc-gen-go
+task install-deps
 ```
 
-### Go-jsonschema
-Nex uses go-jsonschema for validating the configuration files. You can install it by [following the installation instructions](https://github.com/omissis/go-jsonschema?tab=readme-ov-file#installing)
-
 ## Getting Started
+
 Currently, there are no pre-built binaries available. To build from source, make sure the prerequisites are installed.
-Once you got these dependencies installed and this repository cloned, you can build the `nex` binary with the 
+Once you got these dependencies installed and this repository cloned, you can build the `nex` binary with the
 following command:
+
 ```shell
 task nex
 ```
 
 With the nex binary built and a local nats server running, we can finally run our node:
+
 ```shell
 mkdir -p ~/.config/nex
 target/nex node up
 ```
-

Taskfile.yaml

@@ -1,8 +1,19 @@
 version: '3'
 
 tasks:
-  # requires the protoc binary in the path, and the `protoc-gen-go` plugin
-  # 'go install google.golang.org/protobuf/cmd/protoc-gen-go@latest'
+  install-godeps:
+    cmds:
+      - go install github.com/atombender/go-jsonschema@latest
+      - go install google.golang.org/protobuf/cmd/[email protected]
+
+  install-protoc:
+    cmds:
+      - curl -LO https://github.com/protocolbuffers/protobuf/releases/download/v28.3/protoc-28.3-linux-x86_64.zip
+      - sudo unzip protoc-28.3-linux-x86_64.zip -d /usr/local
+      - rm protoc-28.3-linux-x86_64.zip
+
+  install-deps: 
+    deps: [install-godeps, install-protoc]
 
   proto:
     dir: node/internal/actors/pb
@@ -20,20 +31,17 @@ tasks:
     deps: [gen-schema-nodecontrol, gen-schema-agent]
 
   gen-schema-agent:
-    dir: api/agent/go
+    dir: api/agent
     cmds:
-      - "go-jsonschema \
-      --schema-package=https://github.com/synadia-io/nex/api/agent/register-agent-request=github.com/synadia-io/nex/agentapi/go/gen \
-      --schema-output=https://github.com/synadia-io/nex/api/agent/register-agent-request=gen/register_agent_request.go \
-       ../register-agent-request.json"
-      - "go-jsonschema \
-      --schema-package=https://github.com/synadia-io/nex/api/agent/start-workload-request=github.com/synadia-io/nex/api/agent/go/gen \
-      --schema-output=https://github.com/synadia-io/nex/api/agent/start-workload-request=gen/start_workload_request.go \
-       ../start-workload-request.json"
-      - "go-jsonschema \
-      --schema-package=https://github.com/synadia-io/nex/api/agent/stop-workload-request=github.com/synadia-io/nex/agentapi/go/gen \
-      --schema-output=https://github.com/synadia-io/nex/api/agent/stop-workload-request=gen/stop_workload_request.go \
-       ../stop-workload-request.json"
+      - go-jsonschema 
+        --package=gen
+        --schema-package=https://github.com/synadia-io/nex/api/agent/register-agent-request=github.com/synadia-io/nex/agentapi/go/gen 
+        --schema-output=https://github.com/synadia-io/nex/api/agent/register-agent-request=go/gen/register_agent_request.go 
+        --schema-package=https://github.com/synadia-io/nex/api/agent/start-workload-request=github.com/synadia-io/nex/api/agent/go/gen 
+        --schema-output=https://github.com/synadia-io/nex/api/agent/start-workload-request=go/gen/start_workload_request.go 
+        --schema-package=https://github.com/synadia-io/nex/api/agent/stop-workload-request=github.com/synadia-io/nex/agentapi/go/gen 
+        --schema-output=https://github.com/synadia-io/nex/api/agent/stop-workload-request=go/gen/stop_workload_request.go 
+        *.json
 
   gen-schema-nodecontrol:
     dir: api/nodecontrol
@@ -73,7 +81,7 @@ tasks:
         *.json
 
   nex:
-    deps: [proto]
+    deps: [all-code-gen]
     dir: cmd/nex
     cmds:
       - go build -o ../../target/nex .