Faça o deploy de uma function com a Azion CLI

Crie um projeto de function pelo terminal com a Azion CLI, execute-o na sua máquina e faça o deploy dele em um domínio ativo.

Última atualização

Ver como Markdown Configurar agente

Neste tutorial, você vai fazer o build e o deploy de uma function pelo terminal com a Azion CLI. Você vai salvar um personal token e criar um projeto. Depois, vai escrever o handler, executá-lo na sua máquina e fazer o deploy dele.

Os Primeiros passos com Functions chegam ao mesmo resultado pelo Azion Console. Esta página é o caminho pelo terminal e termina com os mesmos três objetos: uma function, uma instância e a aplicação que a serve.

Pré-requisitos

  • Uma conta Azion. Para criar uma, consulte Criar uma conta.
  • A Azion CLI instalada na sua máquina.
  • Um personal token.
  • Node.js e um gerenciador de pacotes, que a CLI usa para fazer o build do projeto.

1. Salve seu personal token

A CLI autoriza cada comando com um personal token armazenado na sua máquina. Para salvá-lo:

azion -t <your-token>

O token fica armazenado localmente, e os comandos seguintes se autorizam com ele. Você não o informa de novo.

2. Crie o projeto

O azion init cria o projeto e a configuração de build dele. Para iniciá-lo:

azion init

O comando pede um nome e sugere um que você pode aceitar:

? Your applications name: (affectionate-chaos)

Depois, ele pergunta qual preset usar. Selecione Javascript, o preset para uma function escrita em JavaScript puro, sem framework:

Shell
01? Choose a preset: [Use arrows to move, type to filter]
02> AI Studio
03 Angular
04 Astro
05 ...
06 Javascript

Depois, ele pergunta de qual template partir. Selecione Hello World:

Shell
01? Choose a template: [Use arrows to move, type to filter]
02> Hello World
03 HTMX Boilerplate
04 Simple Javascript Router Node
05 Simple Javascript Router
06 QStash EdgeFunction Scheduler
07 Upstash Geolocation
08 Upstash Rate Limit

Ele pergunta se deve instalar as dependências do projeto. Responda Y:

🤔 Do you want to install project dependencies? This may be required to generate initial configuration file (Y/n)

Ele pergunta se deve iniciar um servidor de desenvolvimento local. Responda N, porque a etapa 4 inicia o servidor:

🤔 Do you want to start a local development server? (y/N)

O diretório do projeto agora contém a configuração de build e o entrypoint que o build lê.

3. Escreva o handler

Abra o index.js, o entrypoint que o build lê por padrão, e substitua o conteúdo dele por um handler ES Modules:

JavaScript
01export default {
02 async fetch(request, env, ctx) {
03 return new Response('Hello World', {
04 headers: { 'content-type': 'text/plain' }
05 });
06 }
07};

O método fetch recebe a requisição, as variáveis de ambiente e o contexto de execução, e retorna a resposta que o cliente recebe. Este é o padrão que a Azion recomenda.

4. Execute a function localmente

Antes do deploy, execute o projeto na sua máquina e envie uma requisição a ele. Para iniciar o servidor local com o azion dev:

azion dev

O comando faz o build do projeto e depois exibe o endereço em que responde:

[Azion] [Server] › ✔ success Function running on port 0.0.0.0:3333, url: http://localhost:3333

De outro terminal, faça uma requisição a esse endereço:

curl http://localhost:3333/

O handler responde com o corpo da resposta:

Hello World

Pare o servidor com Ctrl+C quando a resposta estiver correta.

5. Faça o deploy do projeto

Para fazer o deploy do projeto na Azion com o azion deploy:

azion deploy

O comando faz o build do projeto e cria a aplicação e a function na sua conta. Ele instancia a function e exibe o domínio que a serve. O domínio tem o formato xxxxxxxxxx.map.azionedge.net.

Uma requisição a esse domínio retorna a mesma resposta que você leu localmente:

curl https://xxxxxxxxxx.map.azionedge.net/
Hello World

O primeiro deploy pode levar vários minutos para responder de todas as localidades. Uma requisição imediata pode falhar antes de a configuração estar pronta. Aguarde e tente de novo antes de diagnosticar.

Próximos passos

Desenvolva e teste uma function localmenteExecute o projeto na sua máquina e forneça variáveis de ambiente de um arquivo local.Como Functions funcionaO que precisa existir antes de uma function ser executada em uma requisição.Exemplos em JavaScriptHandlers para copiar no projeto como ponto de partida.Azion CLITodos os comandos que a CLI aceita e as flags de cada um.