Mudanças entre as edições de "FOLIO"
(Criou página com ' ==Instalação do FOLIO== A última versão do código fonte está disponível no [https://github.com/folio-org/okapi GitHub]. Os requisitos para instação são: * Apache...') |
|||
| (3 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 1: | Linha 1: | ||
| − | + | [https://github.com/folio-org/okapi/blob/master/doc/guide.md Documentação FOLIO] | |
==Instalação do FOLIO== | ==Instalação do FOLIO== | ||
| Linha 20: | Linha 20: | ||
mvn install -DskipTests | mvn install -DskipTests | ||
| + | ===Módulos FOLIO=== | ||
O diretório okapi contém alguns submódulos. Estes são: | O diretório okapi contém alguns submódulos. Estes são: | ||
*okapi-core -- O próprio servidor gateway. | *okapi-core -- O próprio servidor gateway. | ||
| Linha 27: | Linha 28: | ||
*okapi-test-module -- Um módulo que altera o conteúdo HTTP para fins de teste. | *okapi-test-module -- Um módulo que altera o conteúdo HTTP para fins de teste. | ||
*okapi-test-header-module -- Um módulo para testar o modo somente cabeçalhos. | *okapi-test-header-module -- Um módulo para testar o modo somente cabeçalhos. | ||
| + | |||
| + | (Observe a ordem de construção especificada no pom.xml: okapi-core deve ser o último porque seus testes dependem dos anteriores.) | ||
| + | |||
| + | O resultado para cada módulo e núcleo okapi é um arquivo jar combinado com todos os componentes necessários combinados, incluindo Vert.x. A porta de escuta é ajustada com a propriedade http.port ou port. | ||
| + | |||
| + | Por exemplo, para executar o módulo okapi-test-auth-module e escutar na porta 8600, use: | ||
| + | cd okapi-test-auth-module | ||
| + | java -Dhttp.port=8600 -jar target/okapi-test-auth-module-fat.jar | ||
| + | |||
| + | Existem outros comandos disponíveis. Forneça ajuda para obter uma descrição deles. | ||
| + | |||
| + | Uma regra Maven para executar o gateway é fornecida como parte do pom.xml, no diretório principal. | ||
| + | mvnexec:exec | ||
| + | |||
| + | Isso iniciará o okapi-core e fará com que ele escute em sua porta padrão: 9130. | ||
| + | |||
| + | Para depuração remota você pode usar | ||
| + | mvn exec:exec@depurar | ||
| + | |||
| + | ===PostGreSQL=== | ||
| + | sudo -u postgres -i | ||
| + | createuser -P okapi # When it asks for a password, enter okapi25 | ||
| + | createdb -O okapi okapi | ||
| + | |||
| + | |||
| + | Este comando requer Maven >= 3.3.1. Ele escutará um cliente de depuração na porta 5005. | ||
Edição atual tal como às 09h57min de 13 de dezembro de 2023
Instalação do FOLIO
A última versão do código fonte está disponível no GitHub.
Os requisitos para instação são:
- Apache Maven 3.3.1 or later.
- Java 8 JDK
- Git 2
Deve-se criar um usuário em todo desenvolvimento e na instalação, sugestão user: folio
git clone --recursive https://github.com/folio-org/okapi.git cd okapi mvn install
A regra de instalação também executa testes. Os testes não devem falhar. Se o fizerem, por favor denuncie e, enquanto isso, volte para:
mvn install -DskipTests
Módulos FOLIO
O diretório okapi contém alguns submódulos. Estes são:
- okapi-core -- O próprio servidor gateway.
- okapi-common -- Utilitários usados tanto pelo gateway quanto pelos módulos.
- doc -- Documentação, incluindo este guia.
- okapi-test-auth-module -- Um módulo simples para testar itens de autenticação.
- okapi-test-module -- Um módulo que altera o conteúdo HTTP para fins de teste.
- okapi-test-header-module -- Um módulo para testar o modo somente cabeçalhos.
(Observe a ordem de construção especificada no pom.xml: okapi-core deve ser o último porque seus testes dependem dos anteriores.)
O resultado para cada módulo e núcleo okapi é um arquivo jar combinado com todos os componentes necessários combinados, incluindo Vert.x. A porta de escuta é ajustada com a propriedade http.port ou port.
Por exemplo, para executar o módulo okapi-test-auth-module e escutar na porta 8600, use:
cd okapi-test-auth-module java -Dhttp.port=8600 -jar target/okapi-test-auth-module-fat.jar
Existem outros comandos disponíveis. Forneça ajuda para obter uma descrição deles.
Uma regra Maven para executar o gateway é fornecida como parte do pom.xml, no diretório principal.
mvnexec:exec
Isso iniciará o okapi-core e fará com que ele escute em sua porta padrão: 9130.
Para depuração remota você pode usar
mvn exec:exec@depurar
PostGreSQL
sudo -u postgres -i createuser -P okapi # When it asks for a password, enter okapi25 createdb -O okapi okapi
Este comando requer Maven >= 3.3.1. Ele escutará um cliente de depuração na porta 5005.
