Overview
Puedes reemplazar el valor predeterminado 404 páginaque Atlas App Services muestra cuando un usuario intenta acceder a un recurso inexistente con un documento HTML personalizado. Puede especificar esta 404 página personalizada desde la interfaz de usuario de App Services o importando un directorio de configuración de la aplicación que incluya la página en su... hosting Directorio. Seleccione la pestaña a continuación que corresponda al método que desea utilizar.
Nota
404 Errores en aplicaciones de una sola página
Cuando el hosting de aplicaciones de una sola página está habilitado, App Services siempre devuelve una respuesta HTTP 200 con la raíz de la aplicación, independientemente de la ruta solicitada. Esto significa que no puedes especificar una página 404 personalizada para un SPA. En su lugar, debes incluir código personalizado en tu aplicación para gestionar rutas inválidas.
Procedimiento
Crear un archivo de página 404 personalizado
Puedes usar cualquier archivo alojado como página 404 personalizada. Es habitual usar un archivo HTML que incorpore los siguientes elementos:
Un mensaje breve que indica el error, por ejemplo: "Esta página no existe".
Enlaces u opciones alternativas para que el usuario continúe navegando.
Alojar el archivo 404 en App Services
Una vez que haya creado el 404 archivo personalizado, debe cargarlo en App Services. Para cargar el archivo, navegue a Hosting En la pantalla de la interfaz de usuario de App Services, haga clic en Upload Files y seleccione el archivo HTML personalizado.
Configura la ruta de recursos 404 en Servicios de aplicación
Una vez que haya cargado correctamente el archivo 404, todo lo que queda es configurar App Services para que sirva ese archivo en lugar de la página 404 predeterminada.
En la página Hosting, haga clic en la pestaña Settings.
En Custom 404 Page, haz clic en Choose File.
Seleccione su archivo 404 personalizado de la lista.
Haga clic en Save.
Una vez que haya actualizado la configuración Hosting, App Services comenzará a servir su archivo personalizado en lugar de la página predeterminada 404.
Obtenga la última versión de su aplicación
Para configurar una 404 página personalizada con la CLI de App Services, necesita una copia local de los archivos de configuración de su aplicación.
Para extraer una copia local de la última versión de su aplicación, ejecute lo siguiente:
appservices pull --remote="<Your App ID>"
Tip
También puedes descargar una copia de los archivos de configuración de tu aplicación desde la pantalla Deploy > Import/Export App en la Interfaz de usuario Realm.
Crear un archivo HTML de página 404 personalizado
Puedes usar cualquier archivo HTML válido para la página 404 de tu aplicación. Considera incorporar los siguientes elementos:
Un mensaje breve que indica el error, por ejemplo: "Esta página no existe".
Enlaces u opciones alternativas para que el usuario continúe navegando.
Alojar el archivo HTML en App Services
Una vez que hayas creado el archivo HTML personalizado, deberás alojarlo en App Services.
Si aún no está alojando el archivo HTML en App Services, agréguelo al directorio hosting/files/.
Especifique la página 404 en la configuración de la aplicación
hosting/config.jsonEn, establezca default_error_path en la ruta de recursos del archivo HTML de la 404 página y luego guarde el archivo de configuración.
"hosting": { "enabled": true, "default_error_path": "/pages/custom_404.html" }
Implementar la configuración de alojamiento actualizada
Una vez que hayas actualizado hosting/config.json, puedes enviar la configuración actualizada a tu aplicación remota. Si también agregaste la página 404, asegúrate de usar el indicador --include-hosting. La CLI de App Services empieza a mostrar tu página 404 personalizada inmediatamente al enviarla.
appservices push --remote="<Your App ID>" --include-hosting