(DEPRECATED after 0.14.0) Build with Rustls Plug-in
This plug-in has been deprecated after WasmEdge 0.14.0 because the rustls is replaced by reqwest.
The WasmEdge Rustls plug-in is a replacement for the OpenSSL plug-in in WasmEdge. It provides a Rust-friendly interface to the Rustls library, which is a modern, fast, and more secure alternative to OpenSSL.
Here's a step-by-step guide on how to build the WasmEdge Rustls plug-in:
Prerequisites
Ensure the following dependencies are installed on your system:
- Rust: You can install it from the official website.
- CMake: Minimum version 3.12. Install it from the official website.
Clone the WasmEdge Repository
First, clone the WasmEdge repository from GitHub:
git clone https://github.com/WasmEdge/WasmEdge.git
Navigate to the Rustls Plug-in Directory
Navigate to the wasmedge_rustls directory within the cloned repository:
cd WasmEdge/plugins/wasmedge_rustls
Build the Plug-in
Now you can build the Rustls plug-in. Run the following command:
cargo build --release
This command builds the plug-in in release mode. The compiled binary will be located in the target/release directory.
Install the Plug-in
To install the plug-in, you can use the cargo install command:
cargo install --path .
This command will install the built plug-in into your Rust binary directory.
Usage
To use the plug-in with WasmEdge, you need to specify it when starting the WasmEdge runtime:
wasmedge --dir .:. --reactor --rustls_plugin target/release/libwasmedge_rustls.so your_wasm_file.wasm
Replace your_wasm_file.wasm with the path to your WebAssembly file. The --rustls_plugin flag specifies the path to the Rustls plug-in.
That's it! You have successfully built and installed the WasmEdge Rustls plug-in. Please ensure to replace the OpenSSL plug-in with the Rustls plug-in in your WasmEdge runtime configuration if you were previously using OpenSSL.
For more information, you can refer to the GitHub repository.