アプリケーションのデプロイ時に何かしらのエラーが生じた場合、以下のようなエラーメッセージが表示されます。
問題が発生しました。サポートにご連絡ください。（Something went wrong, please contact support.）
ビルドプロセス失敗（Build process failed.）
ビルドの不明なエラーが発生しました。（Unknown build fail type.）
ロールアウトプロセスがすぐに失敗した場合、またはビルドプロセスに失敗した場合、ポッドは作成されず、実行ログも生成されることはありません。ほとんどの場合、ウェブプロセスのstartコマンドまたはENTRYPOINTが正しくないことが原因です。
ロールアウトプロセスが1～2分実行された後に失敗した場合も、通常ポッドと実行ログは作成されません。何かしらの誤りが原因で、プロセスが停止したことを意味します。この場合は、アプリケーションの実行ログを閲覧し、エラーメッセージを確認してください。エラーメッセージはアプリケーションのコードのバグを特定するのに役立ち、効率的に問題のデバッグを行うことができます。
以下にご紹介するトラブルシューティングを行った上で、エラーの原因を特定できない場合は、弊社カスタマーサポートまでお問い合わせください。
GitHubリポジトリ
アプリケーションの正しいファイルが、すべてリポジトリに反映されていることを確認してください。
言語
アプリケーション追加時に「コンテナイメージを自動で設定」を選択すると、ビルドパックを使って、コンテナが自動的に選択・セットアップされます。ビルドパックを使用する場合、アプリケーションのファイルに正しい言語バージョンが含まれていることを確かめてください。言語バージョンの指定についてはこちらをご覧ください。
startコマンドとENTRYPOINT
アプリケーションは、ウェブプロセスのstartコマンド、またはENTRYPOINTによって起動します。これに誤りがある場合、アプリケーションは実行されません。このコマンドは、MyKinstaで確認可能です。「プロセス」＞「ランタイムプロセス」＞「ウェブプロセス」、または「デプロイメント」＞「履歴」に移動し、該当のアプリケーションを選択して、「デプロイメントの詳細」画面下に表示される「ロールアウトプロセス」の文字を見つけてください。
Dockerfileを使用してコンテナイメージをセットアップする場合は、コンテナの実行に、DockerfileでのENTRYPOINT指定が必要になります。アプリケーションのENTRYPOINTを指定する方法については、Dockerfileについての公式ドキュメントをご覧ください。
言語別コマンド例についてはこちらをご覧ください。
環境変数
環境変数は、アプリケーションに対してその外から情報を与えるものです。環境変数に誤りがあると、アプリケーション実行の妨げになることがあります。環境変数は、「設定」＞「環境変数」で確認可能です。
この画面で、正しい環境変数が存在し、有効な値が含まれていることを確認します。環境変数の作成・確認の際には、以下の点に注意してください。
- カンマ（ , ）はロールアウトプロセスで区切り文字として認識されるため、使用できません。
- 各キーはすべて一意で、一度しか使用できません。
ポート
アプリケーションホスティングでは、ポート80と443のみ開かれています。アプリケーションでポートを開く場合は、8080を使用してください。