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.
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.

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. 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