Azion CLI

Uma interface de linha de comando (CLI) de uma plataforma de nuvem é um programa que você executa em um terminal. Você atua sobre a sua conta com comandos digitados em vez de uma interface web, e um token salvo na sua máquina autoriza cada comando. Como toda ação é um comando, as mesmas etapas são executadas à mão, em um script ou em um pipeline de CI/CD.

A Azion CLI coloca a Azion Platform atrás de um único comando de terminal, azion, um binário open source escrito em Go. Ela tem duas famílias de comandos. Os comandos de projeto configuram o projeto da pasta atual, executam esse projeto localmente e fazem o build e o deploy dele. Os comandos de recursos criam, listam, descrevem, atualizam e excluem um recurso da plataforma de cada vez, com a forma azion <verb> <noun>. Use a Azion CLI para fazer o deploy de um site ou de uma function, testar o projeto localmente, gerenciar recursos como código ou automatizar deploys em pipelines de CI/CD.

Um build é executado no Azion Bundler, um adaptador de frameworks open source. azion build e azion deploy executam o bundler com o preset do projeto, e o bundler adapta a saída de um framework web para ser executada na Azion Platform. Para saber como as duas famílias de comandos chegam à plataforma, consulte Como a Azion CLI funciona.

Você também pode gerenciar os mesmos recursos pela Azion API ou com o Azion Terraform Provider.

A CLI e a sua conta

A Azion CLI é um cliente: os recursos que ela cria e altera ficam na sua conta, e todo comando chega a eles pela Azion API.

1. Você executa azion em um terminal. A CLI autoriza cada comando com o personal token que ela salvou na sua máquina no login. Em um script ou em um job de CI, em que azion login não consegue fazer as perguntas dele, a opção global --token salva o token.
2. Um comando de projeto, como azion deploy, é executado dentro da pasta do projeto e lê o arquivo azion/azion.json e o arquivo azion.config dessa pasta.
3. A CLI, um binário Go, chama a Azion API.
4. A API cria ou atualiza os recursos da sua conta, como uma aplicação e um workload. Após um deploy, a CLI grava o ID de cada recurso em azion/azion.json.

Para o build, os arquivos do projeto e os perfis em detalhe, consulte Como a Azion CLI funciona.

Deploy de um projeto

Um único comando faz o deploy de um projeto. Na pasta de um site estático, azion deploy faz o deploy dele:

O comando envia os arquivos-fonte, e o build é executado na Azion. A saída termina com o domínio que serve o site:

• Uploading source files envia o projeto para a Azion, então o build não precisa de ferramentas de build na sua máquina. Com --local, o build é executado na sua máquina.
• O link do Azion Console abre Deploy Log, que mostra o progresso do build remoto.
• As últimas linhas mostram a URL do workload, um domínio map.azionedge.net.
• O comando grava o ID de cada recurso que criou em azion/azion.json, então o próximo deploy atualiza os mesmos recursos.

O primeiro deploy pode levar vários minutos para responder em todas as localidades; os deploys seguintes levam cerca de dois minutos. Para todas as flags do comando, consulte Azion CLI deploy.

Em um script ou em um job de CI, azion link --name <name> --preset <preset> --auto não faz nenhuma pergunta, e a opção global --token passa o personal token. Azion CLI presets lista os nomes dos presets e, para um projeto Next.js, Versões do Next.js lista as versões que rodam na Azion. Quando um link falha ou um deploy para, consulte Invalid build preset name e Failed to capture deploy logs.

Instalar a Azion CLI

O script de instalação é a forma recomendada de instalar a Azion CLI. Ele coloca o binário azion no seu path:

A Azion CLI também é publicada para gerenciadores de pacotes. Homebrew, Chocolatey e Windows Package Manager baixam o pacote para você. Para RPM, dpkg, APK e APT, primeiro baixe o pacote do seu sistema na página de releases e depois instale o arquivo baixado. Cada aba mostra o comando que instala a CLI e o comando que a atualiza:

azion version confirma a instalação:

O comando imprime a versão da CLI:

Em seguida, a CLI precisa de um personal token para atuar sobre a sua conta. Para salvar um, consulte Azion CLI login.

O que a CLI cobre

A Azion CLI cobre o ciclo de vida de um projeto, os recursos de uma conta e a configuração da própria CLI:

• Comandos de projeto: azion init cria um projeto a partir de um template, e azion link configura uma pasta existente. azion dev executa o projeto em um servidor de desenvolvimento local, e azion build e azion deploy fazem o build e o deploy dele. azion sync grava os recursos remotos de volta nos arquivos do projeto, azion unlink desvincula a pasta e azion rollback volta a servir um deploy anterior de um site estático.
• Comandos de recursos: azion <verb> <noun> gerencia aplicações, functions, workloads, connectors, firewalls, zonas DNS, certificados, buckets de storage e tokens, em 28 nouns. Comandos de recursos lista cada noun e os verbos que ele aceita. azion clone copia uma aplicação sob um novo nome, e azion config gerencia recursos a partir de arquivos de manifesto.
• Configuração do projeto: azion.config.js declara, como código, as configurações de build de um projeto e os recursos de que ele precisa na Azion.
• Conta e configurações: azion login, azion logout e azion whoami gerenciam a sessão. azion profiles alterna entre contas, e azion reset retorna as configurações armazenadas aos seus valores padrão. As flags que todo comando aceita estão em Opções globais.
• Cache: azion purge remove objetos em cache antes do fim do TTL deles, e azion warmup solicita as páginas de um site para que elas fiquem em cache antes que os visitantes as peçam.
• Logs: azion logs imprime os logs de console das suas functions e os logs de eventos HTTP das suas aplicações.
• Frameworks: projetos desenvolvidos com Next.js, React, Vue, Angular, Astro e outros frameworks fazem o deploy pelo Azion Bundler. O Next.js tem dois presets, next e opennextjs, e Versões do Next.js lista as versões do Next.js que rodam na Azion. Guias e tutoriais da Azion CLI traz um guia por framework, e Compatibilidade com web frameworks descreve como cada framework é executado no Azion Runtime. Para fazer o deploy de um repositório pelo Azion Console em vez do terminal, consulte Importe um projeto do GitHub.
• Ajuda: Solucionar problemas da Azion CLI lista os erros que um comando pode retornar e como corrigir cada um, e o Glossário define os termos da CLI.

Próximos passos