@ -15,11 +15,11 @@ option java_outer_classname = "WasmProto";
option java_multiple_files = true ;
option java_multiple_files = true ;
option ( udpa.annotations.file_status ) . package_version_status = ACTIVE ;
option ( udpa.annotations.file_status ) . package_version_status = ACTIVE ;
/ / [ # protodoc - title : Wasm service ]
/ / [ # protodoc - title : Wasm ]
/ / [ [ # not - implemented - hide : ]
/ / Configuration for a Wasm VM.
/ / Configuration for a Wasm VM.
/ / [ # next - free - field : 6 ]
/ / [ # next - free - field : 7 ]
/ / [ # not - implemented - hide : ] pending implementation.
message VmConfig {
message VmConfig {
/ / An ID which will be used along with a hash of the wasm code ( or the name of the registered Null
/ / An ID which will be used along with a hash of the wasm code ( or the name of the registered Null
/ / VM plugin ) to determine which VM will be used for the plugin. All plugins which use the same
/ / VM plugin ) to determine which VM will be used for the plugin. All plugins which use the same
@ -44,21 +44,26 @@ message VmConfig {
/ / Warning : this should only be enable for trusted sources as the precompiled code is not
/ / Warning : this should only be enable for trusted sources as the precompiled code is not
/ / verified.
/ / verified.
bool allow_precompiled = 5 ;
bool allow_precompiled = 5 ;
/ / If true and the code needs to be remotely fetched and it is not in the cache then NACK the configuration
/ / update and do a background fetch to fill the cache , otherwise fetch the code asynchronously and enter
/ / warming state.
bool nack_on_code_cache_miss = 6 ;
}
}
/ / [ [ # not - implemented - hide : ]
/ / Base Configuration for Wasm Plugins e.g. filters and services.
/ / Base Configuration for Wasm Plugins e.g. filters and services.
/ / [ # next - free - field : 6 ]
/ / [ # next - free - field : 6 ]
/ / [ # not - implemented - hide : ] pending implementation.
message PluginConfig {
message PluginConfig {
/ / A unique name for a filters / services in a VM for use in identifying the filter / service if
/ / A unique name for a filters / services in a VM for use in identifying the filter / service if
/ / multiple filters / services are handled by the same * vm_id * and * group_name * and for
/ / multiple filters / services are handled by the same * vm_id * and * root_id * and for
/ / logging / debugging.
/ / logging / debugging.
string name = 1 ;
string name = 1 ;
/ / A unique ID for a set of filters / services in a VM which will share a RootContext and Contexts
/ / A unique ID for a set of filters / services in a VM which will share a RootContext and Contexts
/ / if applicable ( e.g. an Wasm HttpFilter and an Wasm AccessLog ) . If left blank , all
/ / if applicable ( e.g. an Wasm HttpFilter and an Wasm AccessLog ) . If left blank , all
/ / filters / services with a blank group_name with the same * vm_id * will share Context ( s ) .
/ / filters / services with a blank root_id with the same * vm_id * will share Context ( s ) .
string group_name = 2 ;
string root_id = 2 ;
/ / Configuration for finding or starting VM.
/ / Configuration for finding or starting VM.
oneof vm_config {
oneof vm_config {
@ -71,13 +76,19 @@ message PluginConfig {
/ / ` google.protobuf.Struct ` is serialized as JSON before
/ / ` google.protobuf.Struct ` is serialized as JSON before
/ / passing it to the plugin. ` google.protobuf.BytesValue ` and
/ / passing it to the plugin. ` google.protobuf.BytesValue ` and
/ / ` google.protobuf.StringValue ` are passed directly without the wrapper.
/ / ` google.protobuf.StringValue ` are passed directly without the wrapper.
google.protobuf.Any configuration = 5 ;
google.protobuf.Any configuration = 4 ;
/ / If there is a fatal error on the VM ( e.g. exception , abort ( ) , on_start or on_configure return false ) ,
/ / then all plugins associated with the VM will either fail closed ( by default ) , e.g. by returning an HTTP 503 error ,
/ / or fail open ( if 'fail_open' is set to true ) by bypassing the filter. Note : when on_start or on_configure return false
/ / during xDS updates the xDS configuration will be rejected and when on_start or on_configuration return false on initial
/ / startup the proxy will not start.
bool fail_open = 5 ;
}
}
/ / WasmService is configured as a built - in * envoy.wasm_service * : ref : ` ServiceConfig
/ / [ [ # not - implemented - hide : ]
/ / < envoy_api_msg_extensions.wasm.v3.WasmService > ` . This opaque configuration will be used to
/ / WasmService is configured as a built - in * envoy.wasm_service * : ref : ` WasmService
/ / create a Wasm Service.
/ / < config_wasm_service > ` This opaque configuration will be used to create a Wasm Service.
/ / [ # not - implemented - hide : ] pending implementation.
message WasmService {
message WasmService {
/ / General plugin configuration.
/ / General plugin configuration.
PluginConfig config = 1 ;
PluginConfig config = 1 ;