Kutlass Quickstart

Note: This quickstart is specific to the stand-alone kutlass binary. For other deployment options, please refer to the Ionflow Installation documentation.

Install Kutlass

Download the kutlass binary from the releases page then move the binary somewhere in your path, so you can run it from anywhere. For example:

sudo mv ./kutlass /usr/local/bin/kutlass

Run a workflow

You can run a workflow by providing the path to a workflow file. For example, we've provided a sample hello-petstore.sw.yaml workflow file which searches for available pets in the Swagger Petstore API and returns only those with a valid ID.

$ kutlass run https://learn.kuberkai.com/hello-petstore.sw.yaml 
{
  "pets": [
    {
      "category": {
        "id": 7,
        "name": "Doge"
      },
      "id": 7,
      "name": "Doge",
      "photoUrls": [
        "string"
      ],
      "status": "available",
      "tags": [
        {
          "id": 7,
          "name": "string"
        }
      ]
    },
    {
      "category": {
        "id": 8,
        "name": "Dogie"
      },
      "id": 8,
      "name": "cat",
      "photoUrls": [
        "string"
      ],
      "status": "available",
      "tags": [
        {
          "id": 8,
          "name": "string"
        }
      ]
    }
  ]
}

By default the workflow searches only for available pets, but you can change the behavior by providing a status input. For example, to search for sold pets:

$ kutlass run https://learn.kuberkai.com/hello-petstore.sw.yaml -d '{"status":"sold"}'