Primeiros passos com Functions

Crie sua primeira função pelo Azion Console, pela Azion CLI ou pela API, instancie-a em uma aplicação e acione-a com uma regra do Rules Engine.

Última atualização

Ver como Markdown Configurar agente

Este guia conduz você por executar sua primeira função na Azion. Os passos levam cerca de 10 minutos.

  • Criar uma função que retorna Hello World!.
  • Instanciar a função em uma aplicação.
  • Adicionar uma regra do Rules Engine que executa a instância na URI /hello-world.
  • Requisitar essa URI e ler a resposta.

Três objetos fazem uma função ser executada, e cada um se conecta ao seguinte:

  1. A função contém o código JavaScript.
  2. A instância de função vincula a função a uma aplicação. Ela também carrega os Args, um objeto JSON passado para o contexto de execução.
  3. A regra do Rules Engine seleciona a instância com o comportamento Run Function. A regra define a fase de execução e os critérios que a acionam.

Criar uma função não a executa. Uma instância sem uma regra do Rules Engine nunca é executada.

O Azion Terraform provider gerencia os mesmos três objetos. Para conhecer todas as interfaces que os carregam, consulte Functions.

Selecione a interface que você vai usar. Os pré-requisitos e todas as etapas abaixo seguem essa escolha.

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.
  • A permissão Edit Applications na conta. A instância e a regra alteram uma aplicação, e essa permissão concede permissão para editar, criar e remover aplicações. Ela também requer a permissão View Applications. Consulte Teams Permissions.
  • Uma aplicação. Para criar uma, consulte Primeiros passos com Applications.

Crie a função

A função contém o código que responde à requisição. Esta retorna a string Hello World!.

Para criar a função pelo Azion Console:

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: hello-world.

Cole o código na aba Code

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

JavaScript
01export default {
02 async fetch(request, env, ctx) {
03 return new Response('Hello World!');
04 },
05};
Selecione Save

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

dica — Para ler a resposta da função antes que ela atenda tráfego, use o Preview deployment. Ele roda o código no Azion Console sem um deployment.

A CLI lê o código de um arquivo local. Para criar a função:

Salve o código em um arquivo

Escreva o código a seguir em index.js:

JavaScript
01export default {
02 async fetch(request, env, ctx) {
03 return new Response('Hello World!');
04 },
05};
Execute o comando de criação
azion create function --name hello-world --code ./index.js --active true
Leia a saída

O comando imprime o id da nova função:

Created function with ID 12346

Registre o id. A instância o recebe. Para todas as flags que o comando aceita, consulte Azion CLI create.

O body da requisição carrega o código como uma string JSON, então as quebras de linha são escapadas como \n.

Envie a requisição de criação

Substitua [TOKEN VALUE] pelo seu personal token:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/functions \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "name": "hello-world",
08 "code": "export default {\n async fetch(request, env, ctx) {\n return new Response(\"Hello World!\");\n },\n};"
09}
Leia a resposta

Um 202 carrega a função:

JSON
01{
02 "state": "pending",
03 "data": {
04 "id": 12345,
05 "name": "hello-world",
06 "last_editor": "user@example.com",
07 "last_modified": "2026-01-01T12:00:00.385220Z",
08 "product_version": "2.0",
09 "active": true,
10 "runtime": "azion_js",
11 "execution_environment": "application",
12 "default_args": {},
13 "reference_count": 0,
14 "code": "export default {\n async fetch(request, env, ctx) {\n return new Response(\"Hello World!\");\n },\n};"
15 }
16}

Registre o id. A instância o recebe. O valor "state": "pending" significa que a alteração leva alguns minutos para propagar.

Instancie a função na sua aplicação

Uma instância vincula a função a uma aplicação, e uma função pode sustentar várias instâncias. Cada caminho ativa o módulo Functions na aplicação e então cria a instância.

Para vincular a função a uma aplicação pelo Azion Console:

Ainda em Azion Console, vá para Products Menu > Build > Applications
Selecione a aplicação que executa a função
Na aba Main Settings, ative o módulo Functions
Selecione Save
Vá para a aba Functions Instances
Selecione + Function Instance
Nomeie a instância

Digite um nome para a instância. Por exemplo: hello-world instance.

Selecione a função

Selecione a função hello-world.

Selecione Save

A nova instância aparece na aba Functions Instances.

Para ativar o módulo e criar a instância com a Azion CLI, substitua o id da aplicação e o id da função pelos seus:

Ative o módulo Functions
azion update application --application-id <application_id> --functions true

O comando confirma a aplicação:

Updated Application with ID <application_id>
Crie a instância
azion create function-instance --application-id <application_id> --function-id <function_id> --name "hello-world instance"
Leia a saída

O comando imprime o id da nova instância:

Created Function Instance with ID 12348

Registre o id da instância. A regra o recebe.

Duas requisições ativam o módulo e criam a instância.

Ative o módulo Functions

Substitua <application_id> pelo ID da sua aplicação:

Shell
01curl --request PATCH \
02 --url https://api.azion.com/v4/workspace/applications/<application_id> \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "modules": {
08 "functions": {
09 "enabled": true
10 }
11 }
12}

A resposta retorna os módulos que a aplicação agora carrega:

JSON
01{
02 "cache": { "enabled": true },
03 "functions": { "enabled": true },
04 "application_accelerator": { "enabled": false },
05 "image_processor": { "enabled": false }
06}
Crie a instância

Substitua <function_id> pelo id que a criação da função retornou:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/applications/<application_id>/functions \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "name": "hello-world instance",
08 "function": <function_id>,
09 "args": {},
10 "active": true
11}
Leia a resposta

Um 202 carrega a instância:

JSON
01{
02 "state": "pending",
03 "data": {
04 "id": 12347,
05 "name": "hello-world instance",
06 "args": {},
07 "function": 12345,
08 "active": true,
09 "last_editor": "user@example.com",
10 "last_modified": "2026-01-01T12:00:21.272376Z"
11 }
12}

O campo function carrega o id da função que a instância executa. Ele é diferente de id, que é único para cada instância.

Registre o id da instância. A regra o recebe.

Adicione a regra que executa a função

Uma instância é executada apenas quando uma regra do Rules Engine a seleciona. Esta regra executa a instância em requisições para /hello-world.

Para adicionar a regra pelo Azion Console:

Na mesma aplicação, vá para a aba Rules Engine
Selecione + Rule
Nomeie a regra

Digite um nome para a regra. Por exemplo: Run hello-world.

Selecione Request Phase
Selecione a variável na seção Criteria

Na seção Criteria, selecione a variável ${uri}.

Selecione is equal como operador de comparação
Digite o argumento

Digite /hello-world como argumento.

Na seção Behaviors, selecione Run Function
Selecione a instância que você criou
Selecione Save

A regra executa a instância em toda requisição cuja URI é /hello-world.

nota — Se Run Function não estiver na lista de Behaviors, a aplicação também precisa do módulo Application Accelerator. Consulte Run Function não aparece na lista de comportamentos para a correção.

A CLI lê a regra de um arquivo JSON. Para adicionar a regra:

Escreva a regra em um arquivo

Salve o conteúdo a seguir como rule.json, com o id da sua instância em attributes.value:

JSON
01{
02 "name": "Run hello-world",
03 "description": "Run the function on /hello-world",
04 "active": true,
05 "criteria": [
06 [
07 {
08 "conditional": "if",
09 "variable": "${uri}",
10 "operator": "is_equal",
11 "argument": "/hello-world"
12 }
13 ]
14 ],
15 "behaviors": [
16 {
17 "type": "run_function",
18 "attributes": { "value": 12348 }
19 }
20 ]
21}
Crie a regra
azion create rules-engine --application-id <application_id> --phase request --file rule.json
Leia a saída

O comando imprime o id da nova regra:

Created Rules Engine with ID 234568

A regra executa a instância em toda requisição cuja URI é /hello-world.

Para adicionar a regra com a Azion API:

Escreva a regra em um arquivo

Os critérios carregam ${uri}, que um shell expande, então o body é enviado a partir de um arquivo. Salve o conteúdo a seguir como rule.json, com o id da sua instância em attributes.value:

JSON
01{
02 "name": "Run hello-world",
03 "description": "Run the function on /hello-world",
04 "active": true,
05 "criteria": [
06 [
07 {
08 "conditional": "if",
09 "variable": "${uri}",
10 "operator": "is_equal",
11 "argument": "/hello-world"
12 }
13 ]
14 ],
15 "behaviors": [
16 {
17 "type": "run_function",
18 "attributes": { "value": 12347 }
19 }
20 ]
21}
Envie a requisição de criação
Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/applications/<application_id>/request_rules \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data @rule.json
Leia a resposta

Um 202 carrega a regra, com o order que ela ocupa entre as regras da aplicação:

JSON
01{
02 "state": "pending",
03 "data": {
04 "id": 234567,
05 "name": "Run hello-world",
06 "active": true,
07 "behaviors": [
08 {
09 "type": "run_function",
10 "attributes": { "value": 12347 }
11 }
12 ],
13 "order": 0,
14 "last_editor": "user@example.com",
15 "last_modified": "2026-01-01T12:01:25.270982Z"
16 }
17}

A regra executa a instância em toda requisição cuja URI é /hello-world.

Novas regras podem levar alguns minutos para propagar. Aguarde antes de requisitar a URI.

Verifique a resposta

Sua aplicação responde em um domínio no formato xxxxxxxxx.map.azionedge.net. Para definir o domínio da sua aplicação, consulte Adicione um domínio a um workload.

Para confirmar que a função é executada, requisite a URI definida na regra:

curl https://<your-azion-domain>/hello-world

O corpo da resposta é a string que a função retorna:

Hello World!

A função agora é executada em toda requisição que corresponde aos critérios da regra.

Próximos passos

Como funcionaA cadeia de invocação em detalhe, da função à requisição que a aciona.Instâncias de funçãoPasse Args para uma instância em JSON.Variáveis de ambienteArmazene configurações e segredos fora do código da função e leia cada valor pela chave em tempo de execução.Exemplos em JavaScriptCódigo de função para adaptar à sua própria lógica.Boas práticasO que cada parte do handler faz e as decisões de design que mantêm uma invocação dentro dos seus limites.Desenvolvimento localCompile e execute o projeto na sua própria máquina com o comando azion dev.