Exercice - Créer des emplacements de déploiement

  • 12 minutes

Un emplacement de déploiement est une instance d’une application web dans laquelle vous pouvez tester une nouvelle version d’application avant de la déployer. En échangeant des emplacements, vous pouvez déployer une nouvelle version d’une application sans temps d’arrêt.

Supposons que vous décidez d’utiliser des emplacements de déploiement Azure App Service pour simplifier le déploiement de nouvelles versions de votre application web de médias sociaux. Vous souhaitez configurer l’application web dans Azure et configurer un ou plusieurs emplacements de déploiement.

Dans cet exercice, vous configurez une application web, ajoutez un nouvel emplacement de déploiement pour la préproduction et déployez différentes versions de l’application web sur les emplacements de production et de préproduction.

Important

Vous avez besoin de votre propre abonnement Azure pour effectuer cet exercice, et vous risquez d’entraîner des frais. Si vous n’avez pas encore d’abonnement Azure, créez un compte gratuit avant de commencer.

Créer une application web

Commencez par créer une ressource d’application web dans le portail Azure.

  1. Connectez-vous au portail Azure.

  2. Dans le menu des ressources, ou dans la page d’accueil , sélectionnez Créer une ressource. Le volet Créer une ressource apparaît.

  3. Dans le menu de ressources, sélectionnez Web et, dans les résultats, sélectionnez Application web. Le volet Créer une application web s’affiche.

  4. Sous l’onglet Informations de base, entrez les valeurs suivantes pour chaque paramètre.

    Réglage Valeur
    Détails du projet
    Abonnement Sélectionnez l’abonnement que vous souhaitez utiliser pour effectuer l’exercice
    Groupe de ressources Sélectionnez le lien Créer un lien, puis entrez mslearn-slots, puis sélectionnez OK.
    Détails de l’instance
    Nom Entrez un nom unique.
    Publier Code
    Pile du runtime ASP.NET V4.8
    Système d’exploitation Fenêtres
    Région Sélectionnez une région proche de chez vous.
    Plan App Service
    Plan de Windows Acceptez les valeurs par défaut.
    Référence SKU et taille Acceptez les valeurs par défaut.

  5. Sélectionnez Suivant : Base de données.

  6. Sélectionnez Suivant : Déploiement.

  7. Sélectionnez Suivant : Mise en réseau.

  8. Sélectionnez Suivant : Surveillance + sécurisé, puis entrez la valeur suivante pour le paramètre.

    Réglage Valeur
    Application Insights
    Activer Application Insights Basculer vers Non

  9. Sélectionnez Examiner + créer, puis sélectionnez Créer. Attendez que le déploiement réussisse.

  10. Une fois le déploiement terminé, sélectionnez Accéder à la ressource. Le volet App Service de votre application web s’affiche.

Configurer le déploiement git

Bien que vous puissiez utiliser de nombreux outils différents pour déployer du code sur votre application web, dans cet exercice, vous configurez l’application web pour utiliser un dépôt git local.

  1. Dans le menu App Service, sous Déploiement, sélectionnez Centre de déploiement. Le volet Centre de déploiement de votre service d’application s’affiche.

  2. Sous l’onglet Paramètres , pour Source, sélectionnez Git local, puis sélectionnez Enregistrer dans la barre de commandes pour configurer votre déploiement.

  3. Sélectionnez l’onglet Informations d’identification Git/FTPS local . Sous Étendue utilisateur, entrez un nom d’utilisateur et un mot de passe uniques de votre choix, puis, dans la barre de commandes, sélectionnez Enregistrer. Notez le nom d’utilisateur et le mot de passe pour les versions ultérieures.

Configurer le client Git et cloner le code source de l’application web

À présent, vous configurez le client Git dans Cloud Shell et l’utilisez pour cloner un exemple d’application web.

  1. Dans les contrôles globaux Azure en haut de la page, sélectionnez l’icône Cloud Shell pour lancer une session Azure Cloud Shell.

    Capture d’écran de l’icône Cloud Shell dans les contrôles globaux.

  2. Dans la session Cloud Shell, lorsque vous y êtes invité, sélectionnez l’expérience Bash et créez un stockage pour votre abonnement.

    Remarque

    Pour conserver les fichiers que vous créez dans Cloud Shell, vous devez disposer d’une ressource de stockage Azure. Quand vous ouvrez Cloud Shell pour la première fois, vous êtes invité à créer un groupe de ressources, un compte de stockage et un partage Azure Files. Cette configuration est automatiquement utilisée pour toutes les futures sessions Cloud Shell.

  3. Entrez la commande suivante dans Cloud Shell, en <remplaçant votre nom d’utilisateur par votre nom d’utilisateur> préféré. Cette valeur de configuration n’est associée à aucun compte Azure. Vous pouvez donc utiliser la valeur souhaitée.

    git config --global user.name <your-username>

  4. Entrez la commande suivante dans Cloud Shell, en <remplaçant votre adresse> e-mail par votre adresse e-mail préférée. Cette valeur de configuration n’est associée à aucun compte Azure. Vous pouvez donc utiliser la valeur souhaitée.

    git config --global user.email <your-email-address>

  5. Entrez le code suivant pour créer et ouvrir un demoapp dossier pour le code source.

    mkdir demoapp
cd demoapp

  6. Entrez le code suivant pour cloner la source de l’application web et ouvrez votre copie locale.

    git clone https://github.com/Azure-Samples/app-service-web-dotnet-get-started.git
cd app-service-web-dotnet-get-started

Configurer un git distant pour déployer l’application en production

Nous allons utiliser git pour déployer le code source dans l’emplacement de production de l’application web, puis configurer l’URL git de votre application en tant que référentiel distant.

  1. Dans le portail Azure, votre application web doit être active. Dans le menu de ressources, sélectionnez Vue d’ensemble.

  2. Dans le volet Vue d’ensemble de votre application web, la section Essentials a une URL dans le domaine par défaut. L’URL contient le nom de votre déploiement pour l’application web.

    Capture d’écran de la section Essentials, où vous copiez l’URL de clone git.

    Remarque

    Si vous ne voyez pas d’URL de clone Git dans l’emplacement indiqué dans la capture d’écran précédente, actualisez le portail.

  3. Pointez sur l’URL git clone et sélectionnez l’icône Copier dans le Presse-papiers. Cette valeur contient également votre nom d’utilisateur de déploiement.

  4. Dans Cloud Shell, exécutez la commande suivante pour configurer git distant avec le nom production. Remplacez \<git-clone-url> par le contenu que vous avez copié dans le Presse-papiers de l’étape précédente.

    cd app-service-web-dotnet-get-started
git remote add production <git-clone-url>

  5. Exécutez la commande suivante pour déployer l’application web sur l’emplacement de production. Lorsque vous êtes invité à entrer le mot de passe, entrez le mot de passe de déploiement que vous avez créé dans la tâche précédente.

    git push production

    La session de terminal identifie tous les processus qui ont lieu dans le cadre du déploiement. Attendez que le déploiement se termine. Une notification indiquant le succès du déploiement devrait s'afficher.

  6. Dans le portail Azure, le volet Vue d’ensemble doit toujours être actif. Pointez sur l’URL. Vous pouvez double-cliquer dessus pour l’ouvrir dans un nouvel onglet de navigateur ou le copier et le coller dans un nouvel onglet de navigateur.

    Capture d’écran de votre application web dans l’emplacement de production.

  7. Fermez l’onglet du navigateur qui affiche l’application web.

Créer un emplacement de préproduction

Pour votre application web, vous avez créé un emplacement, l’emplacement de production et déployé du code source sur cet emplacement. Nous allons créer un emplacement de déploiement dans lequel vous pouvez mettre en scène de nouvelles versions de votre application web.

  1. Dans le menu du portail Azure, sélectionnez Accueil et, dans les services Azure, sélectionnez Toutes les ressources. Filtrez par type == App Service, puis sélectionnez Appliquer.

  2. Triez le résultat par type, puis sélectionnez App Service que vous avez créé. Le volet App Service de votre application web s’affiche.

  3. Dans le menu App Service, sous Déploiement, sélectionnez Emplacements de déploiement. Le volet Emplacements de déploiement de votre App Service s’affiche.

    Capture d’écran du menu App Service avec emplacements de déploiement mis en surbrillance.

  4. Dans la barre de commandes, sélectionnez + Ajouter un emplacement. Le volet Ajouter un emplacement s’affiche.

  5. Dans le champ Nom, entrez staging, acceptez la valeur par défaut pour les paramètres de clonage, puis sélectionnez Ajouter.

  6. Une fois l’emplacement de déploiement créé, sélectionnez Fermer.

Configurer le déploiement git pour l’emplacement de préproduction

Nous allons configurer le nouveau slot pour qu’il utilise le déploiement git.

  1. Dans le portail Azure, sélectionnez Page d’accueil , puis dans les services Azure, sélectionnez Toutes les ressources.

  2. Triez les ressources par groupe de ressources. pour le groupe de ressources mslearn-slots, il existe deux types App Service. Les emplacements de déploiement sont représentés sous forme d’applications distinctes dans le portail.

  3. Sélectionnez l'espace de mise en scène. Le volet Vue d’ensemble de votre App Service (Slot) s’affiche.

  4. Dans le menu Intermédiaire, sous Déploiement, sélectionnez Centre de déploiement.

  5. Sous l’onglet Paramètres , pour Source, sélectionnez Git local, puis sélectionnez Enregistrer dans la barre de commandes pour configurer le déploiement pour la mise en lots.

  6. Dans le volet Centre de déploiement résultant, sélectionnez l’onglet Informations d’identification Git/FTPS local .

  7. Sous Étendue utilisateur, entrez un nom d’utilisateur et un mot de passe de votre choix, puis sélectionnez Enregistrer. Azure met à jour les informations d’identification de l’utilisateur. Notez le nom d’utilisateur et le mot de passe pour les versions ultérieures.

Configurer git pour déployer l’application sur l’emplacement de préproduction

Pour utiliser le client Git pour déployer le code source sur le nouveau créneau, nous allons ajouter un remote supplémentaire à la configuration Git.

  1. Dans le menu App Service , sélectionnez Vue d’ensemble. Si vous êtes invité à enregistrer le mot de passe du nom d’utilisateur que vous avez créé dans la tâche précédente, sélectionnez Enregistrer.

  2. Dans le volet Vue d’ensemble, dans la section Essentials, survolez la valeur URL du clonage Git et sélectionnez l’icône Copier dans le Presse-papiers. L’URL contient le nom d’utilisateur de votre déploiement intermédiaire.

    Remarque

    Si vous ne voyez pas l’URL du clone Git, actualisez le portail. L’URL de clone Git de l’emplacement de préproduction diffère légèrement de l’URL de l’emplacement de production, et qu’elle inclut le nom de l’emplacement.

  3. Dans Cloud Shell, vérifiez que vous êtes dans le dossier ~/demoapp/app-service-web-dotnet-get-started, puis exécutez la commande suivante, en remplaçant <git-clone-uri> par l’URL que vous avez copiée à l’étape précédente.

    git remote add staging <git-clone-uri>

Modifier le code source de l’application et déployer l’application sur l'environnement de mise en scène

Ensuite, nous allons apporter une petite modification aux fichiers d’application web, puis utiliser Git pour déployer la nouvelle version sur l’emplacement intermédiaire :

  1. Dans Cloud Shell, exécutez la commande suivante.

    code .

  2. Dans la liste des fichiers, développez aspnet-get-started>Views>Accueil, puis sélectionnez Index.cshtml.

  3. Recherchez le code HTML suivant.

    <h1>ASP.NET</h1>

  4. Remplacez ce code par ce code HTML.

    <h1>Web App Version 2</h1>

  5. Appuyez sur Ctrl+S pour enregistrer vos modifications, puis appuyez sur Ctrl+Q pour fermer l’éditeur.

  6. Dans Cloud Shell, exécutez le code suivant pour valider la nouvelle version de l’application sur git et la déployer sur l’emplacement intermédiaire.

    git add .
git commit -m "New version of web app."
git push staging

    Lorsque vous y êtes invité, entrez votre mot de passe de déploiement. Notifications des opérations pour créer et déployer l’affichage intermédiaire dans la session Cloud Shell, et qui devrait afficher Déploiement réussi.

Parcourir l’emplacement de préproduction

Vous pouvez maintenant afficher la nouvelle version de l’application web en accédant à l’URL de l’emplacement de déploiement intermédiaire.

  1. Dans le portail Azure, dans le volet Vue d’ensemble de l’emplacement intermédiaire, sélectionnez Parcourir dans la barre de commandes ou sélectionnez l’URL dans le domaine par défaut. La page d'accueil de l'application web de test version 2 s'affiche dans un onglet du navigateur.

    Capture d’écran de l’application web mise à jour dans l’emplacement intermédiaire.

Félicitations, vous venez de créer un emplacement intermédiaire qui a sa propre version du code d’application web, et vous pouvez exécuter des tests sur celui-ci. N’oubliez pas que l’emplacement de production a la version précédente de l’application web et que les utilisateurs ne peuvent pas encore voir votre nouveau code.