diff --git a/deployment.md b/deployment.md index 43c5a1a..18b64b3 100644 --- a/deployment.md +++ b/deployment.md @@ -1,16 +1,29 @@ # VaultKeeper 배포 가이드 -이 문서는 VaultKeeper 애플리케이션의 빌드, 초기 설정 및 Nginx 연동 방법을 안내합니다. +이 문서는 VaultKeeper 애플리케이션을 **새로운 서버에 배포하고 설정하는 방법**을 안내합니다. -## 1. 백엔드 빌드 +## 0. 서버 이전 시 파일 전송 -Go 바이너리를 가볍게 빌드하려면 다음 명령어를 사용합니다. 이 명령어는 디버그 정보를 제거하고 심볼 테이블을 생략하여 최종 바이너리 크기를 줄입니다. +프로젝트를 새로운 서버로 이전할 때는 다음 핵심 파일들을 함께 옮겨야 합니다: -```bash -go build -o vaultkeeper -ldflags "-s -w" main.go -``` +* `main.go`: 백엔드 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`) 생성 및 설정