과학 및 기술 배경
🔧 NOCOBASE IMPLEMENTATION GUIDE

구현자 가이드 구성으로 배포 실전

시스템 안정적 운영을 위한 신속한 NocoBase 배포 및 구성 완료

배포 준비환경 검사 및 계획

세 가지 배포 방식: 도커 컴포즈, 도커파일, 소스 설치

기본 구성:시스템설정 및 FAQ

📋 배포 준비 🚀 배포방식 ⚙️ 기본 구성 🔧 문제 해결

📋 배포 사전 준비

원활한 배포를 위한 환경 검사 및 계획 수립

하드웨어 및 네트워크 요구 사항

최소 구성(테스트 환경)

  • CPU: 2코어
  • 메모리: 4GB
  • 디스크: 50GB
  • 네트워크: 안정적인 인터넷 연결

권장 구성(프로덕션 환경)

  • CPU: 4코어 이상
  • 메모리: 8GB 이상
  • 디스크: 100GB SSD 이상
  • 인터넷: 안정적인 인터넷 연결, 전용 회선 권장

소프트웨어 환경 요구 사항

Docker 배포방식

  • Docker:20.10.0+
  • Docker Compose:1.29.0+
  • 운영 체제: Linux, Windows, macOS

소스 코드 설치 방식

  • Node.js: 16.14.0+ 또는 18.0.0+
  • 데이터 라이브러리: PostgreSQL 14.0+
  • 운영 체제: Linux, Windows, macOS

배포 계획

1 환경 준비

  • 서버 하드웨어 구성 확인
  • 필요한 소프트웨어 종속성 설치
  • 네트워크 및 방화벽 구성

2 배포 방식 선택

  • 테스트 환경: 도커 컴포즈
  • 프로덕션 환경: 도커파일
  • 심층 맞춤: 소스 코드 설치

3 후속 계획

  • 데이터 백업 전략
  • 모니터링 및 알림
  • 요금제 정기 업데이트

🚀 배포방식

3가지 배포 방식 상세 튜토리얼, 다양한 시나리오의 요구 사항 충족

방식 I: Docker Compose 원클릭 배포(권장 테스트 환경)

배포 단계

1

배포 카탈로그 만들기

mkdir -p nocobase && cd nocobase
2

docker-compose.yml 파일을 생성합니다.

cat > docker-compose.yml << 'EOF' version: '3' services: nocobase: image: nocobase/nocobase:latest ports: - "8080:8080" environment: - DATABASE_URL=postgresql://nocobase:nocobase@postgres:5432/nocobase depends_on: - postgres postgres: image: postgres:14-alpine environment: - POSTGRES_DB=nocobase - POSTGRES_USER=nocobase - POSTGRES_PASSWORD=nocobase volumes: - postgres-data:/var/lib/postgresql/data volumes: postgres-data: EOF
3

서비스 시작

docker-compose up -d
4

노코베이스에 액세스

브라우저를 열고 다음 사이트를 방문하세요. http://서비스기IP:8080

주의

  • 이 방식은 테스트 환경, 프로덕션 환경에 권장되는 Docker파일 방식에 적합합니다.
  • 기본적으로 최신 버전의 이미지가 사용됩니다. 다운로드, 버전을 지정하면 다음과 같이 수정하세요. 이미지 태그
  • 기본 데이터 라이브러리 비밀번호는 nocobase이며, 프로덕션 환경의 경우 강력한 비밀번호로 변경하세요.

방식 II: Docker파일 사용자 지정 구축(프로덕션 환경에 권장)

배포 단계

1

도커파일 파일 만들기

cat > Dockerfile << 'EOF' FROM nocobase/nocobase:latest # 추가 종속성을 설치해야 하는 경우,여기에 추가 # RUN npm install some-package # 사용자 지정 구성을 복사하려면 다음과 같이 하세요.,여기에 추가 # COPY config.yml /app/config/ EOF
2

축구축 거울

docker build -t my-nocobase .
3

docker-compose.yml 파일을 생성합니다.

cat > docker-compose.yml << 'EOF' version: '3' services: nocobase: image: my-nocobase ports: - "8080:8080" environment: - DATABASE_URL=postgresql://nocobase:your_strong_password@postgres:5432/nocobase depends_on: - postgres postgres: image: postgres:14-alpine environment: - POSTGRES_DB=nocobase - POSTGRES_USER=nocobase - POSTGRES_PASSWORD=your_strong_password volumes: - postgres-data:/var/lib/postgresql/data volumes: postgres-data: EOF
4

서비스 시작

docker-compose up -d

주의

  • 프로덕션 환경의 경우 다음을 수정해야 합니다. 데이터 라이브러리 비밀번호가 강력합니다!
  • 최신 태그가 아닌 고정 버전 미러에 권장
  • 필요에 따라 Docker파일 사용자 지정 구성 및 종속성을 추가할 수 있습니다.

방식 III: create-nocobase-app 소스 설치(심층 맞춤용)

배포 단계

1

Node.js 설치

Node.js 16.14.0+ 또는 18.0.0+가 설치되어 있는지 확인합니다.

2

프로젝트 생성

npm create nocobase-app@latest my-nocobase-app
3

데이터 라이브러리 구성

메시지에 따라 데이터 라이브러리 연결 정보를 구성합니다.

4

서비스 시작

cd my-nocobase-app && npm run dev
5

프로덕션 환경

npm run build && npm run start

주의

  • 이 방식은 심층 맞춤 또는 보조 개발이 필요한 장면에 적합합니다.
  • 시스템리소스 및 Node.js 관련 지식이 더 필요합니다.
  • 프로덕션 환경에 권장되는 PM2 및 기타 프로세스 관리 도구

⚙️ 기본 구성

시스템 설정 및 초기화 구성, 시스템 정상 작동 보장

초기 구성

1. 관리 회원 계정 생성

노코베이스를 처음 방문하면 시스템에서 관리자 계정을 만들도록 안내합니다. 강력한 비밀번호를 설정하고 안전하게 보관하세요.

2. 시스템 정보 구성

'설정' -> '시스템 설정'으로 이동하여 시스템 이름, 로고, 저작권 정보 등을 구성합니다.

3. 메일 서비스 구성하기

설정 -> 메일 설정으로 이동하여 SMTP 서비스, 인증 코드 전송에 사용, 알림 등을 구성합니다.

4. 필요한 플러그인 설치

'플러그인 마켓플레이스'로 이동하여 AI 통합, 차트 분석 등 필요한 플러그인을 설치합니다.

보안 구성

1. HTTPS 구성

프로덕션 환경에 권장되는 구성 HTTPS는 Nginx와 같은 리버스 프록시를 통해 구현할 수 있습니다.

2. 방화벽 구성하기

필요한 포트(예: 80, 443 등)만 열고 불필요한 포트는 닫습니다.

3. 구성 권한 관리

설정 -> 캐릭터 권한으로 이동하여 다양한 역할에 대한 권한 구성, 최소 권한 원칙을 따르세요.

4. 데이터 백업 구성

데이터 라이브러리의 정기적인 백업을 통해 크론탭 백업 스크립트의 시간 지정 실행이 가능합니다.

성능 최적화

서비스 웨어 최적화

  • 서버 커널 매개변수 조정
  • 올바른 스왑 공간 구성
  • SSD 스토리지 사용

데이터 라이브러리 최적화

  • PostgreSQL 구성 매개변수 조정하기
  • 쓸모없는 데이터의 정기적인 정리
  • 올바른 색인 만들기

애플리케이션 최적화

  • 캐싱 메커니즘 활성화하기
  • 플러그인 합리화
  • 이미지 및 정적 리소스 최적화

🔧 자주 묻는 질문 및 솔루션

배포사용 과정에서 발생하는 일반적인 문제에 대한 해결 방법

문제: 다음과 같은 경우 Docker 배포에 액세스할 수 없습니다.

가능한 원인

  • 포트가 열리지 않음
  • 방화벽
  • 컨테이너가 제대로 시작되지 않았습니다.

처방전

  • 포트 매핑이 올바른지 확인:docker-compose ps
  • 방화벽 설정을 확인하고 적절한 포트를 엽니다.
  • 컨테이너 로그를 봅니다:docker-compose logs

문제: 데이터 라이브러리 연결 실패

가능한 원인

  • 데이터 라이브러리 구성 오류
  • 데이터 라이브러리 서비스가 활성화되지 않음
  • 네트워크 연결 문제

처방전

  • 데이터 라이브러리가 올바르게 구성되었는지 확인하세요!
  • 데이터라이브러리 서비스가 제대로 작동하는지 확인합니다.
  • 데이터 라이브러리 연결을 테스트합니다:psql -h localhost -U nocobase -d nocobase

문제: 플러그인을 설치하지 못했습니다.

가능한 원인

  • 네트워크 연결 문제
  • 플러그인 버전이 시스템과 호환되지 않습니다!
  • 서비스 웨어 리소스 부족

처방전

  • 네트워크 연결이 제대로 작동하는지 확인
  • 플러그인 버전이 시스템 버전과 호환되는지 확인하세요!
  • 적절한 서버 메모리 및 디스크 공간 확인

문제: 시스템 실행 속도 저하

가능한 원인

  • 서비스 웨어 리소스 부족
  • 최적화되지 않은 데이터 라이브러리
  • 플러그인이 너무 많거나 부적절하게 구성됨

처방전

  • 서비스 웨어 리소스(CPU, RAM) 늘리기
  • 데이터 라이브러리 구성을 최적화하여 적절한 인덱스 생성
  • 불필요한 플러그인 비활성화, 시스템 구성 최적화