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