Exercice – Créer des routes de repli

Effectué

Il est maintenant temps de créer une route de repli pour permettre à vos utilisateurs d’accéder correctement à votre application.

Tirer (pull) le code le plus récent

Azure Static Web Apps a ajouté un fichier de workflow GitHub Actions dans la branche que vous avez sélectionnée dans l’exercice précédent. Tout d’abord, vous obtenez ce fichier en tirant (pull) votre code de Git.

Tirez (pull) les modifications de votre code de Git en procédant comme suit :

  1. Ouvrez la solution ShoppingList dans Visual Studio.

  2. Extrayez les dernières modifications de GitHub.

    Capture d’écran montrant où tirer (pull) les modifications de GitHub.

Vous pouvez maintenant voir votre fichier de workflow dans le dossier .github/workflows dans l’Explorateur Windows (le fichier ne fait pas partie de la solution Visual Studio).

Créer une règle de routage

Avant de publier votre application, vous créez des règles de routage incluant une route de repli.

Créer le fichier staticwebapp.config.json

Si vous n’avez pas encore de fichier staticwebapp.config.json dans votre projet, vous pouvez en créer un en suivant ces étapes :

  1. Dans Visual Studio, cliquez avec le bouton droit sur le dossier wwwroot dans le projet Client.

  2. Sélectionnez Ajouter -> Nouvel élément.

  3. Sélectionnez Fichier JSON dans les modèles disponibles, nommez-le staticwebapp.config.json et appuyez sur Entrée.

Une fois le fichier staticwebapp.config.json créé, mettez-le à jour pour inclure la route de repli suivante :

{
  "navigationFallback": {
    "rewrite": "index.html",
    "exclude": ["/_framework/*", "/css/*"]
  }
}

Envoyer (push) vos modifications vers Git

À présent, enregistrez et commitez vos modifications dans votre dépôt Git local. Ensuite, poussez (push) ces modifications vers GitHub.

Essayer la route de repli

Le workflow GitHub Actions génère et déploie votre application.

Accédez à votre dépôt dans votre navigateur et observez la progression de l’action GitHub. Procédez comme suit pour visualiser cette progression :

  1. Sélectionnez le menu Actions.

  2. Dans le menu Workflows, sélectionnez l’élément de workflow Azure Static Web Apps CI/CD.

  3. Sélectionnez le lien le plus récent (en haut) dans les exécutions d’actions à droite.

  4. Sélectionnez le lien Build and Deploy Job.

Vous pouvez voir la progression de votre action GitHub à mesure qu’elle génère et publie votre application web et l’API.

Une fois que votre application est redéployée, accédez-y. Notez que l’URL affiche /products. Actualisez maintenant le navigateur en appuyant sur F5 pour tester votre route de repli. Votre application doit se recharger avec succès grâce à la route de repli dans les règles de routage.