아래 빌드 FAQ를 읽기 전에, 먼저 사이트에 올바른 빌드 설정이 되어 있는지 확인하세요. 일반 빌드 설정에서 자세히 알아보세요.
런타임 선택
정적 웹사이트를 배포하려면 사이트의 런타임으로 Static Site를 사용하세요. 이 환경에는 Node, Python, Go, Ruby가 사전 설치되어 있습니다.
Django나 rails 앱 같은 웹 서비스를 배포하려면 Python 또는 Ruby 런타임을 사용하세요. 필요한 라이브러리가 사전 설치되어 있습니다.
프론트엔드와 백엔드가 섞인 혼합형을 배포하려면 — 예: Next.js(정적 사이트 생성(“SSR”) 또는 서버 사이드 렌더링(“SSG”) 중 선택 가능) — 백엔드 런타임을 사용하세요. 즉 Next.js의 “SSR”에는 Node 런타임을 사용하세요.
1. Unknown system error -122 …
배포하는 프로젝트가 구매한 런타임 환경보다 크기 때문입니다. 고객 서비스에 문의하여 사양을 업그레이드하면 더 큰 클라우드 디스크로 빌드와 배포를 완료할 수 있습니다.
...
2021-03-16 01:47:26 error An unexpected error occurred: "Unknown system error -122: Unknown system error -122, copyfile ....".
...
2. [INFO] Worker exiting
각 빌드에는 시간 제한이 있으며, 초과하면 빌드가 자동으로 종료됩니다.
2021-03-13 21:59:00 ==> 😞 Build failed
[2021-03-13 21:59:00 +0800] [12] [INFO] Worker exiting (pid: 12)
[2021-03-13 21:59:01 +0800] [9] [INFO] Shutting down: Master
3. There appears to be trouble with your network connection
프로젝트가 의존성(CSS, JS, 이미지 등)을 사용하는데 빌드 과정에서 이 리소스에 접근하지 못하기 때문일 수 있습니다.
...
2021-02-08 19:46:51 info There appears to be trouble with your network connection. Retrying...
...
4. ERROR: Could not install packages due to an OSError: [Errno 28] No space left on device
배포하는 프로젝트가 구매한 런타임 환경보다 크기 때문입니다. 고객 서비스에 문의하여 사양을 업그레이드하면 더 큰 클라우드 디스크로 빌드와 배포를 완료할 수 있습니다.
...
2021-04-02 01:36:44 ERROR: Could not install packages due to an OSError: [Errno 28] No space left on device
...
5. 빌드는 성공했으나 “upload failed”
...
2021-06-21 22:29:42 ==> Upload the build folder 'web/dist' to CDN...
2021-06-21 22:37:42 ==> Upload failed
2021-06-21 22:37:42 ==> 😞 Build failed
[2021-06-21 22:37:42 +0800] [9] [INFO] Handling signal: term
[2021-06-21 22:37:42 +0800] [12] [INFO] Worker exiting (pid: 12)
[2021-06-21 22:37:42 +0800] [9] [INFO] Shutting down: Master
위 상황이 홍콩의 빌더 위치에서 발생하고 사이트가 중국 본토로 배포되는 경우라면, 이는 야간(중국 시간 오후 8시 30분~오전 1시, GMT+8)에 국경 간 네트워크가 혼잡하기 때문입니다.
중국 시간 오전이나 오후에 다시 시도하거나, 문의하여 전용 네트워크 회선으로 업그레이드해 배포 성능을 개선할 수 있습니다.
6. npm ERR! nospc ENOSPC: no space left on device
...
2021-05-25 21:38:20 npm ERR! code ENOSPC
2021-05-25 21:38:20 npm ERR! syscall write
2021-05-25 21:38:20 npm ERR! errno -28
2021-05-25 21:38:20 npm ERR! nospc ENOSPC: no space left on device, write
2021-05-25 21:38:20 npm ERR! nospc There appears to be insufficient space on your system to finish.
2021-05-25 21:38:20 npm ERR! nospc Clear up some disk space and try again.
2021-05-25 21:38:20 npm ERR! code ENOSPC
...
배포하는 프로젝트가 21YunBox 표준 운영 환경의 저장 용량을 초과하기 때문입니다. 고객 서비스에 문의하여 업그레이드하거나 고성능 빌더를 구매하면 이 문제를 해결할 수 있습니다.
7. Github Pages를 21YunBox로 옮기는데 작동하지 않습니다.
HTML, JS, CSS, 이미지 등 코드와 관련 에셋이 이미 Github Pages 리포지터리(예: https://github.com/<GITHUB_USER_ID>/<GITHUB_USER_ID>.github.io)에 빌드·저장되어 있으므로, 21YunBox에서 다시 빌드할 필요가 없습니다.
아래 설정에 따라 사이트를 빌드하세요:
그 외?
더 많은 도움이 필요하면, 무엇을 하는지(또는 하려는지) 설명하여 이메일로 문의해 주세요. 기꺼이 도와드리겠습니다.