API integração: mudanças entre as edições

De Wiki NBS
Ir para navegação Ir para pesquisar
(Criou página com '== Integração == Passo a passo Linux (criação e configuração do container Docker) 1- Fazer instalação do Docker correto para a versão da distribuição Linux instalada no servidor ----1.1- Instalar Docker enginer Docker enginer Debian 11: # <code>sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release -y</code> # <code>curl -fsSL <<nowiki>https://download.docker.com/linux/debian/gpg</nowiki>> | sudo gpg --dearmor -o /usr/share/keyrings/dock...')
 
Sem resumo de edição
 
(7 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
<!-------------------------------------------------------------->
<!-- BEGIN Voltar ao Topo - Este Código Abaixo Cria um Botão Voltar para o Topo. O Link da ancora deve ser o id da página onde colocarmos o código-->
<div class="noprint botao-voltar-topo" style="position: fixed;bottom: 15px;right: 15px;padding: 0;margin: 0;">
[[Arquivo:Seta-topo.png|link=#firstHeading|]]
</div>
<!-- END Voltar ao Topo-->
<!-------------------------------------------------------------->
'''Voltar para à''' [[Página principal]] > [[Sistema NBS - Plugins|Sistema Plugins]] > [[Soluções NBS - Plugins Mercado|Plugins Mercado]] > '''[[Plugin Autoarremate]] > API integração'''
== Integração ==
== Integração ==
Passo a passo Linux (criação e configuração do container Docker)
Passo a passo Linux (criação e configuração do container Docker)


1- Fazer instalação do Docker correto para a versão da distribuição Linux instalada no servidor
==== 1- Fazer instalação do Docker ====
----1.1- Instalar Docker enginer
Lembre de se atentar a instalação docker correta para a versão da distribuição Linux instalada no servidor
 
Docker enginer Debian 11:
# <code>sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release -y</code>
# <code>curl -fsSL <<nowiki>https://download.docker.com/linux/debian/gpg</nowiki>> | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg</code>
# <code>echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] <<nowiki>https://download.docker.com/linux/debian</nowiki>> \\</code>
# <code>(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null</code>
# <code>sudo apt update</code>
# <code>sudo apt -y install docker-ce docker-ce-cli containerd.io</code>
# <code>sudo docker version-——————————-0</code>
# <code>sudo systemctl status docker</code>
# <code>sudo systemctl start docker</code>
# <code>sudo docker run hello-world</code>
# <code>sudo usermod -aG docker linuxtechi - **Permitir que o usuário local execute o comando Docker**</code>
 
Docker enginer Debian 10:
# <code>sudo apt update</code>
# <code>sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common</code>
# <code>curl -fsSL <<nowiki>https://download.docker.com/linux/debian/gpg</nowiki>> | sudo apt-key add -</code>
# <code>sudo add-apt-repository "deb [arch=amd64] <<nowiki>https://download.docker.com/linux/debian</nowiki>> $(lsb_release -cs) stable"</code>
# <code>sudo apt update</code>
# <code>apt-cache policy docker-ce</code>
# <code>sudo apt install docker-ce</code>
# <code>sudo systemctl status docker</code>
 
Docker compose Debian 9:
# <code>sudo curl -L [<<nowiki>https://github.com/docker/compose/releases/download/1.22.0/docker-compose-</nowiki></code>uname>](<nowiki>https://github.com/docker/compose/releases/download/1.22.0/docker-compose-`uname</nowiki>) -suname -m <code>-o /usr/local/bin/docker-compose</code>
# <code>sudo chmod +x /usr/local/bin/docker-compose</code>
# <code>docker-compose --version</code>
----
----


1.2- Instalar Docker compose
==== 1.1- Instalar Docker enginer: ====
 
[[Docker enginer|Docker engine]]
Docker compose Debian 11:
# '''<code>sudo apt update</code>'''
# '''<code>sudo curl -L "<<nowiki>https://github.com/docker/compose/releases/download/v2.0.1/docker-compose-$</nowiki>>(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose</code>'''
# '''<code>sudo chmod +x /usr/local/bin/docker-compose</code>'''
# '''<code>docker-compose --version</code>'''
----
----


Docker compose Debian 10:
==== 1.2- Instalar Docker compose: ====
# <code>sudo curl -L [<<nowiki>https://github.com/docker/compose/releases/download/1.25.3/docker-compose-</nowiki></code>uname>](<nowiki>https://github.com/docker/compose/releases/download/1.25.3/docker-compose-`uname</nowiki>) -suname -m <code>-o /usr/local/bin/docker-compose</code>
[[Docker compose]]
# <code>sudo chmod +x /usr/local/bin/docker-compose</code>
# <code>docker-compose --version</code>
----
----
Docker compose Debian 9:
# <code>sudo apt update</code>
# <code>sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common</code>
# <code>curl -fsSL <<nowiki>https://download.docker.com/linux/debian/gpg</nowiki>> | sudo apt-key add -</code>
# <code>sudo add-apt-repository "deb [arch=amd64] <<nowiki>https://download.docker.com/linux/debian</nowiki>> $(lsb_release -cs) stable"</code>
# <code>sudo apt update</code>
# <code>apt-cache policy docker-ce</code>
# <code>sudo apt install docker-ce</code>
# <code>sudo systemctl status docker</code>
----
2-Criação de pasta para alojamento dos plugin's


==== 2-Criação de pasta para alojamento dos plugin's ====
2.1- Na pasta raiz do seu servidor, crie uma pasta que comportará seu plugin.
2.1- Na pasta raiz do seu servidor, crie uma pasta que comportará seu plugin.


Linha 69: Linha 32:
[[Arquivo:NBS-DockerProjects..png|150x150px]]
[[Arquivo:NBS-DockerProjects..png|150x150px]]


----3-Criação de pasta para criação do plugin.
----


==== 3-Criação de pasta para criação do plugin. ====
3.1- Dentro da pasta NBS-DockerProjects, criar pasta para comportar os arquivos de configuração do plugin.
3.1- Dentro da pasta NBS-DockerProjects, criar pasta para comportar os arquivos de configuração do plugin.


Linha 79: Linha 43:
[[Arquivo:AutoArremate.png]]
[[Arquivo:AutoArremate.png]]


----4-Criação e configuração do contêiner para execução da API
----


==== 4-Criação e configuração do contêiner para execução da API ====
4.1-Dentro da pasta AUTOARREMATE, criar arquivo vazio para comportar as configurações Docker do contêiner.
4.1-Dentro da pasta AUTOARREMATE, criar arquivo vazio para comportar as configurações Docker do contêiner.


Linha 89: Linha 54:
[[Arquivo:Docker-compose.yml .png]]
[[Arquivo:Docker-compose.yml .png]]


4.3-Realizar a configuração do arquivo/contêiner criado, conforme código e instruções contidas abaixo: (Nesta etapa, a posição dos espaços contidos no código não podem deferir do que está a seguir, recomendamos a cópia e posteriormente edição como instruído a seguir, tendo muito cuidado com tal critério.)
4.3- Configuração do docker-compose.yml: [[Docker-compose.yml AutoArremate|docker-compose.yml AutoArremate]]
 
----
version: '3.3'
 
services:
 
    kong-database:
 
        image: postgres:9.6
 
        container_name: kong-database-hml
 
        restart: always
 
        environment:
 
          - POSTGRES_USER=kong
 
          - POSTGRES_DB=kong
 
          - POSTGRES_PASSWORD=kong
 
        volumes:
 
          - "./volumes/teste-autoarremate/postgres/data:/var/lib/postgresql/data"
 
        networks:
 
            - autoarremate-network
 
    kong-migrations:
 
        image: kong
 
        environment:
 
          - KONG_DATABASE=postgres
 
          - KONG_PG_HOST=kong-database
 
          - KONG_PG_PASSWORD=kong
 
          - KONG_CASSANDRA_CONTACT_POINTS=kong-database
 
        command: kong migrations bootstrap
 
        restart: on-failure
 
        depends_on:
 
          - kong-database
 
        networks:
 
            - autoarremate-network
 
    kong:
 
        image: kong
 
        container_name: kong-hml
 
        environment:
 
          - KONG_DATABASE=postgres
 
          - KONG_PG_HOST=kong-database
 
          - KONG_PG_USER=kong
 
          - KONG_PG_PASSWORD=kong
 
          - KONG_CASSANDRA_CONTACT_POINTS=kong-database
 
          - KONG_PROXY_ACCESS_LOG=/dev/stdout
 
          - KONG_ADMIN_ACCESS_LOG=/dev/stdout
 
          - KONG_PROXY_ERROR_LOG=/dev/stderr
 
          - KONG_ADMIN_ERROR_LOG=/dev/stderr
 
          - KONG_ADMIN_LISTEN=0.0.0.0:8001, 0.0.0.0:8444 ssl
 
        restart: on-failure
 
        ports:
 
          - 9093:8000
 
          - 2998:8001
 
        depends_on:
 
          - kong-migrations
 
        volumes:
 
          - "./volumes/teste-autoarremate/kong/data:/home/kong"
 
        networks:
 
          - autoarremate-network
 
    konga:
 
        image: pantsel/konga
 
        ports:
 
          - 1339:1337
 
        container_name: konga-hml
 
        environment:
 
          - NODE_ENV=production
 
        depends_on:
 
          - kong
 
        volumes:
 
          - "./volumes/teste-autoarremate/konga/data:/app/kongadata"
 
        networks:
 
          - autoarremate-network
 
    plugin-nbs-infra:
 
        image: ('''CONSULTAR NBS PARA OBTER IMAGEM ATUALIZADA''')
 
        depends_on:
 
            - konga
 
        restart: always
 
        logging:
 
            options:
 
                max-size: "5m"
 
        env_file:
 
            pools.env
 
        environment:


            - SERVER_SERVLET_CONTEXT_PATH=/nbs-infra
==== 5-Criação e configuração do contêiner para execução da API ====
 
5.1-Dentro da pasta AUTOARREMATE, criar arquivo vazio para comportar as configurações Docker do contêiner.
            - container_name=plugin-nbs-infra
 
            - gateway_url=<nowiki>http://kong:8001</nowiki>
 
            - server_url=<nowiki>http://200.179.98.136:9098/nbs-infra</nowiki>
 
        volumes:
 
            - "./volumes/plugin-nbs-infra/data:/files"
 
        networks:
 
          - autoarremate-network
 
    plugin-autoarremate:
 
        container_name: plugin-autoarremate
 
        image:  ('''CONSULTAR NBS PARA OBTER IMAGEM ATUALIZADA''')
 
        restart: always
 
        logging:
 
            options:
 
                max-size: "5m"
 
        env_file:
 
            pools.env
 
        environment:
 
            - container_name=plugin-autoarremate
 
            - ARTIFACT_NAME=plugin-autoarremate
 
            - SERVER_SERVLET_CONTEXT_PATH=/autoarremate
 
            - gateway_url=<nowiki>http://kong:8001</nowiki>
 
        volumes:
 
            - "./volumes/cometa/:/files/"
 
        networks:
 
            - autoarremate-network
 
networks:
 
    autoarremate-network:
 
         driver: bridge
----4-Criação e configuração do contêiner para execução da API  
 
4.1-Dentro da pasta AUTOARREMATE, criar arquivo vazio para comportar as configurações Docker do contêiner.


comando: touch docker-compose.yml
comando: touch docker-compose.yml


4.2-Imagem de como deve ficar a nomenclatura do arquivo/contêiner:
5.2-Imagem de como deve ficar a nomenclatura do arquivo/contêiner:


[[Arquivo:Pools.env.png]]
[[Arquivo:Pools.env.png]]


4.3-Realizar a configuração do arquivo/contêiner criado, conforme código e instruções contidas abaixo: (Nesta etapa, a posição dos espaços contidos no código não podem deferir do que está a seguir, recomendamos a cópia e posteriormente edição como instruído a seguir, tendo muito cuidado com tal critério.)
5.3-Configuração do pools.env: [[pools.env]]


ORACLE_SCHEMA=NBSGM                                                                          (Adicionar schema do banco de dados)
----
 
ORACLE_SERVICE_NAME=nbs1                                                                  (Adicionar service name do banco de dados )
 
ORACLE_PORT=1521                                                                                    (Adicionar porta do banco de dados)
 
ORACLE_HOST=100.0.65.225                                                                        (adicionar IP Host do linux que esta rodando a aplicação)
 
ORACLE_PASSWORD=new                                                                            (senha do banco de dados)
 
ORACLE_USER=NBSGM                                                                                (usuário do banco de dados)
 
cadastro_url=                                                                                                    (Deixar em branco)
 
contabilFiscal_url=                                                                                            (Deixar em branco)
 
estoquePecas_url=                                                                                          (Deixar em branco)
 
notaFiscal_url=                                                                                                (Deixar em branco)
 
service_url=                                                                                                      (Deixar em branco)
 
parts_url=                                                                                                        (Deixar em branco)
 
vehicle_url=                                                                                                      (Deixar em branco)
 
financeiro_url=                                                                                                  (Deixar em branco)
 
gateway_url=                                                                                                    (Deixar em branco)
 
server_url=                                                                                                        (Deixar em branco)
 
nbs_datasources=                                                                                            (Deixar em branco)
 
----5-Conferência


5.1-Para realizar a conferência se os contêineres estão sendo executados, deve-se conferir os status do docker
==== 6-Conferência ====
6.1-Para realizar a conferência se os contêineres estão sendo executados, deve-se conferir os status do docker


5.2.1-Comando: docker stats  
6.2.1-Comando: docker stats  


5.2.2- Os containers que devem ser obtidos após realizar o comando, devem ser os seguintes:
6.2.2- Os containers que devem ser obtidos após realizar o comando, devem ser os seguintes:


-kong-database-hml
-kong-database-hml
Linha 361: Linha 86:


-plugin-autoarremate
-plugin-autoarremate
----'''Voltar para à''' [[Página principal]] > [[Sistema NBS - Plugins|Sistema Plugins]] > [[Soluções NBS - Plugins Mercado|Plugins Mercado]] >  '''[[Plugin Autoarremate]] > API integração'''

Edição atual tal como às 20h41min de 11 de julho de 2023

Seta-topo.png

Voltar para à Página principal > Sistema Plugins > Plugins Mercado > Plugin Autoarremate > API integração

Integração

Passo a passo Linux (criação e configuração do container Docker)

1- Fazer instalação do Docker

Lembre de se atentar a instalação docker correta para a versão da distribuição Linux instalada no servidor


1.1- Instalar Docker enginer:

Docker engine


1.2- Instalar Docker compose:

Docker compose


2-Criação de pasta para alojamento dos plugin's

2.1- Na pasta raiz do seu servidor, crie uma pasta que comportará seu plugin.

comando: mkdir NBS-DockerProjects.

2.2-Imagem de como deve ficar a nomenclatura da pasta:

NBS-DockerProjects..png


3-Criação de pasta para criação do plugin.

3.1- Dentro da pasta NBS-DockerProjects, criar pasta para comportar os arquivos de configuração do plugin.

comando: mkdir AUTOARREMATE.

3.2-Imagem de como deve ficar a nomenclatura da pasta:

AutoArremate.png


4-Criação e configuração do contêiner para execução da API

4.1-Dentro da pasta AUTOARREMATE, criar arquivo vazio para comportar as configurações Docker do contêiner.

comando: touch docker-compose.yml

4.2-Imagem de como deve ficar a nomenclatura do arquivo/contêiner:

Docker-compose.yml .png

4.3- Configuração do docker-compose.yml: docker-compose.yml AutoArremate


5-Criação e configuração do contêiner para execução da API

5.1-Dentro da pasta AUTOARREMATE, criar arquivo vazio para comportar as configurações Docker do contêiner.

comando: touch docker-compose.yml

5.2-Imagem de como deve ficar a nomenclatura do arquivo/contêiner:

Pools.env.png

5.3-Configuração do pools.env: pools.env


6-Conferência

6.1-Para realizar a conferência se os contêineres estão sendo executados, deve-se conferir os status do docker

6.2.1-Comando: docker stats

6.2.2- Os containers que devem ser obtidos após realizar o comando, devem ser os seguintes:

-kong-database-hml

-kong-hml

-konga-hml

-autoarremate_plugin-nbs-infra

-plugin-autoarremate


Voltar para à Página principal > Sistema Plugins > Plugins Mercado > Plugin Autoarremate > API integração