Desplegar el servicio de integración en un servidor on-premise

Requisitos previos

• Servidor que ejecuta un SO compatible con Docker

  • El despliegue se probó en máquinas Windows

• Registro DNS y certificado SSL apropiado para el servicio web del servicio de integración

• Project Access Token para extraer la imagen de docker del repositorio privado de Gitlab de Prevu3d con los siguientes permisos:

  • Read Registry

  • Rol de Developer

• Docker CLI instalado

• Docker-Desktop - Opcional

Nota

El Project Access Token lo proporciona Prevu3D solo bajo demanda. Ponte en contacto con nuestro equipo para solicitar acceso.

Advertencia

El procedimiento de despliegue está actualmente en beta y sujeto a cambios.

Pasos de despliegue

1. Inicia sesión en el repositorio de imágenes de docker de Gitlab con el Project Access Token proporcionado.

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

2. Extrae la imagen de docker del servicio de integración de desarrollo.

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

3. En el host, crea una carpeta “Assets” y una carpeta “Config”. Estas carpetas se usarán como montaje dentro del contenedor de docker. Assets contendrá los archivos que puedan ser requeridos por las integraciones, como los JSON Schemas para la integración HTTP. Config contendrá el archivo de configuración y garantizará que persista.

4. Inicia el contenedor con la CLI de docker. Asegúrate de montar las carpetas asset y config y de vincular el puerto del servicio de integración. El valor predeterminado es 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 variables de entorno también están disponibles durante la fase de ejecución:

      1. PORT: puerto donde se vinculará el servicio de integración, dentro del contenedor. El valor predeterminado es 3000.

      2. DEBUG_MODE: establece en “1” para habilitar los registros de depuración.

      3. CONFIG_FILE: nombre y ruta del archivo de configuración. El valor predeterminado es “/config/config.json”. Si el archivo de configuración está alojado en S3, se debe proporcionar la URI de S3 (empieza por s3://).

      4. CONFIG_FILE_TYPE: tipo del archivo de configuración. Establece en “s3” para usar un archivo alojado en AWS S3 o local para un archivo alojado dentro del contenedor. El valor predeterminado es “local”.

5. Ve a http://localhost:3000/health para confirmar que el servicio de integración se está ejecutando.

6. Configura una entrada DNS para que apunte al servicio de integración y añade un certificado SSL para habilitar el tráfico HTTPS.

7. Sigue los pasos para registrar el servidor de integración dentro de la plataforma con el fin de obtener la assetServicePublicKey y cópiala dentro del archivo config.json.