go/

README

KubeVela Go SDK

This is a Go SDK for KubeVela generated via vela CLI

Generating

1. Init the SDK project

vela def gen-api --lang go --output sdk -f /path/to/your/definition/dir --init

1. Generate any definition

vela def gen-api --lang go --output sdk -f /another/definition/dir

Features:

• 🔧Application manipulating
  • Add Components/Traits/Workflow Steps/Policies
  • Setting Workflow Mode
  • Convert to K8s Application Object
  • Convert from K8s Application Object
  • Get Components/Traits/Workflow Steps/Policies from app
  • Referring to external Workflow object.
• 🔍Application client
  • Create/Delete/Patch/Update Application
  • List/Get Application

Example

See example for more details.

Future Work

There is some proper features for this SDK and possible to be added in the future. If you are interested in any of them, please feel free to contact us.

• Part of vela CLI functions
  • Application logs/exec/port-forward
  • Application resource in tree structure
  • VelaQL
  • ...
• Standalone workflow functions
  • CRUD of workflow

Known issues

There are some known issues in this SDK, please be aware of them before using it.

1. labels and annotations trait is not working as expected.
2. notification workflow-step's parameter is not exactly the same as the one in KubeVela.