Mudanças entre as edições de "INSTALACAO VRFICHA API"
De VRWiki
(Criou página com '==<b>REQUISITOS MÍNIMOS</b>== Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior: * VR...') |
(→INSTALAÇÃO) |
||
| (32 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 ( | + | * 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. |
| + | * 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. | ||
| + | * No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente) | ||
| + | <pre> | ||
| + | services: | ||
| + | vrficha-api: | ||
| + | image: vrsoftbr/vrfichaapi:4.1.10 | ||
| + | ports: | ||
| + | - "9015:9015" | ||
| + | environment: | ||
| + | - TZ=GMT-3 | ||
| + | - PORT=9015 | ||
| + | - DATABASE_IP= | ||
| + | - DATABASE_PORTA= | ||
| + | - DATABASE_NOME= | ||
| + | - DATABASE_USUARIO= | ||
| + | - DATABASE_SENHA= | ||
| + | - SYSTEM_NUMEROLOJA= | ||
| + | - RABBITMQ_IP= | ||
| + | - RABBITMQ_PORTA= | ||
| + | - RABBITMQ_USUARIO= | ||
| + | - RABBITMQ_SENHA= | ||
| + | networks: | ||
| + | - vr-network | ||
| + | |||
| + | networks: | ||
| + | vr-network: | ||
| + | external: true | ||
| + | </pre> | ||
| + | * Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker. | ||
| + | * 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, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]] | ||
Edição atual tal como às 13h05min de 8 de dezembro 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.
- No arquivo docker-compose-vrfichaapi.yml é configurado a porta de comunicação com a API, a conexão com o banco de dados e a conexão com o RabbitMQ. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)
services: vrficha-api: image: vrsoftbr/vrfichaapi:4.1.10 ports: - "9015:9015" environment: - TZ=GMT-3 - PORT=9015 - DATABASE_IP= - DATABASE_PORTA= - DATABASE_NOME= - DATABASE_USUARIO= - DATABASE_SENHA= - SYSTEM_NUMEROLOJA= - RABBITMQ_IP= - RABBITMQ_PORTA= - RABBITMQ_USUARIO= - RABBITMQ_SENHA= networks: - vr-network networks: vr-network: external: true
- Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. Não é mais utilizado vr.properties. A configuração é feita diretamente no arquivo de compose do docker.
- 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, é necessário que o VRFichaMobileImpressao esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo clicando aqui
