Docs Menu
Docs Home
/ /
Atlas App Services
/ /

カスタム 404 ページの使用

項目一覧

  • Overview
  • 手順
  • カスタム 404 ページ ファイルの作成
  • App Services での 404 ファイルのホスト
  • App Services での 404 リソース パスの構成
  • アプリの最新バージョンを取得する
  • カスタム 404 ページ HTML ファイルの作成
  • App Services での HTML ファイルのホスト
  • アプリケーション構成で 404 ページを指定する
  • 更新されたホスティング構成の配置

デフォルトの404 ページ を置き換えることができます Atlas App Services は、カスタム HTML ドキュメントに存在しないリソースにユーザーがアクセスしようとしたときに表示されます。このカスタム404ページは、Atlas App Services UI を使用するか、 hostingディレクトリにページを含むアプリケーション構成ディレクトリをインポートすることで指定できます。 使用する方法に対応する以下のタブを選択します。

注意

単一ページアプリの 404 エラー

単一ページ アプリケーション ホスティングが有効になっている場合、要求されたルートに関係なく、App Services は常にアプリ ルートで HTTP 200 応答を返します。 つまり、SPAのカスタム 404 ページを指定することはできません。 代わりに、無効なルートを処理するには、アプリケーションにカスタム コードを含める必要があります。

1

ホストされている任意のファイルをカスタム 404 ページとして使用できます。 一般的には、次の要素を組み込んだ HTML ファイルを使用します。

  • エラーを示す短いメッセージの例: 「このページは存在しません。」

  • ユーザーが移動を続けるための代替リンクまたはオプション。

2

カスタム404ファイルを作成したら、それを App Services にアップロードする必要があります。 ファイルをアップロードするには、App Services UI の Hosting画面に移動し、 Upload Filesをクリックして、カスタム HTML ファイルを選択します。

3

404 ファイルを正常にアップロードしたら、残りは App Services がデフォルトの 404 ページではなくそのファイルを処理するように設定するだけです。

  1. Hostingページで、 Settingsタブをクリックします。

  2. Custom 404 Page の下にある Choose File をクリックします。

  3. リストからカスタム 404 ファイルを選択します。

  4. [Save] をクリックします。

Hosting構成を更新すると、App Services はデフォルトの 404 ページではなくカスタム ファイルの処理を開始します。

1

App Services CLIを使用してカスタム 404 ページを構成するには、アプリケーションの構成ファイルのローカル コピーが必要です。

アプリの最新バージョンのローカルコピーを取得するには、次のコマンドを実行します。

appservices pull --remote="<Your App ID>"

Tip

App Services UI のDeploy > Import/Export App画面からアプリケーションの構成ファイルのコピーをダウンロードすることもできます。

2

アプリケーションの 404 ページには、任意の有効な HTML ファイルを使用できます。 次の要素を含めることを検討してください。

  • エラーを示す短いメッセージの例: 「このページは存在しません。」

  • ユーザーが移動を続けるための代替リンクまたはオプション。

3

カスタム HTML ファイルを作成したら、App Services でホストする必要があります。

App Services で HTML ファイルをまだホストしていない場合は、 hosting/files/ディレクトリに追加します。

4

hosting/config.jsonでは、404 ページの HTML ファイルのリソース パスdefault_error_pathを設定し、構成ファイルを保存します。

"hosting": {
"enabled": true,
"default_error_path": "/pages/custom_404.html"
}
5

hosting/config.jsonを更新したら、更新された構成をリモート アプリにプッシュできます。 404 ページも追加した場合は、必ず--include-hostingフラグを使用してください。 App Services CLI は、プッシュ時にカスタム 404 ページの処理をすぐに開始します。

appservices push --remote="<Your App ID>" --include-hosting

戻る

Atlas App Services へのコンテンツのアップロード