以下のビルドFAQを読む前に、まずサイトに適切なビルド設定が行われているかをご確認ください。詳しくは 一般的なビルド設定(英語) をご覧ください。



ランタイムの選択

静的Webサイトをデプロイする場合は、サイトの Runtime として Static Site を使用してください。この環境には Node、Python、Go、Ruby がプリインストールされています。

Webサービス、例えば Django や Rails アプリをデプロイする場合は、Python または Ruby ランタイムを使用してください。必要なライブラリがあらかじめインストールされています。

フロントエンドとバックエンドの両方を含む混在型、例えば Next.js(静的サイト生成(Static Site Generation、「SSR」)またはサーバーサイドレンダリング(Server-Side Rendering、「SSG」)を選べます)をデプロイする場合は、バックエンドランタイムを使用します。したがって「SSR」の Next.js には 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 で再度ビルドする必要はありません。

以下の設定に従ってサイトをビルドしてください:

21YunBox 向けの Github Pages ビルド設定
21YunBox 向けの Github Pages ビルド設定



その他

さらにサポートが必要な場合は、何をしているか(または何をしようとしているか)をご説明のうえメールでお問い合わせ(英語)ください。喜んでお手伝いします。



21YunBox を試しませんか?

導入のご相談