123 lines
2.9 KiB
Markdown
123 lines
2.9 KiB
Markdown
# Gitea 수동 배포
|
|
|
|
## 기준 정보
|
|
|
|
- Gitea 웹: `https://gitea.hmac.kr/b24014/egbim_homepage`
|
|
- 앱 배포 대상: `172.16.10.175:8071`
|
|
- Git 원격: `https://gitea.hmac.kr/b24014/egbim_homepage.git`
|
|
- 실행 방식: `git push` 후 Gitea Actions 에서 수동 실행
|
|
|
|
## 1. 로컬 저장소 초기화
|
|
|
|
```bash
|
|
cd /home/b24014/egbim
|
|
git branch -m main
|
|
git remote remove origin 2>/dev/null || true
|
|
git remote add origin https://gitea.hmac.kr/b24014/egbim_homepage.git
|
|
```
|
|
|
|
현재 원격 확인:
|
|
|
|
```bash
|
|
git remote -v
|
|
```
|
|
|
|
예상 결과:
|
|
|
|
```text
|
|
origin https://gitea.hmac.kr/b24014/egbim_homepage.git (fetch)
|
|
origin https://gitea.hmac.kr/b24014/egbim_homepage.git (push)
|
|
```
|
|
|
|
## 2. 첫 푸시
|
|
|
|
```bash
|
|
cd /home/b24014/egbim
|
|
git add .
|
|
git commit -m "Initial import"
|
|
git push -u origin main
|
|
```
|
|
|
|
HTTPS 인증이 필요하면 Gitea 사용자 계정과 토큰 또는 비밀번호를 사용한다.
|
|
|
|
## 3. Gitea Actions 수동 배포
|
|
|
|
저장소에 추가된 워크플로 이름은 `Manual Deploy` 이다.
|
|
|
|
Gitea 저장소 화면에서 아래 순서로 실행한다.
|
|
|
|
1. `Actions` 로 이동
|
|
2. `Manual Deploy` 선택
|
|
3. `Run workflow` 클릭
|
|
4. `branch` 와 `target_dir` 확인 후 실행
|
|
|
|
워크플로는 서버에 SSH 접속해서 지정 디렉터리에 소스를 동기화하고 `docker compose up -d --build` 를 수행한다.
|
|
|
|
## 4. Gitea Secrets
|
|
|
|
수동 배포 전에 아래 시크릿을 Gitea 저장소에 등록해야 한다.
|
|
|
|
- `DEPLOY_HOST`: 예) `172.16.10.175`
|
|
- `DEPLOY_PORT`: 예) `22`
|
|
- `DEPLOY_USER`: 서버 SSH 계정
|
|
- `DEPLOY_SSH_KEY`: 배포용 개인키 전체 내용
|
|
|
|
필요하면 아래도 변수로 바꿀 수 있다.
|
|
|
|
- `target_dir`: 서버 배포 경로, 기본값 `/srv/egbim_homepage`
|
|
- 서버 `.env` 안의 `APP_PORT=8071`
|
|
|
|
## 5. 서버 준비 조건
|
|
|
|
- 서버에 `git`, `docker`, `docker compose` 가 설치되어 있어야 한다.
|
|
- 배포 경로에 쓰기 권한이 있어야 한다.
|
|
- 서비스 포트 `8071` 이 외부에서 접근 가능해야 한다.
|
|
- 서버 배포 경로의 `.env` 파일에 운영값이 들어 있어야 한다.
|
|
- `egbim/img` 는 CDN 대체 대상이므로 Git 배포 대상에서 제외된다.
|
|
|
|
운영 `.env` 예시:
|
|
|
|
```text
|
|
APP_ENV=production
|
|
APP_PORT=8071
|
|
DB_PORT=3307
|
|
G5_MYSQL_DB=egbim
|
|
G5_MYSQL_USER=egbim
|
|
G5_MYSQL_PASSWORD=<set-on-server>
|
|
MARIADB_ROOT_PASSWORD=<set-on-server>
|
|
COMPOSE_PROJECT_NAME=egbim
|
|
```
|
|
|
|
## 6. 이후 배포 반영
|
|
|
|
일반 작업:
|
|
|
|
```bash
|
|
cd /home/b24014/egbim
|
|
git add .
|
|
git commit -m "<change summary>"
|
|
git push origin main
|
|
```
|
|
|
|
그 다음 Gitea 에서 `Manual Deploy` 만 다시 실행하면 된다.
|
|
|
|
## 7. 관리자 확인 필요 항목
|
|
|
|
- 저장소 `b24014/egbim_homepage` 가 이미 생성되어 있는지
|
|
- `main` 브랜치 push 권한이 있는지
|
|
- Gitea Actions 가 활성화되어 있는지
|
|
- 서버에 배포용 SSH 키가 허용되어 있는지
|
|
|
|
## 8. 빠른 점검 명령
|
|
|
|
원격 정보 확인:
|
|
|
|
```bash
|
|
git remote show origin
|
|
```
|
|
|
|
로컬 compose 확인:
|
|
|
|
```bash
|
|
docker compose config
|
|
``` |