콘텐츠로 이동
Prevu3D

온프레미스 서버에 Integration Service 배포

사전 요구 사항

섹션 제목: “사전 요구 사항”

  • Docker와 호환되는 OS를 실행하는 서버

    • 배포는 Windows 머신에서 테스트되었습니다

  • Integration Service 웹 서비스를 위한 DNS 레코드 및 적절한 SSL 인증서

  • Prevu3D의 비공개 Gitlab 저장소에서 docker 이미지를 가져오기 위한 Project Access Token으로, 다음 권한이 필요합니다:

    • Read Registry

    • Developer Role

  • Docker CLI 설치됨

  • Docker-Desktop - 선택 사항

배포 단계

섹션 제목: “배포 단계”

  1. 제공된 Project Access Token으로 Gitlab docker 이미지 저장소에 로그인합니다.

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

  2. 개발용 Integration Service docker 이미지를 가져옵니다.

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

  3. 호스트에서 “Assets” 폴더와 “Config” 폴더를 만듭니다. 이 폴더들은 docker 컨테이너 내에서 마운트로 사용됩니다. Assets에는 HTTP Integration을 위한 JSON Schema 등 연동에 필요할 수 있는 파일이 포함됩니다. Config에는 구성 파일이 포함되며 이 파일이 유지되도록 보장합니다.

  4. docker CLI로 컨테이너를 시작합니다. asset 및 config 폴더를 마운트하고 integration service의 포트를 바인딩해야 합니다. 기본값은 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. 실행 단계에서 다음 환경 변수도 사용할 수 있습니다:

      1. PORT : 컨테이너 내부에서 Integration Service가 바인딩될 포트. 기본값은 3000입니다.

      2. DEBUG_MODE : 디버그 로그를 활성화하려면 “1”로 설정합니다.

      3. CONFIG_FILE : 구성 파일의 이름과 경로. 기본값은 “/config/config.json”입니다. 구성 파일이 S3에 호스팅되어 있는 경우, S3 URI를 제공해야 합니다(s3://로 시작).

      4. CONFIG_FILE_TYPE : 구성 파일의 유형. AWS S3에 호스팅된 파일을 사용하려면 “s3”로, 컨테이너 내에 호스팅된 파일의 경우 local로 설정합니다. 기본값은 “local”입니다.

  5. integration service가 실행 중인지 확인하려면 http://localhost:3000/health로 이동합니다.

  6. integration service를 가리키도록 DNS 항목을 구성하고 HTTPS 트래픽을 활성화하도록 SSL 인증서를 추가합니다.

  7. 플랫폼 내에서 integration server를 등록하는 단계를 따라 assetServicePublicKey를 얻고 config.json 파일 안에 복사합니다.