Primeiros passos com a Azion CLI

Instale a Azion CLI, crie um projeto de function em JavaScript, execute-o localmente e faça o deploy dele na Azion pelo terminal.

Última atualização

Ver como Markdown Configurar agente

Este guia orienta você no seu primeiro deploy com a Azion CLI.

  • Instale a CLI e salve o seu personal token nela.
  • Crie um projeto de function em JavaScript com azion init.
  • Execute a function na sua máquina com azion dev.
  • Faça o deploy da function com azion deploy e faça uma requisição a ela por HTTPS.

O comando azion deploy cria cinco objetos a partir do projeto, e cada um se liga ao seguinte:

  1. A function guarda o código em src/function/index.js.
  2. A function instance vincula a function à aplicação.
  3. A aplicação tem uma regra de requisição, Execute Function, que executa a instância em todos os caminhos.
  4. O workload atende a aplicação em um domínio.
  5. O deployment conecta o workload à aplicação.

Para mais informações sobre functions, consulte Functions.

Pré-requisitos

Instale a CLI e faça login

Instale a Azion CLI com o script de instalação:

curl -fsSL https://cli.azion.app/install.sh | bash

Se você usa Homebrew, instale a fórmula azion:

brew install azion

Os dois comandos colocam o binário azion no seu path. Confirme a versão instalada:

azion version

O comando imprime a versão:

Azion CLI 4.23.0

Salve o seu personal token na CLI. Substitua [TOKEN VALUE] pelo seu token:

azion -t [TOKEN VALUE]

A CLI guarda o token localmente, e os comandos seguintes o usam sem a flag. Confirme a conta que a CLI usa:

azion whoami

O comando imprime o client ID e o email da conta, e o perfil ativo:

Texto
01 Client ID: 1234u
02 Email: you@example.com
03 Active Profile: default

A CLI está instalada e autorizada na sua conta.

Crie o projeto

O comando azion init cria o projeto a partir de um preset e de um template. Crie um projeto chamado my-function:

azion init --name my-function

Sem --name, o comando pergunta o nome e sugere um nome aleatório. Em seguida, o comando faz cinco perguntas. Responda nesta ordem:

Selecione o preset Javascript

Em ? Choose a preset:, use as setas do teclado para selecionar Javascript.

Selecione o template Hello World

Em ? Choose a template:, selecione Hello World.

Instale as dependências

Em Do you want to install project dependencies?, digite Y.

Pule o servidor de desenvolvimento local

Em Do you want to start a local development server?, digite n. O azion dev o inicia depois.

Pule o deploy

Em Do you want to deploy your project?, digite n. O azion deploy faz o deploy dele depois.

O comando busca o template, instala as dependências e confirma o projeto:

Texto
01? Choose a preset: Javascript
02? Choose a template: Hello World
03
04Fetching selected template...
05
06Template successfully fetched
07Template successfully configured
08🤔 Do you want to install project dependencies? This may be required to generate initial configuration file (Y/n) Y
09Installing application dependencies
10up to date, audited 1 package in 399ms
11found 0 vulnerabilities
12…
13[Azion] [Build] › ℹ info Using preset: javascript
14[Azion] [Build] › ✔ success Build completed successfully with only azion.config
15[Azion] [IaC] › ✔ success Manifest generated successfully at <project-dir>/.edge/manifest.json
16🤔 Do you want to start a local development server? (y/N) n
17If you want to start a local development server later, run 'azion dev'
18Make sure to change to the new working directory before running building or deploying your project
19🤔 Do you want to deploy your project? (y/N) n
20If you want to deploy your application later, run 'azion deploy'
21Make sure to change to the new working directory before running building or deploying your project
22Your application my-function was initialized successfully

O projeto fica em um novo diretório my-function, com estes arquivos:

Texto
01.
02./.edge
03./.edge/manifest.json
04./.gitignore
05./azion
06./azion.config.mjs
07./azion/azion.json
08./index.js
09./info.json
10./package-lock.json
11./package.json
12./README.md
13./src
14./src/function
15./src/function/index.js

O template grava a function em src/function/index.js. Ela responde a todas as requisições com Hello World!:

JavaScript
01/**
02 * Handle Request
03 * This is the input function where you can perform your implementation.
04 * @param {Request} request https://developer.mozilla.org/en-US/docs/Web/API/Request
05 * @param {*} args function args e.g args.my_secret
06 * @returns {Response} https://developer.mozilla.org/en-US/docs/Web/API/Response
07 */
08async function handleRequest(request, args) {
09 const message = `Hello World!`;
10
11 return new Response(message, {
12 headers: {
13 "content-type": "text/plain;charset=UTF-8",
14 },
15 status: 200,
16 });
17}
18
19export { handleRequest };

Substitua o conteúdo de src/function/index.js pelo código a seguir. A function passa a retornar o caminho e o método de cada requisição em JSON:

JavaScript
01/**
02 * Handle Request
03 * This is the input function where you can perform your implementation.
04 * @param {Request} request https://developer.mozilla.org/en-US/docs/Web/API/Request
05 * @param {*} args function args e.g args.my_secret
06 * @returns {Response} https://developer.mozilla.org/en-US/docs/Web/API/Response
07 */
08async function handleRequest(request, args) {
09 const url = new URL(request.url);
10 const body = { message: "Hello from my-function", path: url.pathname, method: request.method };
11
12 return new Response(JSON.stringify(body), {
13 headers: {
14 "content-type": "application/json;charset=UTF-8",
15 },
16 status: 200,
17 });
18}
19
20export { handleRequest };

O projeto my-function guarda o código da function e está pronto para ser executado.

Execute a function localmente

Os comandos dev, build e deploy são executados de dentro do diretório do projeto. Vá para o diretório my-function:

cd my-function

Inicie o servidor de desenvolvimento local:

azion dev

O comando faz o build da function e a serve na porta 3333:

Texto
01…
02[Azion] [Build] › ℹ info Using preset: javascript
03[Azion] [Pre-Build] › ℹ info Starting pre-build...
04[Azion] [Pre-Build] › ℹ info Pre-build completed successfully
05[Azion] [Build] › ℹ info Using preset default entry: index.js
06[Azion] [Build] › ⚠ warning DEPRECATED: Migrate handler to → export default { fetch: (request, env, ctx) => {...} }
07[Azion] [Build] › ℹ info Starting build...
08[Azion] [Build] › ✔ success Build completed successfully
09[Azion] [Post-Build] › ℹ info Starting post-build...
10[Azion] [Post-Build] › ✔ success Post-build completed successfully
11[Azion] [Server] › ✔ success Function running on port 0.0.0.0:3333, url: http://localhost:3333
12[Azion] [Server] › ℹ info Initial scan complete. Ready for changes.

O servidor ocupa o terminal. Em um segundo terminal, faça uma requisição a um caminho do servidor:

curl -s -i 'http://localhost:3333/hello?x=1'

A function responde com um corpo JSON:

Texto
01HTTP/1.1 200 OK
02content-type: application/json;charset=UTF-8
03Date: Thu, 01 Jan 2026 12:00:00 GMT
04Connection: keep-alive
05Keep-Alive: timeout=5
06Transfer-Encoding: chunked
07
08{"message":"Hello from my-function","path":"/hello","method":"GET"}

A function é executada na sua máquina e retorna o caminho e o método da requisição.

Faça o deploy da function

O comando azion deploy envia o projeto, faz o build dele e cria a function, a aplicação e o workload. No diretório my-function, faça o deploy do projeto:

azion deploy

O comando imprime o domínio do workload:

Texto
01Running deploy command
02Uploading source files
03
04Upload completed successfully!
05Please visit https://console.azion.com/create/deploy/00000000-0000-0000-0000-000000000001 in case it did not open automatically, to follow up the full deploy process
06Your Application was deployed successfully
07
08To visualize your application access the Domain: https://xxxxxxxxxx.map.azionedge.net
09Your application is being deployed to all Azion Locations and it might take a few minutes.

O deploy registra o ID de cada objeto que criou em azion/azion.json. Os deploys seguintes leem esse arquivo para atualizar os mesmos objetos:

JSON
01{
02 "name": "my-function",
03 "preset": "javascript",
04 …
05 "function": [
06 {
07 "id": 12360,
08 "name": "my-function",
09 …
10 "instance-id": 12363,
11 …
12 }
13 ],
14 "application": {
15 "id": 1234567893,
16 "name": "my-function"
17 },
18 …
19 "rules-engine": {
20 …
21 "rules": [
22 {
23 "id": 123461,
24 "name": "Execute Function",
25 "phase": "request"
26 }
27 ]
28 },
29 …
30 "workloads": {
31 "id": 1234567903,
32 "name": "my-function",
33 …
34 "url": "https://xxxxxxxxxx.map.azionedge.net",
35 "deployment_id": [
36 {
37 "id": 123473,
38 "name": "my-function"
39 }
40 ]
41 },
42 …
43}

O primeiro deploy pode levar vários minutos para responder em todas as localidades. Enquanto uma localidade não tem a function, ela responde 404 com uma página intitulada There's nothing here yet. Aguarde e tente de novo antes de diagnosticar o deploy.

Verifique a function após o deploy

Faça uma requisição ao mesmo caminho no domínio que azion deploy imprimiu. Substitua <your-azion-domain> por esse domínio:

curl -s -i 'https://<your-azion-domain>/hello'

A function responde com o mesmo corpo JSON que retornou na sua máquina:

Texto
01HTTP/2 200
02date: Thu, 01 Jan 2026 12:00:00 GMT
03content-type: application/json;charset=UTF-8
04x-azion-request-id: 0123456789abcdef0123456789abcdef
05x-azion-edge-location: <edge-location>
06alt-svc: h3=":443"; ma=86400
07
08{"message":"Hello from my-function","path":"/hello","method":"GET"}

A function é executada na infraestrutura distribuída da Azion e responde no domínio do workload.

Para alterar a function, edite src/function/index.js e execute azion deploy de novo no diretório my-function. Os deploys seguintes levam cerca de dois minutos para responder em todas as localidades.

Próximos passos

Como a Azion CLI funcionaOs presets, o build, o arquivo azion.json, os perfis e como a CLI encontra o seu token.Comandos de recursosCrie, liste, descreva, atualize e exclua recursos da plataforma pelo terminal.Desenvolva com um frameworkFaça o deploy de um site ou de uma aplicação criada com um framework, como Next.js, Astro ou Vue.FunctionsO runtime, os limites e as configurações das functions das quais a CLI faz o deploy.