FOLIO

De BrapciWiki
Ir para navegação Ir para pesquisar

Documentação FOLIO

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.