6 releases

0.12.3 Aug 2, 2021
0.12.2 May 18, 2021
0.12.1 Mar 18, 2021
0.11.1 Feb 11, 2021

#8 in #request-http

Apache-2.0

19KB
315 lines

crates.io  Rust license  documentation

wasmCloud HTTP Server Provider

This library is a native capability provider for the wasmcloud:httpserver capability. Only actors signed with tokens containing this capability privilege will be allowed to use it.

It should be compiled as a native shared object binary (linux .so, mac .dylib, windows .dll) and made available to the wasmCloud host runtime as a plugin. If you want to statically compile (embed) it into a custom wasmCloud host, then simply enable the static_plugin feature in your dependencies:

wasmcloud-httpserver = { version = "0.11.1", features = ["static_plugin"] }

To create an actor that makes use of this capability provider, make sure that a configuration is supplied at runtime and includes a PORT variable. This will enable the HTTP server and direct all requests to your actor module, which you can handle by checking that a dispatched operation is equivalent to the constant OP_HANDLE_REQUEST. For more information on the various types available to HTTP-based actors, check out the actor-interfaces repository.

For more hands-on tutorials on building actors, including HTTP server actors, see the wasmcloud.dev website.

NOTE: If multiple actors within the same host process request HTTP server configurations, each actor will get its own HTTP server. Be careful not to request the same HTTP port for multiple actors in the same host process, as this will cause the host process to reject the configuration/binding.

Dependencies

~18–30MB
~530K SLoC