document what types of systems can be created

[janwillies]

What problem are you facing?

I wanted to create a System and looked for the available types but couldn't find any

It looks like there is at least:

• custom
• envoy
• kubernetes
• kubernetes:v2
• terraform(?)

I wasn't able to figure it out from the styra docs either.

How could provider-styra help solve your problem?

Maybe we can list them here: https://github.com/crossplane-contrib/provider-styra/blob/main/apis/system/v1alpha1/system.go#L55

[janwillies]

There's a (beta) API which list the available types:

$ curl -s -H "Authorization: Bearer $STYRA_TOKEN" https://$STYRA_HOST/v1/system-types | jq '.result[] | {name,type_name}'
{
  "name": "custom",
  "type_name": "custom"
}
{
  "name": "envoy",
  "type_name": "envoy"
}
{
  "name": "kubernetes",
  "type_name": "kubernetes:v2"
}
{
  "name": "terraform",
  "type_name": "template.terraform:1.0"
}

[janwillies]

DataSources would also benefit from more verbose docs, for example: https://doc.crds.dev/github.com/crossplane-contrib/provider-styra/styra.crossplane.io/DataSource/v1alpha1@v0.2.0#spec-forProvider-category

[MisterMX]

It might be a good idea to ask Styra for more verbose documentation of their API. Otherwise we would have to make wild guesses in some cases.