• CLI
• Edge Applications

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

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

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

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

O 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

O --application-id é o identificador único de sua edge application.

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

O comando delete é usado para excluir uma edge application.

    azioncli edge_applications delete --application-id 1234

A opção --application-id é o identificador único de uma edge application.

A opção --help mostra mais informações sobre o subcomando.

O comando list é utilizado quando for preciso listar suas edge applications.

    azioncli edge_applications list

A opção --details mostra todos os campos relevantes de suas edge applications.

A opção --filter filtra as aplicações pelo nome.

A opção --help mostra mais informações sobre o comando.

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

A 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