Implantar o Integration Service em um servidor local (on-prem)

Pré-requisitos

• Servidor executando um SO compatível com o Docker

  • A implantação foi testada em máquinas Windows

• Registro DNS e certificado SSL apropriado para o serviço web do Integration Service

• Project Access Token para baixar a imagem docker do repositório privado do Gitlab da Prevu3D com as seguintes permissões:

  • Read Registry

  • Developer Role

• Docker CLI instalado

• Docker-Desktop - Opcional

Nota

O Project Access Token é fornecido pela Prevu3D apenas sob demanda. Entre em contato com a nossa equipe para solicitar acesso.

Aviso

O procedimento de implantação está atualmente em beta e sujeito a alterações.

Etapas de implantação

1. Faça login no repositório de imagens docker do Gitlab com o Project Access Token fornecido.

   docker login registry.gitlab.com -u <ANY_USERNAME> -p <PROJECT_ACCESS_TOKEN>

2. Baixe a imagem docker de desenvolvimento do Integration Service.

   docker pull registry.gitlab.com/prevu3d/product/integration-service:develop

3. No host, crie uma pasta “Assets” e uma pasta “Config”. Essas pastas serão usadas como mount dentro do contêiner docker. A Assets conterá arquivos que podem ser exigidos pelas integrações, como JSON Schemas para a integração HTTP. A Config conterá o arquivo de configuração e garantirá que ele persista.

4. Inicie o contêiner com o docker CLI. Certifique-se de montar as pastas asset e config e de vincular a porta do integration service. O valor padrão é 3000.

   docker run registry.gitlab.com/prevu3d/product/integration-service:develop -v path\to\assets\folder\on\host:/usr/app/assets -v path\to\config\folder\on\host:/usr/app/config -p 3000:3000

   1. Estas variáveis de ambiente também estão disponíveis durante a fase de execução:

      1. PORT: Porta onde o Integration Service será vinculado, dentro do contêiner. O padrão é 3000.

      2. DEBUG_MODE: Defina como “1” para habilitar os logs de depuração.

      3. CONFIG_FILE: Nome e caminho do arquivo de configuração. O padrão é “/config/config.json”. Se o arquivo de configuração estiver hospedado no S3, o S3 URI deve ser fornecido (começa com s3://).

      4. CONFIG_FILE_TYPE: Tipo do arquivo de configuração. Defina como “s3” para usar um arquivo hospedado no AWS S3 ou local para um arquivo hospedado dentro do contêiner. O padrão é “local”.

5. Navegue até http://localhost:3000/health para confirmar que o integration service está em execução.

6. Configure uma entrada DNS para apontar para o integration service e adicione um certificado SSL para habilitar o tráfego HTTPS.

7. Siga as etapas para registrar o servidor de integração dentro da plataforma a fim de obter o assetServicePublicKey e copie-o dentro do arquivo config.json.