JarCastingUnha-de-gato
A Unha-de-gato foi DESCONTINUADA em prol da otimização da comunicação entre Copaíbas e Uxi-amarelo. A Copaíba tem adotado práticas de assincronicidade e outros modernos recursos que fogem do escopo da Unha-de-gato. Talvez, futuramente, a Unha-de-gato seja retomada com foco em sistemas distribuídos, tendo como núcleo a própria Copaíba.
The Unha-de-gato was DESCONTINUATED in favor of the optimization of communication between Copaíbas and Uxi-amarelo. Copaíba has adopted practices of asynchronicity and other modern resources that escape the scope of the Unha-de-gato. Perhaps, in the future, the Unha-de-gato will be resumed with a focus on distributed systems, with Copaíba as its core.
Descrição
A Unha-de-gato é uma aplicação que faz a intermediação na comunicação com Copaíbas, mantendo pools de conexões.
A figura a seguir ilustra o esquema geral da arquitetura da Unha-de-gato:
Versão Atual
1.0-A16
Padrão de versionamento: JFV
Instalação do Servidor Unha-de-gato no Docker
Seguem-se as instruções para instalar e executar a Unha-de-gato num container Docker. Os argumentos de cada comando precisam ser revisados e especificados conforme o ambiente de execução.
Baixar e compilar:
wget https://github.com/joseflaviojr/unhadegato/archive/1.0-A16.zip
unzip 1.0-A16.zip
cd unhadegato-1.0-A16
gradle dist
Criar imagem:
docker build --force-rm -t joseflavio/unhadegato:1.0-A16 .
Criar volume de dados:
docker volume create --name unhadegato
Executar pela primeira vez:
docker run --name="unhadegato" -d -p 8885:8885 -p 8886:8886 -e TZ=America/Belem -v unhadegato:/volume --ip=x.x.x.x --net xxxxxx --restart=unless-stopped joseflavio/unhadegato:1.0-A16
A Unha-de-gato será inicializada automaticamente no processo de boot, a não ser que seja voluntariamente parada:
docker stop unhadegato.
Configurar:
cd /var/lib/docker/volumes/unhadegato/_data/conf
Algumas configurações exigem a reinicialização da aplicação:
docker restart unhadegato.
Verificar arquivos de log:
docker logs --tail 50 -f unhadegato
tail /var/lib/docker/volumes/unhadegato/_data/logs/unhadegato.log -n 100
Requisitos para Instalação
- Docker >= 17.06
- Git >= 2.8
- Java >= 1.8
- Gradle >= 4.7
Desinstalação
Desinstalar a Unha-de-gato por completo:
docker rm -f unhadegato
docker rmi joseflavio/unhadegato:1.0-A16
Execução Local e Temporária
Baixar e compilar:
wget https://github.com/joseflaviojr/unhadegato/archive/1.0-A16.zip
unzip 1.0-A16.zip
cd unhadegato-1.0-A16
gradle dist
Executar:
cd build/dist
./unhadegato.sh
Os requisitos são os mesmos da instalação padrão, com exceção do Docker.
Como Usar no Lado do Cliente
A Unha-de-gato está disponível como biblioteca Java no repositório Maven.
Gradle:
compile 'com.joseflavio:unhadegato:1.0-A16'
Maven:
<dependency>
<groupId>com.joseflavio</groupId>
<artifactId>unhadegato</artifactId>
<version>1.0-A16</version>
</dependency>
Requisitos para uso como cliente
- Java >= 1.8
Documentação
A documentação da Unha-de-gato, no formato Javadoc, está disponível em:
http://joseflavio.com/unhadegato/javadoc
Desenvolvimento
Configuração do projeto para Eclipse e IntelliJ IDEA:
gradle eclipse
gradle cleanIdea idea
Requisitos para desenvolvimento
- Git >= 2.8
- Java >= 1.8
- Gradle >= 4.7
Compilação
Para compilar o projeto, gerando os arquivos JAR, executar no terminal:
gradle clean build
Publicação
Para compilar e publicar os arquivos finais do projeto no repositório Maven, executar no terminal:
gradle clean uploadArchives
Licença
Português
Direitos Autorais Reservados © 2016-2018 José Flávio de Souza Dias Júnior
Este arquivo é parte de Unha-de-gato - http://joseflavio.com/unhadegato.
Unha-de-gato é software livre: você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Menos Geral GNU conforme publicada pela Free Software Foundation, tanto a versão 3 da Licença, como (a seu critério) qualquer versão posterior.
Unha-de-gato é distribuído na expectativa de que seja útil, porém, SEM NENHUMA GARANTIA; nem mesmo a garantia implícita de COMERCIABILIDADE ou ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA. Consulte a Licença Pública Menos Geral do GNU para mais detalhes.
Você deve ter recebido uma cópia da Licença Pública Menos Geral do GNU junto com Unha-de-gato. Se não, veja https://www.gnu.org/licenses/lgpl.html.
English
Copyright © 2016-2018 José Flávio de Souza Dias Júnior
This file is part of Unha-de-gato - http://joseflavio.com/unhadegato.
Unha-de-gato is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Unha-de-gato is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with Unha-de-gato. If not, see https://www.gnu.org/licenses/lgpl.html.