docs: 배포 가이드에 서버 이전 및 환경 준비 섹션 추가

Co-authored-by: aider (gemini/gemini-2.5-flash) <aider@aider.chat>
This commit is contained in:
2026-04-13 14:41:05 +09:00
parent a0045854f8
commit 8d9be8eddd
+20 -7
View File
@@ -1,16 +1,29 @@
# VaultKeeper 배포 가이드 # VaultKeeper 배포 가이드
이 문서는 VaultKeeper 애플리케이션의 빌드, 초기 설정 및 Nginx 연동 방법을 안내합니다. 이 문서는 VaultKeeper 애플리케이션을 **새로운 서버에 배포하고 설정하는 방법**을 안내합니다.
## 1. 백엔드 빌드 ## 0. 서버 이전 시 파일 전송
Go 바이너리를 가볍게 빌드하려면 다음 명령어를 사용합니다. 이 명령어는 디버그 정보를 제거하고 심볼 테이블을 생략하여 최종 바이너리 크기를 줄입니다. 프로젝트를 새로운 서버로 이전할 때는 다음 핵심 파일들을 함께 옮겨야 합니다:
```bash * `main.go`: 백엔드 Go 애플리케이션 소스 코드
go build -o vaultkeeper -ldflags "-s -w" main.go * `index.html`: 프론트엔드 웹 UI 파일
``` * `config.json`: 애플리케이션 설정 파일 (htpasswd 경로, 포트 등)
* `run.sh`: 빌드 및 실행을 자동화하는 셸 스크립트
빌드가 완료되면 현재 디렉토리에 `vaultkeeper` 실행 파일이 생성됩니다. 이 파일들을 새로운 서버의 원하는 디렉토리로 복사하십시오. (예: `/opt/vaultkeeper/`)
---
## 1. 서버 환경 준비
VaultKeeper를 실행하기 전에 새로운 서버에 다음 도구들이 설치되어 있는지 확인해야 합니다.
* **Go 런타임**: `main.go`를 빌드하고 실행하기 위해 필요합니다.
* 설치되어 있지 않다면, 공식 Go 웹사이트를 참조하여 설치하십시오. (예: `sudo apt install golang` 또는 `sudo yum install golang`)
* **htpasswd 도구**: Apache HTTP Server Utils 패키지에 포함되어 있으며, `.htpasswd` 파일을 관리하는 데 사용됩니다.
* Debian/Ubuntu: `sudo apt install apache2-utils`
* CentOS/RHEL: `sudo yum install httpd-tools`
## 2. VaultKeeper 설정 파일 (`config.json`) 생성 및 설정 ## 2. VaultKeeper 설정 파일 (`config.json`) 생성 및 설정