Kapyket GitHub Pages

https://kapyket.github.io/ 에 Filter-Web을 직접 실행하는 조직 사이트입니다.

앱 코드는 Kapyket/Filter-Web에서 관리하고, 이 저장소의 GitHub Actions가 소스를 가져와 정적 파일을 빌드·배포합니다. 사진과 필터 처리는 방문자의 브라우저에서 실행됩니다.

최초 배포

1. Filter-Web 저장소의 main에 build:pages 스크립트와 Pages 빌드 파일을 먼저 push합니다.
2. 이 저장소의 Settings → Pages → Build and deployment → Source를 GitHub Actions로 설정합니다.
3. 이 저장소의 파일들을 main에 push합니다.
4. Actions의 Deploy Filter-Web to GitHub Pages가 성공하면 사이트에 접속합니다.

GitHub Free 조직에서도 두 저장소가 공개되어 있으면 별도 PAT 없이 배포됩니다. 조직 정책에서 Actions 및 Pages 사용을 허용해야 합니다.

앱 업데이트 및 이전 버전 재배포

Filter-Web 변경 사항을 push한 뒤, 이 저장소의 Actions → Deploy Filter-Web to GitHub Pages → Run workflow를 실행합니다. filter_ref에 main, 태그 또는 커밋 SHA를 입력합니다. 이전 커밋 SHA로 이전 버전을 재배포할 수도 있습니다.

이 저장소의 main 변경은 자동 배포됩니다. Filter-Web 저장소에만 push한 경우에는 위 수동 실행이 필요합니다. 배포할 Filter-Web 버전에는 build:pages 스크립트가 있어야 합니다.

로컬 확인

Filter-Web 폴더에서 실행합니다.

npm ci
npm run build:pages
npm run preview:pages

http://127.0.0.1:4173/ 에서 확인할 수 있습니다. 배포 대상은 dist-pages/이며 Node 서버는 배포하지 않습니다.