Crie uma função com WebAssembly

Compile e instancie um módulo WebAssembly dentro de uma função, a partir de um array de bytes no código ou de um arquivo .wasm que o handler busca.

Última atualização

Ver como Markdown Configurar agente

Uma função compila e instancia um módulo WebAssembly com a WebAssembly API, dentro do handler. Azion Runtime fornece essa API com a interface que a MDN define. Para conhecer os métodos estáticos e os construtores que ela carrega, consulte WebAssembly.

Os passos abaixo usam Azion Console. O módulo desta página exporta uma operação, increment, e o handler retorna o resultado dela no corpo da resposta. Os bytes do módulo chegam ao handler de duas formas: como um array de bytes no código da função ou como um arquivo .wasm que o handler busca por HTTP.

Pré-requisitos

  • Uma conta Azion. Para criar uma, consulte Como criar uma conta na Azion.
  • A permissão Edit Functions na conta. Ela concede permissão para criar, editar e remover funções, e também requer a permissão View Functions. Consulte Teams Permissions.

Crie a função com um módulo embutido

O array wasmCode contém o módulo, então o handler o compila sem uma requisição de rede. Para criar a função:

Abra a página Functions

Acesse Azion Console > Products Menu > Libraries > Functions.

Selecione + Function
Nomeie a função

Digite um nome para a função. Por exemplo: wasm-increment.

Cole o código na aba Code

Na aba Code, cole o código a seguir:

JavaScript
01export default {
02 fetch: async (request, env, ctx) => {
03 const wasmCode = new Uint8Array([
04 0, 97, 115, 109, 1, 0, 0, 0, 1, 6, 1, 96, 1, 127, 1, 127, 3, 2, 1, 0, 7, 13, 1, 9, 105, 110, 99, 114, 101,
05 109, 101, 110, 116, 0, 0, 10, 9, 1, 7, 0, 32, 0, 65, 1, 106, 11,
06 ]);
07
08 const wasmModule = new WebAssembly.Module(wasmCode);
09 const wasmInstance = new WebAssembly.Instance(wasmModule);
10 const increment = wasmInstance.exports.increment;
11 let value = 0;
12
13 if (request.headers.has("value")) {
14 let number = request.headers.get("value");
15 if (!isNaN(number)) {
16 value = parseInt(number);
17 }
18 }
19
20 let incremented = increment(value);
21 return new Response("incrementing " + value + " we have " + incremented);
22 },
23};
Selecione Save

A função fica salva e disponível para ser instanciada em uma aplicação.

O array wasmCode é a forma binária do seguinte módulo WAT, que soma 1 ao parâmetro i32 e retorna o resultado:

Texto
01(module
02 (type (;0;) (func (param i32) (result i32)))
03 (func (;0;) (type 0) (param i32) (result i32)
04 local.get 0
05 i32.const 1
06 i32.add)
07 (export "increment" (func 0)))

nota — WAT é a representação textual do formato binário do WebAssembly. Ele existe para que uma pessoa consiga ler e editar um módulo.

Um array de bytes faz parte do código-fonte da função, então o módulo conta para o limite de tamanho de código: 6 MB no Azion Console e 20 MB pela Azion API. Consulte Limites de Functions.

Carregue o módulo a partir de uma URL

Um handler lê os bytes do módulo por HTTP em vez de carregá-los. Substitua o array de bytes por uma chamada fetch e passe o corpo da resposta para WebAssembly.instantiate():

JavaScript
01export default {
02 fetch: async (request, env, ctx) => {
03 const wasmResponse = await fetch("https://example.com/increment.wasm");
04 const wasmCode = await wasmResponse.arrayBuffer();
05
06 const { instance } = await WebAssembly.instantiate(wasmCode);
07 const increment = instance.exports.increment;
08 let value = 0;
09
10 if (request.headers.has("value")) {
11 let number = request.headers.get("value");
12 if (!isNaN(number)) {
13 value = parseInt(number);
14 }
15 }
16
17 let incremented = increment(value);
18 return new Response("incrementing " + value + " we have " + incremented);
19 },
20};

O handler compila o que a URL retornar, então uma nova versão do módulo chega à função sem alteração de código. Cada chamada fetch conta como uma sub-requisição e uma invocação faz no máximo 50 delas. Consulte Limites de Functions.

Verifique a resposta

Uma função só é executada depois que uma instância de função a vincula a uma aplicação e uma regra do Rules Engine seleciona essa instância. Para montar essa cadeia, consulte Primeiros passos com Functions.

Para ler a resposta, requisite a URI definida na regra:

curl https://<your-azion-domain>/<your-uri>

O módulo incrementa o valor padrão, 0:

incrementing 0 we have 1

O handler lê o header value da requisição quando ela o carrega. Para incrementar outro inteiro, envie-o nesse header:

curl -H "value: 41" https://<your-azion-domain>/<your-uri>
incrementing 41 we have 42

O corpo da resposta carrega o resultado que o módulo WebAssembly calculou.

Próximos passos

Primeiros passos com FunctionsInstancie a função em uma aplicação e adicione a regra do Rules Engine que a executa.WebAssembly APITodos os métodos estáticos e construtores que Azion Runtime carrega, com sintaxe e parâmetros.Migre padrões de handler em FunctionsOs formatos de handler ES Modules e Service Worker e como mover código entre eles.Limites de FunctionsOs limites de tamanho de código, sub-requisições e tempo de CPU dentro dos quais uma função é executada.