Compare commits

...

2 Commits

Author SHA1 Message Date
andy-sg
2874e884a2 feat: 오늘의 말씀 카드 UI 구현
All checks were successful
Build and Deploy / deploy (push) Successful in 9s
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 19:34:51 +09:00
andy-sg
8136db858b docs: Gitea Actions → Synology 배포 주의사항 정리
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 19:33:20 +09:00
2 changed files with 1168 additions and 31 deletions

View File

@@ -14,3 +14,49 @@ The React Compiler is not enabled on this template because of its impact on dev
## Expanding the ESLint configuration ## Expanding the ESLint configuration
If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project. If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.
---
## 배포 (Gitea Actions → Synology NAS)
`main` 브랜치에 푸시하면 Gitea Actions가 빌드 후 Synology NAS(Web Station)로 자동 배포합니다.
### 인프라 구성
| 구성요소 | 환경 |
|---------|------|
| Gitea | Proxmox LXC |
| Gitea Actions Runner | LXC 내 Docker Compose |
| 배포 대상 | Synology NAS (10.0.0.19) Web Station |
| 배포 경로 | `/volume1/web/app` |
| 접속 URL | `http://10.0.0.19:8080` |
### 주의사항
#### 1. Runner 컨테이너 ≠ Job 실행 환경
- Runner 자체는 Alpine이지만, `runs-on: ubuntu-latest`로 실행되는 Job은 **별도 Ubuntu 컨테이너**에서 동작
- Runner 컨테이너에 들어가서 테스트하면 환경이 다르므로 의미 없음
- 디버깅은 **워크플로우 스텝에서 직접** 해야 정확
#### 2. Ubuntu 24.04의 scp는 Synology와 호환 문제 있음
- OpenSSH 9.0+부터 scp가 기본적으로 **SFTP 프로토콜**을 사용
- Synology가 이를 제대로 지원하지 못해 `dest open: No such file or directory` 에러 발생
- **해결**: scp 대신 `tar | ssh` 파이프 사용
```bash
tar -czf - -C dist . | ssh user@host "tar -xzf - -C /path/"
```
#### 3. Job 컨테이너의 패키지 제한
- `rsync` 없음 → scp 또는 tar+ssh 사용
- `apk` 없음 → Ubuntu이므로 `apt-get` (하지만 ssh/scp는 기본 포함)
#### 4. Gitea Secrets 등록 시 주의
- 공백, 개행 문자가 들어가지 않도록 주의
- 디버깅 시 `echo "[$VAR]"`, `${#VAR}` (길이 출력)로 확인
#### 5. 배포 디렉토리 관리
- `rm -rf /path/*` 후 전송하면 타이밍에 따라 디렉토리가 사라질 수 있음
- **안전한 패턴**: `mkdir -p`로 보장 후 전송
```bash
ssh user@host "mkdir -p /path && rm -rf /path/*"
```

File diff suppressed because it is too large Load Diff