서버 운영 가이드

이 페이지는 현재 서버의 Nimbus 문서 사이트를 운영하는 방법을 설명합니다. 사이트 주소는 docs.klounge.kr입니다. Nginx가 빌드된 정적 파일을 제공하므로 평소에는 개발 서버를 켜둘 필요가 없습니다.

1. 프로젝트로 이동

서버 터미널에서 다음 명령을 실행합니다.

cd /home/nimbus

이 사이트의 문서 원본은 apps/www/src/content/docs/에 있습니다. 기존 .mdx 파일을 수정하거나 새 파일을 추가할 수 있습니다. 새 문서에는 제목을 포함한 머리말이 필요합니다.

---
title: 새 문서
description: 이 문서의 짧은 설명입니다.
---

여기에 내용을 작성합니다.

사이드바에 새 문서를 표시하려면 apps/www/astro.config.ts의 sidebar.items에도 문서 경로를 추가합니다. 예를 들어 src/content/docs/example.mdx는 "example"로 등록합니다.

pnpm --filter @nimbus/www dev

터미널에 표시된 주소에서 변경 사항을 확인합니다. 서버 밖에서 접속하려면 SSH 터널을 사용하거나 서버의 접근 설정을 별도로 구성해야 합니다. 작업을 끝낼 때는 Ctrl+C를 누릅니다.

저장소 루트(/home/nimbus)에서 순서대로 실행합니다.

pnpm --filter @cloudflare/nimbus-docs build
pnpm --filter @nimbus/www build

빌드 결과는 apps/www/dist/에 생성됩니다. 빌드가 실패했다면 다음 단계로 진행하지 말고 오류를 먼저 해결합니다.

cp -a apps/www/dist/. /var/www/docs.klounge.kr/

Nginx가 정적 파일을 직접 제공하므로 다시 시작할 필요는 없습니다. docs.klounge.kr를 새로고침해 변경 사항을 확인합니다.

현재 사이트를 수정하는 대신 별도의 문서 사이트를 만들려면 다음 명령을 사용합니다.

npx @cloudflare/create-nimbus-docs@latest my-docs
cd my-docs
pnpm dev

생성 과정에서 의존성 설치를 건너뛰었다면 pnpm install을 먼저 실행합니다. 자세한 내용은 설치 안내를 참고하세요.