#설치 방법

현재 버전은 백업 및 복원 형식으로 배포됩니다. 향후 버전에서는 솔루션을 기존 시스템에 더 쉽게 통합할 수 있도록 증분 마이그레이션 형식으로 변경될 수 있습니다.

귀하의 NocoBase 환경에 워크오더 솔루션을 빠르고 원활하게 배포할 수 있도록 두 가지 복원 방식을 제공합니다. 사용자 버전과 기술적 배경에 따라 가장 적합한 방식을 선택해 주세요.

시작하기 전에 다음 사항을 확인하십시오:

• 이미 기초적인 NocoBase 실행 환경을 갖추고 있어야 합니다. 메인 시스템 설치에 대해서는 상세한 공식 설치 문서를 참고하십시오.
• NocoBase 버전 2.0.0-beta.5 이상
• 워크오더 시스템의 해당 파일을 이미 다운로드했습니다:
  • 백업 파일: nocobase_tts_v2_backup_260302.nbdata - 방법 1에 적용
  • SQL 파일: nocobase_tts_v2_sql_260302.zip - 방법 2에 적용

중요 설명:

• 본 솔루션은 PostgreSQL 16 데이터베이스를 기반으로 제작되었습니다. 귀하의 환경에서 PostgreSQL 16을 사용 중인지 확인하십시오.
• DB_UNDERSCORED는 true일 수 없습니다: docker-compose.yml 파일을 확인하여 DB_UNDERSCORED 환경 변수가 true로 설정되지 않았는지 확인하십시오. 그렇지 않으면 솔루션 백업과 충돌하여 복원에 실패할 수 있습니다.

#방법 1: 백업 관리자를 사용하여 복원 (전문가/기업용 버전 사용자 권장)

이 방식은 NocoBase에 내장된 "백업 관리자"(전문가/기업용 버전) 플러그인을 통해 클릭 한 번으로 복원하며, 조작이 가장 간단합니다. 하지만 환경과 사용자 버전에 대한 일정 요구 사항이 있습니다.

#핵심 특징

• 장점:
  1. 편리한 조작: UI 화면에서 완료할 수 있으며, 플러그인을 포함한 모든 설정을 완전하게 복원할 수 있습니다.
  2. 완전한 복원: 템플릿 인쇄 파일, 테이블 내 파일 필드에 업로드된 파일 등을 포함한 모든 시스템 파일을 복원할 수 있어 기능의 완전성을 보장합니다.
• 국한:
  1. 전문가/기업용 버전 한정: "백업 관리자"는 기업급 플러그인으로, 전문가/기업용 버전 사용자만 사용할 수 있습니다.
  2. 엄격한 환경 요구 사항: 귀하의 데이터베이스 환경(버전, 대소문자 구분 설정 등)이 백업 제작 당시의 환경과 고도로 호환되어야 합니다.
  3. 플러그인 의존성: 솔루션에 로컬 환경에 없는 상용 플러그인이 포함되어 있으면 복원에 실패합니다.

#조작 단계

1단계: 【강력 권장】 full 이미지를 사용하여 애플리케이션 시작

데이터베이스 클라이언트 부재로 인한 복원 실패를 방지하기 위해 full 버전의 Docker 이미지를 사용하실 것을 강력히 권장합니다. 모든 필수 보조 프로그램이 내장되어 있어 추가 설정이 필요 없습니다.

이미지 풀(pull) 명령 예시:

docker pull nocobase/nocobase:beta-full

그 다음 이 이미지를 사용하여 NocoBase 서비스를 시작합니다.

참고: full 이미지를 사용하지 않을 경우, 컨테이너 내에 pg_dump 데이터베이스 클라이언트를 수동으로 설치해야 할 수 있으며, 이 과정은 번거롭고 불안정합니다.

2단계: "백업 관리자" 플러그인 활성화

1. NocoBase 시스템에 로그인합니다.
2. **플러그인 관리**로 이동합니다.
3. 백업 관리자 플러그인을 찾아 활성화합니다.

3단계: 로컬 백업 파일에서 복원

1. 플러그인을 활성화한 후 페이지를 새로고침합니다.
2. 왼쪽 메뉴의 시스템 관리 -> **백업 관리자**로 이동합니다.
3. 우측 상단의 로컬 백업에서 복원 버튼을 클릭합니다.
4. 다운로드한 백업 파일을 업로드 영역으로 드래그합니다.
5. **제출**을 클릭하고 시스템이 복원을 완료할 때까지 인내심을 갖고 기다립니다. 이 과정은 수십 초에서 몇 분 정도 소요될 수 있습니다.

#주의 사항

• 데이터베이스 호환성: 이 방법에서 가장 중요한 점입니다. 귀하의 PostgreSQL 데이터베이스 버전, 문자 집합, 대소문자 구분 설정이 백업 소스 파일과 일치해야 합니다. 특히 schema 이름이 반드시 일치해야 합니다.
• 상용 플러그인 일치: 솔루션에 필요한 모든 상용 플러그인을 보유하고 활성화했는지 확인하십시오. 그렇지 않으면 복원이 중단됩니다.

#방법 2: SQL 파일 직접 가져오기 (범용, 커뮤니티 버전에 더 적합)

이 방식은 데이터베이스를 직접 조작하여 데이터를 복원하므로 "백업 관리자" 플러그인을 거치지 않으며, 따라서 전문가/기업용 버전 플러그인의 제한이 없습니다.

#핵심 특징

• 장점:
  1. 버전 제한 없음: 커뮤니티 버전을 포함한 모든 NocoBase 사용자에게 적용됩니다.
  2. 높은 호환성: 애플리케이션 내의 dump 도구에 의존하지 않으며, 데이터베이스에 연결만 가능하면 조작할 수 있습니다.
  3. 높은 결함 허용성: 솔루션에 귀하가 보유하지 않은 상용 플러그인이 포함되어 있어도 관련 기능만 활성화되지 않을 뿐, 다른 기능의 정상적인 사용에는 영향을 주지 않으며 애플리케이션이 성공적으로 시작됩니다.
• 국한:
  1. 데이터베이스 조작 능력 필요: 사용자가 기초적인 데이터베이스 조작 능력을 갖추어야 합니다(예: .sql 파일 실행 방법).
  2. 시스템 파일 유실: 이 방법은 모든 시스템 파일을 유실합니다. 여기에는 템플릿 인쇄 파일, 테이블 내 파일 필드에 업로드된 파일 등이 포함됩니다.

#조작 단계

1단계: 깨끗한 데이터베이스 준비

가져올 데이터를 위해 완전히 비어 있는 새로운 데이터베이스를 준비합니다.

2단계: 데이터베이스에 .sql 파일 가져오기

다운로드한 데이터베이스 파일(보통 .sql 형식)을 가져와 이전 단계에서 준비한 데이터베이스에 내용을 입력합니다. 환경에 따라 여러 가지 실행 방식이 있습니다:

• 옵션 A: 서버 명령줄을 통한 실행 (Docker 예시) Docker를 사용하여 NocoBase와 데이터베이스를 설치한 경우, .sql 파일을 서버에 업로드한 후 docker exec 명령을 사용하여 가져오기를 실행할 수 있습니다. PostgreSQL 컨테이너 이름이 my-nocobase-db이고 파일 이름이 ticket_system.sql이라고 가정합니다:

  # sql 파일을 컨테이너 내부로 복사
  docker cp ticket_system.sql my-nocobase-db:/tmp/
  # 컨테이너에 접속하여 가져오기 명령 실행
  docker exec -it my-nocobase-db psql -U your_username -d your_database_name -f /tmp/ticket_system.sql

• 옵션 B: 원격 데이터베이스 클라이언트를 통한 실행 데이터베이스 포트가 개방되어 있다면, 임의의 그래픽 데이터베이스 클라이언트(DBeaver, Navicat, pgAdmin 등)를 사용하여 데이터베이스에 연결하고, 새 쿼리 창을 열어 .sql 파일의 전체 내용을 붙여넣은 후 실행하면 됩니다.

3단계: 데이터베이스 연결 및 애플리케이션 시작

NocoBase 시작 매개변수(예: 환경 변수 DB_HOST, DB_PORT, DB_DATABASE, DB_USER, DB_PASSWORD 등)를 방금 데이터를 가져온 데이터베이스를 가리키도록 설정합니다. 그런 다음 NocoBase 서비스를 정상적으로 시작합니다.

#주의 사항

• 데이터베이스 권한: 이 방법은 데이터베이스를 직접 조작할 수 있는 계정과 비밀번호가 필요합니다.
• 플러그인 상태: 가져오기에 성공한 후 시스템에 포함된 상용 플러그인 데이터는 존재하지만, 로컬에 해당 플러그인을 설치 및 활성화하지 않은 경우 관련 기능을 표시하거나 사용할 수 없습니다. 하지만 이로 인해 애플리케이션이 충돌하지는 않습니다.

#요약 및 비교

본 튜토리얼이 워크오더 시스템을 성공적으로 배포하는 데 도움이 되기를 바랍니다. 작업 과정에서 문제가 발생하면 언제든지 저희에게 연락해 주세요!