1 of 20
2 of 20
3 of 20
4 of 20
5 of 20
6 of 20
7 of 20
8 of 20
9 of 20
10 of 20
11 of 20
12 of 20
13 of 20
14 of 20
15 of 20
16 of 20
17 of 20
18 of 20
19 of 20
20 of 20

doc

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:

  1. Inicialize um projeto Node.js na pasta da aplicação com o comando npm init -y.

  2. Crie um arquivo denominado index.js com o código da aplicação.

  3. Execute o comando:

    azioncli edge_applications init --name "my-app" --type javascript

  4. Execute o comando:

    azioncli edge_applications build

  5. 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
    
  6. 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:

  1. Após inicializar uma aplicação web com o comando edge_applications init, acesse o diretório azion criado automaticamente.
  2. Abra o arquivo config.json.
  3. 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".

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