diff --git a/MANUAL.md b/MANUAL.md index 7007f43..68bbaee 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -141,7 +141,35 @@ psql "$DATABASE_URL" # 본인 전용 스키마로 바로 접속됨 --- -## 7-1. 개발 중인 앱 미리보기 (브라우저에서 열기) +## 7-1. 프로젝트를 Gitea(git)에 올리기 + +`new-project` 로 만든 폴더는 git 저장소가 아직 아닙니다(`.git` 없음). 아래처럼 올립니다. + +**1) Gitea에 빈 저장소 만들기** +- **https://gitea.bokdev.in** → 우측 상단 **`+` → New Repository** +- Repository Name 입력(예: `myapp`) +- **README/.gitignore/License 는 체크하지 마세요**(빈 저장소여야 충돌이 없습니다) → Create +- 생성되면 주소가 나옵니다: `https://gitea.bokdev.in/<본인사번>/myapp.git` + +**2) 워크스페이스 터미널에서 올리기** +```bash +cd ~/projects/myapp +git init +git add . +git commit -m "first commit" +git branch -M main +git remote add origin https://gitea.bokdev.in/<본인사번>/myapp.git +git push -u origin main +``` +- 인증은 자동입니다(6번 Gitea 승인을 한 번 했다면). 처음이면 승인 화면이 한 번 뜹니다. +- 이후 수정한 뒤에는 `git add . && git commit -m "..." && git push` 만 반복하면 됩니다. + +> **순서는 상관없습니다.** 코드를 먼저 만들고(권장) 나중에 저장소를 만들어도 되고, 저장소를 먼저 만들어도 됩니다. `git push` 시점에 Gitea 저장소만 있으면 됩니다. +> **`.project-env` 는 git에 올라가지 않습니다**(DB·S3 자격증명 보호 — 정상). `git status` 에 안 보여도 맞습니다. 배포 시엔 그 값을 Coolify에 따로 넣습니다(9번). + +--- + +## 7-2. 개발 중인 앱 미리보기 (브라우저에서 열기) `npm run dev` 로 띄운 앱(예: `:3000`)을 브라우저로 보려면 — 워크스페이스는 사내 클러스터 안에 있어 `localhost:3000` 으로는 바로 안 열립니다. 아래 방법으로 **임시 미리보기 URL** 을 받으세요.