Confirma Fácil CLI
Ferramenta de command line interface para o Confirma Fácil. Seu objetivo é centralizar todos os scripts de automatização de tarefas e deploy.
Instalação
Requisitos
- Linux
- node 8.1 ou superior.
$ npm install @gkoplus/confirmafacil-cli -g
Importante:
- A pasta
~/app/scripts/
deve existir. - O local do projeto eclipse deve ser
~/app/eclipse-workspace/confirmafacil-eclipse/
Ajuda
A execução do comando confirmafacil sem nenhum parâmetro resulta na tela de ajuda.
$ confirmafacil
Quando não ficar claro o que um comando faz, basta digitar o parâmetro --help para obter auxílio.
$ confirmafacil backend-context --help
Usage: backend-context [options]
generate context for a client.
Options:
-e --env <type> Environment type.
-d, --dir <type> Directory to deploy context.
-h, --help output usage information
Frontend
Funcionalidades:
1. Instalar dependencias do projeto
$ confirmafacil frontend-install
2. Rodar a aplicação.
Aceita os seguintes parâmetros:
- --env: Qual o ambiente em questão.
$ confirmafacil frontend-serve -e homologation
3. Realizar o build da aplicação.
Aceita os seguintes parâmetros:
- --env: Qual o ambiente em questão.
$ confirmafacil frontend-build -e homologation
4. Realizar o deploy da aplicação.
Aceita os seguintes parâmetros:
- --env: Qual o ambiente em questão.
- --key: Local da chave privada da amazon.
$ confirmafacil frontend-deploy --env production -k $AWS_KEY
Backend
Funcionalidades:
1. Gerar o context de acordo com o ambiente.
Aceita os seguintes parâmetros:
- --env: Qual o ambiente em questão.
- --dir: Qual o diretório de saída do context.
$ confirmafacil backend-context -e production -dir $PWD
2. Realizar o build da aplicação.
Aceita os seguintes parâmetros:
- --env: Qual o ambiente em questão.
- --project: Nome do projeto a ser buildado.
$ confirmafacil backend-build -e homologation -proj gko-ms-pcf-audit-remote
3. Gera ambiente SFTP para um cliente.
Aceita os seguintes parâmetros:
- --key: Local da chave privada da amazon.
- --client: Qual o cliente em questão.
$ confirmafacil backend-sftp -k $AWS_KEY --client baxter
$PWD significa o caminho atual aonde o script foi chamado
4. Realizar o deploy da aplicação.
Aceita os seguintes parâmetros:
- --key: Local da chave privada da amazon.
- --env: Qual o ambiente em questão.
- --project: Qual o projeto em questão.
$ confirmafacil backend-deploy -k $AWS_KEY --env homologation --project audit
$PWD significa o caminho atual aonde o script foi chamado
Exemplos
Definição de variável de ambiente da chave AWS (.pem)
Necessário para a maioria dos casos de uso do CLI. Cria uma variável de ambiente que aponta para a chave .pem da AWS.
export AWS_KEY=/home/usuario/app/servers/gko-virginia.pem
echo $AWS_KEY
--
Geração de ambiente SFTP para o cliente 'teste'
Loga na máquina de SFTP e executa o script de geração de ambiente SFTP passando como cliente o argumento 'teste'.
confirmafacil backend-sftp -k $AWS_KEY --client teste
--
Geração de context via mongoDB
Acessa a collection devops do mongoDB e busca todos os clientes de um context, de acordo com o ambiente especificado. Gera um context.xml com os dados em questão e copia para a pasta META-INF de cada projeto remote.
cf backend-context -env homologation --dir $PWD
--
Geração do war de um projeto
Realiza o Build do projeto especificado, resultando em um .war na pasta ~/app/wars. Importante esta pasta estar criada antes de execuar este comando.
cf backend-build -p gko-ms-pcf-audit-remote
ou
confirmafacil backend-build --project audit
O projeto pode ser:
- audit ou gko-ms-pcf-audit-remote
- eventos ou gko-ms-pcf-eventos-remote
- filtros ou gko-ms-pcf-filtros-remote
- loader ou gko-ms-pcf-loader-remote
- remote ou gko-ms-pcf-remote
--
Deploy do backend para homologação
Realizar o deploy do war do projeto remote localizado na pasta ~/app/wars para o servidor remoto de homologação do backend.
confirmafacil backend-deploy -k $AWS_KEY --env homologation --project remote
O projeto pode ser:
- audit ou gko-ms-pcf-audit-remote
- eventos ou gko-ms-pcf-eventos-remote
- filtros ou gko-ms-pcf-filtros-remote
- loader ou gko-ms-pcf-loader-remote
- remote ou gko-ms-pcf-remote
--