Engine local

Rodando a Engine localmente pela CLI

Obtendo o projeto

git clone http://gitlab.centralit.io/aura/blocks.git

Dentro dos repositórios do blocks temos uma pasta chamada cli. Acesse a mesma e compile o executável aura, caso ainda não tenha feito.

# dentro da raiz do projeto
cd cli
cargo install --path .

Aviso:

A partir desse momento o utilitário aura fica disponível para ser utilizado a partir de qualquer pasta

Configurando as variáveis de ambiente para a cli

É necessário exportar 3 váriaveis de ambiente para o funcionamento do comando aura. As variáveis devem apontar para o local onde os respectivos recursos estão sendo executados.

export ENGINE_HOST=http://localhost:6060/engine
export LOWTALK_HOST=http://localhost:8989/lowtalk
export LOWWIDGET_HOST=http://localhost:4156/lowwidget

Aviso:

Por padrão os servidores acima já estão configurados para as portas e pontos de montagem definidos no exemplo

Inicializar servidores

Aviso:

Esse tutorial assume que o suporte as linguagens de programação utilizadas pelo servidor já estão funcionando. Garanta que os comandos cargo, go e npm estão funcionando.

Aviso:

Garanta que o banco de dados está em execução e devidamente configurado nos arquivos main.sh dos respectivos projetos GO

# dentro da raiz do projeto
cd engine
sh scripts/main.sh

# dentro da raiz do projeto, em um novo terminal
cd lowtalk
sh scripts/main.sh

# dentro da raiz do projeto, em um novo terminal
cd lowwidget
sh scripts/main.sh

# dentro da raiz do projeto, em um novo terminal
cd wanderson
cargo run -- server -d ./workspace_examples

# dentro da raiz do projeto, em um novo terminal
cd lunaris
cargo run -- server -w ./workspace_examples

Resumo do comando aura

Após a instalação podemos ver os comandos disponíveis dentro da aura.

Ajuda

# Ajuda do comando aura
aura --help

Workspace

# Ajuda do subcomando workspace
aura workspace --help

# Retorna a lista de workspaces
aura workspace list

# Remove o workspace passado como parametro (coluna name da lista)
aura workspace remove wpname

# Cria um novo workspace a partir do lábel passado como parâmetro
aura workspace new "Label do Workspace"

Plugin

# Lista os plugins registrados em um workspace
aura list wpname

# Inspeciona as configurações de um plugin registrado
aura inspect wpname plname

# Remove um plugin registrado
aura remove wpname plname

# Registra um plugin
# Workflow: as propriedades podem ser passadas conforme a solicitação do plugin
aura register wpname "label do plugin" "url_do_manifesto" "propriedade0=valor0&propriedaden=valorn"

# Configura talker padrão e a ordem dos eventos
aura conf wpname -d nometalkerpadrao -o primeiroplugin -o segundoplugin

Fila

# Lista as filas
aura attendant list

# Remove uma fila
aura attendant remove flname

# Cria uma nova fila
aura attendant new "Label da Fila" -a "email_do_agente1" -a "email_do_agenten" -m "mensagem de captura" -j "mensagem de entrada na fila"

# Abre o atendimento humano para o agente passado no parâmetro
aura attendant open "email_do_agente"

# Lista os widgets
aura widget list

# Remove um widget
aura widget remove widget_name

# Cria uma novo widget
# Existem parâmetros adicionais que podem ser obtidos com --help
aura widget new "Label do Widget" 

# Abre o widget passado como parâmetro
aura widget open "nome_do_widget"