proxy-wasm-go-sdk
ngx_wasm_module
proxy-wasm-go-sdk | ngx_wasm_module | |
---|---|---|
2 | 1 | |
663 | 68 | |
1.4% | - | |
5.9 | 9.4 | |
4 days ago | about 17 hours ago | |
Go | C | |
Apache License 2.0 | Apache License 2.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
proxy-wasm-go-sdk
-
A "Tiny" APISIX Plugin
// references: // https://github.com/tetratelabs/proxy-wasm-go-sdk/tree/main/examples // https://github.com/apache/apisix/blob/master/t/wasm/ package main import ( "github.com/tetratelabs/proxy-wasm-go-sdk/proxywasm" "github.com/tetratelabs/proxy-wasm-go-sdk/proxywasm/types" "github.com/valyala/fastjson" ) func main() { proxywasm.SetVMContext(&vmContext{}) } // each plugin has its own VMContext. // it is responsible for creating multiple PluginContexts for each route. type vmContext struct { types.DefaultVMContext } // each route has its own PluginContext. // it corresponds to one instance of the plugin. func (*vmContext) NewPluginContext(contextID uint32) types.PluginContext { return &pluginContext{} } type header struct { Name string Value string } type pluginContext struct { types.DefaultPluginContext Headers []header } func (ctx *pluginContext) OnPluginStart(pluginConfigurationSize int) types.OnPluginStartStatus { data, err := proxywasm.GetPluginConfiguration() if err != nil { proxywasm.LogErrorf("error reading plugin configuration: %v", err) return types.OnPluginStartStatusFailed } var p fastjson.Parser v, err := p.ParseBytes(data) if err != nil { proxywasm.LogErrorf("error decoding plugin configuration: %v", err) return types.OnPluginStartStatusFailed } headers := v.GetArray("headers") ctx.Headers = make([]header, len(headers)) for i, hdr := range headers { ctx.Headers[i] = header{ Name: string(hdr.GetStringBytes("name")), Value: string(hdr.GetStringBytes("value")), } } return types.OnPluginStartStatusOK } // each HTTP request to a route has its own HTTPContext func (ctx *pluginContext) NewHttpContext(contextID uint32) types.HttpContext { return &httpContext{parent: ctx} } type httpContext struct { types.DefaultHttpContext parent *pluginContext } func (ctx *httpContext) OnHttpResponseHeaders(numHeaders int, endOfStream bool) types.Action { plugin := ctx.parent for _, hdr := range plugin.Headers { proxywasm.ReplaceHttpResponseHeader(hdr.Name, hdr.Value) } return types.ActionContinue }
-
Unlocking Istio's Versatility: A Guide to WASM Plugins in Kubernetes
Go (TinyGo) SDK
ngx_wasm_module
-
Nginx Development Guide
Proxy WASM appears to be supported thanks to a project from Kong: https://github.com/Kong/ngx_wasm_module
I haven't tried it yet, but it looks promising.
What are some alternatives?
envoy-preflight - A wrapper for applications to help with running envoy as a sidecar
ngx-rust - Rust binding for NGINX
spec - WebAssembly for Proxies (ABI specification)
njs-examples - NGINX JavaScript examples
proxy-wasm-zig-sdk - WebAssembly for Proxies (Zig SDK)
extism - The framework for building with WebAssembly (wasm). Easily load wasm modules, move data, call functions, and build extensible apps.
proxy-wasm-rust-sdk - WebAssembly for Proxies (Rust SDK)
njs-acme - Nginx NJS module runtime to work with ACME providers like Let's Encrypt for automated no-reload TLS certificate issue/renewal.
proxy-runtime
lua-nginx-module - Embed the Power of Lua into NGINX HTTP servers
proxy-wasm-cpp-sdk - WebAssembly for Proxies (C++ SDK)
nottinygc - Higher-performance allocator for TinyGo WASI apps