React + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

• @vitejs/plugin-react uses Babel (or oxc when used in rolldown-vite) for Fast Refresh
• @vitejs/plugin-react-swc uses SWC for Fast Refresh

React Compiler

The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see this documentation.

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 for information on how to integrate TypeScript and typescript-eslint 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 파이프 사용

  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로 보장 후 전송

  ssh user@host "mkdir -p /path && rm -rf /path/*"