Extension Manifest
Schema for Built On Envoy extension manifest files.
author
Author or organization name.
| Type | string |
| Required | Yes |
| Min length | 1 |
categories
Functional categories of the extension.
| Type | []string |
| Required | Yes |
| Allowed values | AI, Authentication, Decoder, Examples, Misc, Network, Observability, Performance, Traffic Control, Transform, Security |
composerVersion
Version of Built On Envoy Composer. Required if type is composer unless the parent field is set.
| Type | string |
| Required | No |
| Pattern | ^\d+\.\d+\.\d+(-dev)?$ |
| Forbidden when | parent is set |
| Required when | type is go and parent is not set |
description
Short single-line description of the extension.
| Type | string |
| Required | Yes |
| Min length | 1 |
| Max length | 200 |
examples
Usage examples for the extension.
| Type | []object |
| Required | Yes |
| Min items | 0 |
examples.code
Code snippet showing usage.
| Type | string |
| Required | Yes |
| Min length | 1 |
examples.description
Explanation of what the example demonstrates.
| Type | string |
| Required | Yes |
| Min length | 1 |
examples.title
Short title for the example.
| Type | string |
| Required | Yes |
| Min length | 1 |
extensionSet
Whether this manifest defines a set of extensions.
| Type | boolean |
| Required | No |
featured
Whether to feature this extension in UI/listings.
| Type | boolean |
| Required | No |
license
SPDX license identifier.
| Type | string |
| Required | Yes |
| Min length | 1 |
longDescription
Detailed multi-line description with markdown support.
| Type | string |
| Required | Yes |
| Min length | 1 |
lua
Lua extension configuration.
| Type | object |
| Required | No |
| Required when | type is lua |
| Requires one of | path, inline |
lua.inline
Inline Lua script code.
| Type | string |
| Required | No |
| Min length | 1 |
lua.path
Path to the Lua script file.
| Type | string |
| Required | No |
| Min length | 1 |
maxEnvoyVersion
Maximum compatible Envoy version.
| Type | string |
| Required | No |
| Pattern | ^\d+\.\d+\.\d+$ |
minEnvoyVersion
Minimum compatible Envoy version.
| Type | string |
| Required | No |
| Pattern | ^\d+\.\d+\.\d+$ |
name
Unique identifier for the extension.
| Type | string |
| Required | Yes |
| Min length | 1 |
| Pattern | ^[a-z][.a-z0-9-_]*$ |
parent
Parent extension set whose version will be used. When set, the version and composerVersion fields can’t be set.
| Type | string |
| Required | No |
| Min length | 1 |
| Pattern | ^[a-z][a-z0-9-_.]*$ |
tags
Searchable tags for categorization.
| Type | []string |
| Required | Yes |
| Min items | 1 |
| Unique items | Yes |
| Item pattern | ^[a-z][a-z0-9-]*$ |
| Item min length | 1 |
type
Type of the extension.
| Type | string |
| Required | Yes |
| Allowed values | lua, wasm, rust, go, composer |
version
Semantic version of the extension. Required unless the parent field is set.
| Type | string |
| Required | No |
| Pattern | ^\d+\.\d+\.\d+(-dev)?$ |
| Forbidden when | parent is set |
| Required when | parent is not set |