Comando edge applications e seus subcomandos
Conheça o comando que possibilita a criação e gerenciamento de suas edge applications na plataforma da Azion e seus subcomandos utilizando a Azion Command-Line Interface (CLI).
Inicializando
Seção intitulada InicializandoO processo de inicialização cria o ambiente necessário para a construção de sua edge application. Para isso, você precisa:
- Escolher um dos templates disponíveis na CLI:
- Next.js
- Static
- CDN
- Inicializar um projeto JavaScript com o Node.js runtime environment.
azioncli edge_applications init
A opção --name
pode ser especificada, mas não é obrigatória. Caso não seja informada, o nome do seu projeto será o mesmo que está definido no package.json
do projeto.
A opção --type
pode ser especificada, mas não é obrigatória. Caso não seja informada, o tipo do projeto será autodetectado.
Atualmente, a CLI tem três templates disponíveis, e o tipo cdn
para o desenvolvimento de uma edge application que seguem --type
:
- Static
azioncli edge_applications init --name <"application_name"> --type static
- Next.js
azioncli edge_applications init --name <"application_name"> --type nextjs
- CDN
azioncli edge_applications init --name <"application_name"> --type cdn
Caso não exista o arquivo de configuração package.json
no diretório de sua aplicação, a CLI retornará a seguinte mensagem de erro:
Error: Failed to find package.json in current directory. Verify if you are currently in your project's directory
Nesse caso, crie o arquivo de configuração package.json
no mesmo repositório que se encontra sua aplicação. Então, rode novamente o comando --init
para inicializar a aplicação.
Dica: a melhor solução para a criação do arquivo
package.json
é inicializar um projeto Node.js no diretório da aplicação. Para fazer isso, use o comando do Node.js runtime environment:
npm init -y
Resposta do comando no terminal:
Wrote to /Users/<user_name>/web-app-proj/package.json:
{ "name": "web-app-proj", "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "keywords": [], "author": "", "license": "ISC" }
A opção --no
força a resposta ‘no’ para todos inputs do usuário.
A opção --yes
força a resposta ‘yes’ para todos inputs do usuário.
2. Construindo
Seção intitulada 2. ConstruindoO segundo passo na criação de uma edge application é a construção baseada nos atributos que foram passados no comando init
. O comando usado na construção da aplicação é o build
.
azioncli edge_applications build
A única flag disponível para o comando build
é --help
, que mostra uma breve tela de ajuda.
Nota: uma necessidade para o uso do comando build
é a presença do framework Webpack instalado em seu computador.
Publicando
Seção intitulada PublicandoO passo final na criação de uma edge application é a publicação da mesma na plataforma da Azion. O comando publish
realiza essa tarefa automaticamente.
azioncli edge_applications publish
A única flag disponível para o comando publish
é --help
, que mostra uma breve tela de ajuda.
Nota: a publicação de uma edge application via Real-Time Manager (RTM) ou CLI não é um processo instantâneo. É necessário um tempo para a propagação e configuração da aplicação nos pontos de edge da Azion. Pode ser necessário alguns minutos para que a URL seja ativada e a aplicação possa ser visualizada no navegador.
Descrevendo
Seção intitulada DescrevendoO subcomando describe
mostra informações sobre uma edge application específica, baseado no ID que é passado, apresentando seus atributos detalhados.
azioncli edge_applications describe --application-id 4312 azioncli edge_applications describe --application-id 1337 --out "./tmp/test.json" --format json azioncli edge_applications describe --application-id 1337 --format json
Application ID
Seção intitulada Application IDO --application-id
é o identificador único de sua edge application.
Format
Seção intitulada FormatA opção --format
altera o formato do output, passando o valor json
pela flag.
A opção --help
mostra mais informações sobre o subcomando.
A opção --out
exporta o output para o <file_path/file_name.ext>
informado.
Deletando
Seção intitulada DeletandoO comando delete
é usado para excluir uma edge application.
azioncli edge_applications delete --application-id 1234
Application ID
Seção intitulada Application IDA opção --application-id
é o identificador único de uma edge application.
A opção --help
mostra mais informações sobre o subcomando.
Listando
Seção intitulada ListandoO comando list
é utilizado quando for preciso listar suas edge applications.
azioncli edge_applications list
Details
Seção intitulada DetailsA opção --details
mostra todos os campos relevantes de suas edge applications.
Filter
Seção intitulada FilterA opção --filter
filtra as aplicações pelo nome.
A opção --help
mostra mais informações sobre o comando.
Order by
Seção intitulada Order byA opção --order_by
ordena a saída baseando-se nos campos selecionados.
A opção --page
retorna uma página da lista respeitando o seu número. O valor padrão é 1
.
Page size
Seção intitulada Page sizeA opção --page_size
define quantos itens devem ser retornados por página. O valor padrão é 10
.
A opção --sort
define a ordem que as aplicações serão mostradas na lista. As opções são <asc|desc>
.
Contribuidores