Mudanças entre as edições de "INSTALACAO VRFICHA API"

De VRWiki
(IMPORTANTE)
 
(16 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 2: Linha 2:
 
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:
 
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:
  
* VRUbuntu 20.04.0-1 (Também compatível com Windows e MacOS)
+
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)
 
* Processador: i3 (5ª geração +) ou equivalente
 
* Processador: i3 (5ª geração +) ou equivalente
 
* Memória RAM: 8 GB
 
* Memória RAM: 8 GB
 
* Disco: 80 GB
 
* Disco: 80 GB
 +
* Docker instalado
  
 
==<b>INSTALAÇÃO</b>==
 
==<b>INSTALAÇÃO</b>==
* '''<span style="color:red;">Certifique-se de as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''
+
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''
* Faça o download do arquivo docker-compose-vrfichaapi.yml [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml aqui]
+
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.
* Certifique-se de o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o banco de dados e RabbitMQ (Linux: /vr | Windows: C:/vr)
+
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]
 +
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.
 +
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o banco de dados e RabbitMQ (Diretório: <b>/vr</b>)
 
<b>vr.properties</b>
 
<b>vr.properties</b>
 
<pre>
 
<pre>
Linha 22: Linha 25:
  
 
[VRRABBITMQ]
 
[VRRABBITMQ]
pring.rabbitmq.host=[IP do Host]
+
spring.rabbitmq.host=[IP do Host]
 
spring.rabbitmq.port=5672
 
spring.rabbitmq.port=5672
 
spring.rabbitmq.username=vr
 
spring.rabbitmq.username=vr
 
spring.rabbitmq.password=vr!RbtMQ
 
spring.rabbitmq.password=vr!RbtMQ
 
</pre>
 
</pre>
* No arquivo docker-compose-vrfichaapi.yml é configurado a porta de comunicação com a API
+
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a porta de comunicação com a API
 
<pre>
 
<pre>
 
services:
 
services:
Linha 47: Linha 50:
 
</pre>
 
</pre>
 
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i>
 
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i>
 +
 +
==<b>INICIALIZAÇÃO</b>==
 +
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)
 +
<pre style="color: silver; background: black;">
 +
docker compose -f docker-compose-vrfichaapi.yml up -d
 +
</pre>
 +
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b>
 +
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também
 +
<pre style="color: silver; background: black;">
 +
docker compose -f docker-compose-rabbitmq.yml up -d
 +
</pre>
 +
 +
==<b>IMPRESSÃO DAS FICHAS</b>==
 +
* Para realizar a impressão das fichas, o <b>VRFichaMobileImpressao</b> ainda é necessário estar executando no servidor, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha.

Edição atual tal como às 12h48min de 4 de fevereiro de 2025

REQUISITOS MÍNIMOS

Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:

  • VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)
  • Processador: i3 (5ª geração +) ou equivalente
  • Memória RAM: 8 GB
  • Disco: 80 GB
  • Docker instalado

INSTALAÇÃO

  • Certifique-se de que as configurações do VR Ubuntu foram todas executadas neste link
  • Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.
  • Faça o download do arquivo docker-compose-vrfichaapi.yml clicando aqui
  • Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo docker-compose-rabbitmq.yml clicando aqui para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.
  • Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o banco de dados e RabbitMQ (Diretório: /vr)

vr.properties

[CONEXÃO BANCO]
database.ip=
database.porta=
database.nome=
database.usuario=
database.senha=
system.numeroloja=

[VRRABBITMQ]
spring.rabbitmq.host=[IP do Host]
spring.rabbitmq.port=5672
spring.rabbitmq.username=vr
spring.rabbitmq.password=vr!RbtMQ
  • No arquivo docker-compose-vrfichaapi.yml é configurado a porta de comunicação com a API
services:
  vrficha-api:
    image: vrsoftbr/vrfichaapi:4.1.7-2
    ports:
      - "9015:9015"
    environment:
      - TZ=GMT-3
      - PORT=9015
    volumes:
      - /vr/vr.properties:/vr/vr.properties
    networks:
      - vr-network

networks:
  vr-network:
    external: true
  • Caso seja necessário alterar a porta, alterar em environment o valor de PORT, e também alterar as portas em ports

INICIALIZAÇÃO

  • Para iniciar a API, basta executar este comando, passando na flag -f o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)
docker compose -f docker-compose-vrfichaapi.yml up -d

Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais

  • Caso seja necessário subir o RabbitMQ, executar o docker compose no arquivo do RabbitMQ também
docker compose -f docker-compose-rabbitmq.yml up -d

IMPRESSÃO DAS FICHAS

  • Para realizar a impressão das fichas, o VRFichaMobileImpressao ainda é necessário estar executando no servidor, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha.