고객사 설치 / 패치 작업 흐름

작업자가 따라야 할 순서와 각 단계의 의미만 간단히 정리한 화면입니다.

신규 설치 패치 기동

1. 신규 설치

전체 설치본을 풀어서 새 서버에 uface 실행 환경을 구성합니다.
1

설치본 전달

고객사 서버에 full 패키지 파일을 전달합니다.

2

압축 해제

uface/ 폴더가 생성됩니다.

3

install_env 실행

환경 등록, 경로 맞춤, 파일 검증을 한 번에 수행합니다.

4

TR engine 생성

TensorRT만 수행합니다. OpenVINO는 생략합니다.

5

기동/확인

ezload, ezstart 후 로그를 확인합니다.

설치본 생성 입력(택1)

CI/CD > Pipelines > Run pipeline
PACKAGE_TYPE=full
PACKAGE_TAG=tr_202606   # TensorRT
PACKAGE_TAG=ov_202606   # OpenVINO

결과: GitLab Job artifacts

TensorRT 설치 명령

tar -xzf uface-v2-tr_202606-full.tar.gz
cd uface
sh scripts/install_env.sh
. ~/.bashrc
sh scripts/build_engine.sh
sh scripts/start.sh

OpenVINO 설치 명령

tar -xzf uface-v2-ov_202606-full.tar.gz
cd uface
sh scripts/install_env.sh
. ~/.bashrc
sh scripts/start.sh

2. 패치

기존 설치본은 유지하고, 바뀐 파일만 반영합니다.
1

패치본 전달

기준 버전에서 목표 버전으로 가는 patch 파일을 전달합니다.

2

압축 해제

uface-patch/ 폴더가 생성됩니다.

3

patch.sh 실행

버전 확인, 백업, 삭제/변경 파일 반영을 자동 처리합니다.

4

TR engine 재생성

ONNX가 바뀐 TensorRT 패치에서만 수행합니다.

5

재기동/확인

stop/start 후 로그를 확인합니다.

패치본 생성 입력

CI/CD > Pipelines > Run pipeline
PACKAGE_TYPE=patch
PATCH_BASE_TAG=tr_202604
PACKAGE_TAG=tr_202606

결과: GitLab Job artifacts

패치 적용 명령

tar -xzf uface-v2-tr_202604-to-tr_202606-patch.tar.gz
cd uface-patch
sh patch.sh /path/to/uface

패치 후 확인/재기동

cd /path/to/uface
. ~/.bashrc
sh scripts/build_engine.sh   # TensorRT ONNX 변경 시
sh scripts/stop.sh
sh scripts/start.sh