도움말:S3 연구 메모리/중앙 서버 관리 문서 원본 보기

<!-- S3RM managed repository document; edit the Markdown source, not this page. -->
''이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.''

이 문서는 중앙 S3 연구 메모리 서버 담당자만 사용합니다. 일반 사용자는 저장소나 Docker를 설치하지 않고 [[Help:S3 연구 메모리|README]]의 플랫폼별 연결 문서를 따릅니다.

=== 처음 준비할 때 ===

<code><nowiki>.env</nowiki></code>를 만들고 비밀번호를 채운 뒤, DNS 등록이 확인된 서버에서 공개 도메인을 설정합니다.

<pre><nowiki>
docker compose ps >/dev/null
./scripts/configure-public-domain.sh s3wiki.yonsei.ac.kr \
  --expected-ip 165.132.118.220
</nowiki></pre>

첫 명령이 권한 오류로 실패하면 Docker를 사용할 수 있는 셸에서 다음과 같이 시작합니다.

<pre><nowiki>
cd /home/mrcha033/Projects/s3wiki; sudo -v; make domain-up COMPOSE='sudo docker compose'
</nowiki></pre>

<code><nowiki>sudo make domain-up</nowiki></code>, Docker socket mode <code><nowiki>666</nowiki></code> 변경과 <code><nowiki>sysctl</nowiki></code> 변경은 사용하지 않습니다. 외부 80/443 허용과 HTTPS 인증서 문제는 [[Help:S3 연구 메모리/문제 해결|문제 해결]]을 따릅니다.

<code><nowiki>make domain-up</nowiki></code>은 컨테이너를 실행한 뒤 HTTPS 위키 API와 <code><nowiki>/mcp</nowiki></code>를 확인합니다. 학교 밖 네트워크의 브라우저에서도 위키와 MCP가 열리는지 별도로 확인하세요.

=== 에이전트에게 준비 맡기기 ===

저장소 루트에서 다음 프롬프트를 사용합니다.

<pre><nowiki>
이 저장소의 중앙 S3 연구 메모리 서버를 안전하게 점검하고 실행 준비해 줘.
README.md, AGENTS.md, CLAUDE.md, compose.yaml, .env.example과 docs/setup.md,
docs/security.md, docs/operations.md를 먼저 읽고 기존 변경·.env·Docker 볼륨을
보존해. 로컬/stdio MCP나 개인별 서버는 만들지 말고 mcp-http 하나만 사용해.

기존 .env가 없을 때만 .env.example에서 만들고 change-me 비밀번호만 서로 다른
강한 값으로 바꿔. 위키는 https://s3wiki.yonsei.ac.kr/, 중앙 MCP는
https://s3wiki.yonsei.ac.kr/mcp 하나만 사용해.
먼저 docker compose ps로 Docker daemon 권한을 확인해. Docker socket permission
denied이고 sudo 암호가 필요하면 사용자에게 암호 입력을 요청한 뒤
cd /home/mrcha033/Projects/s3wiki; sudo -v; make domain-up COMPOSE='sudo docker compose'
한 줄만 사용해. sudo make domain-up, docker.sock chmod 666, sysctl 변경은 하지 마.
scripts/configure-public-domain.sh s3wiki.yonsei.ac.kr --expected-ip
165.132.118.220을 실행해 기준 주소와 공용 쓰기 토큰 전달 파일을 맞춰. 같은 URL과
토큰을 모든 클라이언트에 연결하되 토큰 값은 출력하거나 커밋하지 마. 임의 도메인,
서버 IP, localhost, SSH tunnel로 성공을 꾸미지 마.

make test와 make check-compose를 실행하고, 필요하면 검증 가능한 백업을 먼저 만든
뒤 make domain-up을 실행해. Docker에 sudo가 필요한 셸이면 위에서 지정한 COMPOSE
형식을 그대로 사용해. db/mediawiki/mcp-http의 healthy 상태, bootstrap Exited (0),
caddy 실행 상태와 make verify-domain 결과를 확인해. 이 검증은 서버에서 본 HTTPS
상태이므로 학교 밖 네트워크의 브라우저에서도 확인해. DNS나 방화벽 변경이 추가로
필요하면 임의로 처리하지 말고 서버 담당자가 해야 할 일만 한국어로 정확히 보고해.
OAuth는 웹에서도 쓰기가 필요할 때만 별도 작업으로 남겨. 볼륨 삭제, git reset/clean,
/mw-config 브라우저 설치기는 사용하지 마. 위에서 지정한 Docker Compose 명령 외에는
sudo를 사용하지 마.
</nowiki></pre>

=== 자주 쓰는 명령 ===

{| class="wikitable"
! 목적 !! 명령
|-
| 시작 또는 재시작 || <code><nowiki>docker compose up -d &amp;&amp; make verify-domain</nowiki></code>
|-
| 전체 상태 || <code><nowiki>docker compose ps -a</nowiki></code>
|-
| 최근 로그 || <code><nowiki>docker compose logs --tail=200 db mediawiki bootstrap mcp-http caddy</nowiki></code>
|-
| 전체 테스트 || <code><nowiki>make test</nowiki></code>
|-
| Compose 검사 || <code><nowiki>make check-compose</nowiki></code>
|-
| 서버에서 HTTPS 확인 || <code><nowiki>make verify-domain</nowiki></code>
|-
| 백업 || <code><nowiki>make backup</nowiki></code>
|-
| 데이터 보존 후 중지 || <code><nowiki>docker compose down</nowiki></code>
|}

<code><nowiki>docker compose down --volumes</nowiki></code>는 데이터베이스와 업로드를 삭제하므로 사용하지 않습니다. 상세 설치는 [[Help:S3 연구 메모리/설치와 검증|설치 안내]], 백업과 복원은 [[Help:S3 연구 메모리/백업과 복원|운영 안내]]에 있습니다.