Guias

Como criar uma aplicação web usando a Azion CLI

Neste guia serão apresentadas as etapas para a criação de um aplicação web usando os comandos da Azion CLI.

Nota: para criar uma aplicação web com a Azion CLI utilizando um passo a passo detalhado, sugerimos seguir os tutoriais Aplicação web e Construindo uma aplicação web usando a Azion CLI passo a passo. Os tutoriais são indicados caso você encontre dúvidas ou dificuldades para seguir os passos deste guia.

Requisitos: Antes de iniciar a construção da sua aplicação web, você precisa:

Baixar e instalar o Node.js JavaScript runtime compatível com o seu sistema operacional a partir do site oficial. Essa instalação inclui o gerenciador de pacotes npm.
Baixar e instalar a Azion CLI, versão 0.46.0 ou superior, conforme apresentado no tópico Instalação.
Criar um personal token no RTM e configurá-lo na CLI. Veja o tópico Autorização na Plataforma da Azion.

Para criar uma aplicação web usando a CLI com o template JavaScript, siga os seguintes passos:

Inicialize um projeto Node.js na pasta da aplicação com o comando npm init -y.
Crie um arquivo denominado index.js com o código da aplicação.
Execute o comando:

azioncli edge_applications init --name "my-app" --type javascript
Execute o comando:

azioncli edge_applications build

Execute o comando:

azioncli edge_applications publish

A resposta da CLI será semelhante ao exemplo abaixo:

 Building your Web Application

 Your Web Application was built successfully
 Created Edge Function my-app with ID 1909
 Created Edge Application my-app with ID 123456789
 Created Domain my-app with ID 123456789
 Your Web Application was published successfully

 To visualize your application access the domain: xxxxxxx.map.azionedge.net

 Content is being propagated to all Azion POPs and it might take a few minutes for all edges to be up to date

Utilize a URL que aparece no final da mensagem do passo 5 para abrir a sua aplicação web no seu navegador de Internet.

Nota: a publicação de uma aplicação web pelo RTM ou pela CLI não é um processo instantâneo. Existe um tempo de propagação e configuração da aplicação nas edge locations da Azion. Pode ser necessário aguardar alguns minutos para a ativação da URL e a efetiva visualização da página da aplicação no navegador.

Navegue pelo RTM para visualizar os novos elementos que os comandos da CLI criaram neste guia.

Dica: caso deseje recuperar a URL da sua aplicação, acesse o Products Menu > Domains no RTM. Você verá uma lista dos seus domínios, inclusive aquele criado pelos comandos da CLI neste guia.

Configurando a saída dos comandos edge_applications da CLI

As saídas dos comandos edge_applications da CLI no terminal apresentam, por padrão, somente as informações mínimas e essenciais para o desenvolvedor. Caso necessário, é possível configurar a sua aplicação a fim de observar todas as mensagens de saída, independentemente da ocorrência de erros ou não.

Essa configuração pode ser útil para analisar com mais detalhes as respostas dos comandos e corrigir possíveis falhas no projeto. Porém, saídas detalhadas podem sobrecarregar rapidamente a tela do seu terminal com muitas informações. Caso sejam necessárias, siga o procedimento abaixo para alterar a exibição das respostas dos comandos.

Para configurar as respostas dos comandos edge_applications da Azion CLI, siga os passos abaixo:

Após inicializar uma aplicação web com o comando edge_applications init, acesse o diretório azion criado automaticamente.
Abra o arquivo config.json.
Nas seções init e build, altere as linhas "output-ctrl": "<valor>" de acordo com os seguintes valores:
- on-error: as mensagens de saída serão detalhadas somente quando ocorrer um erro. Esse é o valor padrão da chave.
- disable: as mensagens de saída serão sempre completas, independentemente da ocorrência ou não de erros na execução dos comandos.
```
     {  
         "init": {  
             "cmd": "...",  
             "env": "./azion/webdev.env",  
             "output-ctrl": "on-error"
         },  

         "build": {  
             "cmd": "...",  
             "env": "./azion/webdev.env",  
             "output-ctrl": "on-error"
         }
     }
```
Nota: não se esqueça da vírgula após a linha "env": "./azion/webdev.env".
Salve o arquivo e reinicie o terminal.

Pronto! Os próximos comandos da CLI passarão a exibir as mensagens com o nível de detalhamento especificado na configuração acima.

Não encontrou o que procurava? Abra um ticket.