Exécuter un conteneur personnalisé dans Azure

Azure App Service fournit des piles d’applications prédéfinies sur Windows, par exemple ASP.NET ou Node.js, exécuté sur IIS. Toutefois, les piles d’applications préconfigurées verrouillent le système d’exploitation et empêchent un accès de bas niveau. Les conteneurs Windows personnalisés n’ont pas ces restrictions et permettent aux développeurs de personnaliser entièrement les conteneurs et de fournir aux applications conteneurisées un accès complet aux fonctionnalités de Windows.

Ce guide de démarrage rapide montre comment déployer une application ASP.NET dans une image Windows sur Azure Container Registry à partir de Visual Studio. Vous exécutez l’application dans un conteneur personnalisé au sein d’Azure App Service.

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

  • Installer Docker pour Windows
  • Basculer Docker pour exécuter des conteneurs Windows
  • Installez Visual Studio 2022 avec les charges de travail Développement web et ASP.NET et Développement Azure. Dans Visual Studio 2022 Community, vérifiez que le composant Modèles de projet et d’élément .NET Framework est sélectionné avec la charge de travail Développement web et ASP.NET. Si vous avez déjà installé Visual Studio 2022 :
    • Installez les dernières mises à jour dans Visual Studio en sélectionnant Aide>Rechercher les mises à jour.
    • Ajoutez les charges de travail dans Visual Studio en sélectionnant Outils>Obtenir des outils et des fonctionnalités.

1 - Créer une application web ASP.NET

Créez une application web ASP.NET en effectuant les étapes suivantes :

  1. Ouvrez Visual Studio, puis sélectionnez Créer un projet.

  2. Dans Créer un projet, recherchez et choisissez une application web ASP.NET (.NET Framework) pour C#, puis sélectionnez Suivant.

    Capture d’écran de la boîte de dialogue Créer un projet.

  3. Dans Configurer votre nouveau projet, sous Nom du projet, nommez l’application myfirstazurewebapp. Sous Framework, sélectionnez .NET Framework 4.8, puis Créer.

    Capture d’écran de Configurer votre projet d’application web.

  4. Vous pouvez déployer n’importe quel type d’application web ASP.NET dans Azure. Pour ce guide de démarrage rapide, choisissez le modèle MVC.

  5. Sous Authentification, sélectionnez Aucune. Sous Avancé, sélectionnez Prise en charge Docker et décochez Configurer pour HTTPS. Sélectionnez Create (Créer).

    Capture d’écran de la boîte de dialogue Créer une application web ASP.NET.

  6. Si le fichier Dockerfile ne s’ouvre pas automatiquement, ouvrez-le dans l’Explorateur de solutions.

  7. Vous avez besoin d’une image parent prise en charge. Changez l’image parente en remplaçant la ligne FROM par le code suivant et enregistrez le fichier :

    FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2019
    
  8. Dans le menu Visual Studio, sélectionnez Déboguer>Démarrer sans débogage pour exécuter l’application web localement.

    Capture d’écran de l’application s’exécutant localement.

2 - Publier sur Azure Container Registry

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet myfirstazurewebapp, puis sélectionnez Publier.

  2. Dans Cible, sélectionnez Registre de conteneurs Docker, puis Suivant.

    Capture de l’écran Sélectionner un registre de conteneurs Docker.

  3. Dans Cible spécifique, sélectionnez Azure Container Registry, puis Suivant.

    Capture d’écran de la page de vue d’ensemble Publier depuis un projet.

  4. Dans Publier, vérifiez que l’abonnement approprié est sélectionné. Dans Registres de conteneurs, sélectionnez le bouton + pour créer un registre de conteneurs Azure.

    Capture de l’écran Créer un registre de conteneurs Azure.

  5. Dans Créer, vérifiez que l’abonnement approprié est sélectionné. Sous Groupe de ressources, sélectionnez Nouveau et tapez myResourceGroup pour le nom, puis sélectionnez OK. Sous Référence SKU, sélectionnez De base. Sous Emplacement du registre, sélectionnez l’emplacement du registre, puis Créer.

    Capture d’écran de Détails du registre de conteneurs Azure.

  6. Dans Publier, sous Registre de conteneurs, sélectionnez le registre que vous avez créé, puis sélectionnez Terminer.

    Capture de l’écran Sélectionner un registre de conteneurs Azure existant.

    Attendez la fin du déploiement. La page Publier affiche désormais le nom du dépôt. Sélectionnez le bouton de copie pour copier le nom du dépôt pour la suite.

    Capture d’écran mettant en évidence le nom du dépôt.

3 - Créer un conteneur personnalisé Windows

  1. Connectez-vous au portail Azure.

  2. Sélectionnez Créer une ressource dans le coin supérieur gauche du Portail Azure.

  3. Sous Services populaires, sélectionnez Créer sous Application web.

  4. Dans Créer une application web, choisissez votre abonnement et un Groupe de ressources. Vous pouvez créer un groupe de ressources, le cas échéant.

  5. Indiquez un nom d’application, par exemple win-container-demo. Choisissez Conteneur docker pour Publier et Windows pour Système d’exploitation. Sélectionnez Suivant : Docker pour continuer.

    Capture d’écran de Créer une application web pour conteneurs.

  6. Pour Source d’image, choisissez Docker Hub et pour Image et étiquette, entrez le nom de dépôt que vous avez copié dans Publier sur Azure Container Registry.

    Capture d’écran de Configurer une application web pour conteneurs.

    Si vous avez une image personnalisée ailleurs pour votre application web, comme dans Azure Container Registry ou dans un autre référentiel privé, vous pouvez le configurer ici. Sélectionnez Vérifier + créer pour continuer.

  7. Vérifiez tous les détails, puis sélectionnez Créer et attendez qu’Azure crée les ressources requises. Capture d’écran de Créer une application web pour conteneurs.

4 - Accéder au conteneur personnalisé

Lorsque l’opération Azure est terminée, une zone de notification s’affiche.

Capture d’écran du déploiement réussi.

  1. Cliquez sur Accéder à la ressource.

  2. Dans la vue d’ensemble de cette ressource, suivez le lien situé à côté de URL.

Une nouvelle page de navigateur s’ouvre à la page suivante :

Capture d’écran montrant du conteneur personnalisé Windows en cours de démarrage.

Attendez quelques minutes et réessayez, jusqu'à accéder à la page d’accueil ASP.NET par défaut :

Capture d’écran montrant du conteneur personnalisé Windows en cours d’exécution.

Félicitations ! Vous exécutez votre premier conteneur Windows personnalisé dans Azure App Service.

5 - Consulter les journaux d’activité de démarrage du conteneur

Le chargement du conteneur Windows peut prendre un certain temps. Pour afficher la progression, accédez à l’URL suivante en remplaçant <app-name> par le nom de votre application.

https://<app_name>.scm.azurewebsites.net/api/logstream

Les journaux d’activité en continu ressemblent à ceci :

2018-07-27T12:03:11  Welcome, you are now connected to log-streaming service.
27/07/2018 12:04:10.978 INFO - Site: win-container-demo - Start container succeeded. Container: facbf6cb214de86e58557a6d073396f640bbe2fdec88f8368695c8d1331fc94b
27/07/2018 12:04:16.767 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.017 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.020 INFO - Site: win-container-demo - Container started successfully

6 - Mettre à jour localement et redéployer

  1. Dans Visual Studio, dans l’Explorateur de solutions, ouvrez Vues>Accueil>Index.cshtml.

  2. Recherchez la balise HTML <div class="jumbotron"> vers le début, puis remplacez la totalité de l’élément par le code suivant :

    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
        <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    
  3. Pour effectuer un redéploiement sur Azure, cliquez avec le bouton droit sur le projet myfirstazurewebapp dans l’Explorateur de solutions, puis choisissez Publier.

  4. Dans la page de publication, sélectionnez Publier et attendez la fin de la publication.

  5. Pour indiquer à App Service qu’il faut tirer la nouvelle image de Docker Hub, redémarrez l’application. De retour dans la page d’application du portail, cliquez sur Redémarrer>Oui.

    Capture d’écran de la vue d’ensemble d’App Service avec le bouton Redémarrer mis en évidence.

Accédez de nouveau au conteneur personnalisé. Quand vous actualisez la page web, l’application doit d’abord revenir à la page « Démarrage », puis afficher quelques minutes après la page web mise à jour.

Capture d’écran de l’application web mise à jour dans Azure.

7 - Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.

Étapes suivantes

Ou consultez les autres ressources :

Azure App Service sur Linux fournit des piles d’applications prédéfinies sur Linux avec la prise en charge de langages comme .NET, PHP, Node.js, etc. Vous pouvez également utiliser une image Docker personnalisée pour exécuter votre application web sur une pile d’applications qui n’est pas encore définie dans Azure. Ce guide de démarrage rapide vous montre comment déployer une image à partir d’un ACR (Azure Container Registry) vers App Service.

Notes

Pour plus d’informations sur l’exécution d’applications conteneurisées dans un environnement serverless, consultez Container Apps.

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

1 - Créer un registre de conteneurs

Ce guide de démarrage rapide utilise Azure Container Registry comme registre de choix. Vous pouvez utiliser d’autres registres, mais la procédure risque de légèrement différer.

Créez un registre de conteneurs en suivant les instructions de la section Démarrage rapide : Créer un registre de conteneurs privé à l’aide du portail Azure.

Important

Veillez à définir l’option Utilisateur administrateur sur Activer lorsque vous créez le registre de conteneurs. Vous pouvez également la définir à partir de la section Clés d’accès de votre page de registre dans le portail Azure. Ce paramètre est nécessaire pour l’accès à App Service. Pour l’identité managée, consultez le tutoriel Déployer à partir d’ACR.

2 - Se connecter

  1. Lancez Visual Studio Code.

  2. Sélectionnez le logo Azure dans la barre d’activités, accédez à l’explorateur APP SERVICE, puis sélectionnez Se connecter à Azure et suivez les instructions qui s’affichent.

    Capture d’écran de la connexion à Azure dans Visual Studio Code.

  3. Dans la barre d’état en bas, vérifiez l’adresse e-mail de votre compte Azure. Dans l’explorateur APP SERVICE, votre abonnement doit s’afficher.

  4. Dans la barre d’activités, sélectionnez le logo Docker . Dans l’explorateur REGISTRES, vérifiez que le registre de conteneurs que vous avez créé s’affiche.

    Capture d’écran montrant la valeur des registres avec Azure développé.

3 - Vérifier les prérequis

Vérifiez que Docker est installé et en cours d’exécution. La commande suivante affiche la version de Docker s’il est en cours d’exécution.

docker --version

4 - Créer et générer une image

  1. Dans Visual Studio Code, ouvrez un dossier vide et ajoutez un fichier appelé Dockerfile. Dans le fichier Dockerfile, collez le contenu en fonction de l’infrastructure de langage de votre choix :
FROM mcr.microsoft.com/appsvc/dotnetcore:lts

ENV PORT 8080
EXPOSE 8080

ENV ASPNETCORE_URLS "http://*:${PORT}"

ENTRYPOINT ["dotnet", "/defaulthome/hostingstart/hostingstart.dll"]

Dans ce fichier Dockerfile, l’image parente correspond à l’un des conteneurs .NET intégrés d’App Service. Les fichiers sources correspondants sont disponibles dans le référentiel GitHub Azure-App-Service/ImageBuilder, sous GenerateDockerFiles/dotnetcore. Son fichier Dockerfile copie une application simple .NET dans /defaulthome/hostingstart. Votre fichier Dockerfile démarre simplement cette application.

  1. Ouvrez la palette de commandes, puis saisissez Images Docker : Générer une image. Appuyez sur Entrée pour exécuter la commande.

  2. Dans la zone d’étiquette d’image, spécifiez l’étiquette souhaitée au format suivant : <acr-name>.azurecr.io/<image-name>/<tag>, où <acr-name> correspond au nom du registre de conteneurs que vous avez créé. Appuyez sur Entrée.

  3. Une fois la génération de l’image terminée, cliquez sur Actualiser en haut de l’explorateur IMAGES et vérifiez que l’image a bien été générée.

    Capture d’écran montrant l’image générée avec l’étiquette.

5 - Déployer sur le registre de conteneurs

  1. Dans la barre d’activité, cliquez sur l’icône Docker. Dans l’explorateur IMAGES , recherchez l’image que vous venez de générer.

  2. Développez l’image, cliquez avec le bouton droit sur l’étiquette souhaitée, puis cliquez sur Push (envoyer) .

  3. Assurez-vous que l’étiquette d’image commence par <acr-name>.azurecr.io et appuyez sur Entrée.

  4. Quand Visual Studio Code finit d’envoyer (push) l’image vers votre registre de conteneurs, cliquez sur Actualiser en haut de l’explorateur REGISTRES et vérifiez que l’image a bien été envoyée (push).

    Capture d’écran montrant l’image déployée dans Azure Container Registry.

6 - Déployer sur App Service

  1. Dans l’explorateur REGISTRES, développez l’image, cliquez avec le bouton droit sur l’étiquette, puis sélectionnez Déployer l’image sur Azure App Service.
  2. Suivez les invites pour choisir un abonnement, un nom d’application global unique, un groupe de ressources et un plan App Service. Choisissez B1 De base comme niveau tarifaire et une région près de vous.

Une fois le déploiement effectué, votre application est disponible à l’adresse http://<app-name>.azurewebsites.net.

Un groupe de ressources est une collection nommée de toutes les ressources de votre application dans Azure. Par exemple, un groupe de ressources peut contenir une référence à un site web, une base de données et une fonction Azure.

Un plan App Service définit les ressources physiques qui seront utilisées pour héberger votre site web. Ce guide de démarrage rapide utilise un plan d’hébergement De base sur l’infrastructure Linux, ce qui signifie que le site sera hébergé sur une machine Linux avec d’autres sites web. Si vous commencez avec le plan De base, vous pouvez utiliser le portail Azure pour effectuer un scale-up afin que votre site soit le seul à s’exécuter sur un ordinateur. Pour plus d’informations sur la tarification, consultez Tarification d’App Service.

7 - Parcourir le site web

Le panneau Sortie indique l’état des opérations de déploiement. Une fois l’opération terminée, sélectionnez Ouvrir le site dans la notification contextuelle pour ouvrir le site dans votre navigateur.

8 - Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.

Étapes suivantes

Félicitations, vous avez terminé ce démarrage rapide.

L’application App Service extrait l’image à partir du registre de conteneurs à chaque fois qu’elle démarre. Pour regénérer votre image, il vous suffit de la transmettre à votre registre de conteneurs, après quoi l’application procédera à l’extraciton de l’image mise à jour lors au moment de son redémarrage. Pour indiquer à votre application d’extraire immédiatement l’image mise à jour, redémarrez-la.

Autres extensions Azure :

Azure App Service sur Linux fournit des piles d’applications prédéfinies sur Linux avec la prise en charge de langages comme .NET, PHP, Node.js, etc. Vous pouvez également utiliser une image Docker personnalisée pour exécuter votre application web sur une pile d’applications qui n’est pas encore définie dans Azure. Ce guide de démarrage rapide vous montre comment déployer une image à partir d’Azure Container Registry sur Azure App Service.

Notes

Pour plus d’informations sur l’exécution d’applications conteneurisées dans un environnement serverless, consultez Container Apps.

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

1 - Clonez l’exemple de dépôt

Clonez l’exemple d’application .NET 6.0 avec la commande suivante :

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2- Envoyez (push) l’image sur Azure Container Registry

Vérifiez que vous êtes dans le dossier racine du dépôt cloné. Ce dépôt contient un fichier Dockerfile.linux.

  1. Connectez-vous à Azure CLI.

    az login
    
  2. Connectez-vous à Azure Container Registry.

    az acr login -n <your_registry_name>
    
  3. Générez l’image de conteneur. Nous nommons l’image dotnetcore-docs-hello-world-linux.

    docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux . 
    
  4. L'envoi (push) de l'image conteneur à Azure Container Registry.

    docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
    

    Notes

    Le Dockerfile définit le numéro de port sur 80 en interne. Pour plus d’informations sur la configuration du conteneur, consultez Configurer un conteneur personnalisé.

3 - Déployer sur Azure

Se connecter au portail Azure

Connectez-vous au portail Azure sur https://portal.azure.com.

Créer des ressources Azure

  1. Saisissez app services dans la zone de recherche. Sous Services, sélectionnez App Services.

    Capture d’écran de la recherche de « app services » (services d’applications) dans le portail Azure.

  2. Dans la page App Services, sélectionnez +Créer.

  3. Dans l’onglet De base, sous Détails du projet, vérifiez que l’abonnement approprié est sélectionné, puis choisissez de Créer un groupe de ressources. Tapez myResourceGroup comme nom.

    Capture d’écran de la section Détails du projet montrant où vous sélectionnez l’abonnement Azure et le groupe de ressources pour l’application web.

  4. Sous Détails de l’instance, tapez un nom global unique pour votre application web et sélectionnez Conteneur Docker. Sélectionnez Linux comme Système d’exploitation. Sélectionnez une Région à partir de laquelle vous voulez servir votre application.

    Capture d’écran de la section Détails de l’instance où vous spécifiez un nom pour la machine virtuelle et où vous sélectionnez sa région, son image et sa taille.

  5. Sous Plan App Service, choisissez de créer un nouveau plan App Service. Saisissez myAppServicePlan comme nom. Pour passer au niveau Gratuit, sélectionnez Modifier la taille, l’onglet Dev/Test, F1, puis le bouton Appliquer dans le bas de la page.

    Capture d’écran de la section Compte d’administrateur où vous fournissez le nom d’utilisateur et le mot de passe de l’administrateur.

  6. Sélectionnez le bouton Suivant : Docker> dans le bas de la page.

  7. Sous l’onglet Docker, sélectionnez Conteneur unique sous Options et Azure Container Registry pour la Source de l’image. Sous Options Azure Container Registry, définissez les valeurs suivantes :

    • Registre : Sélectionnez votre registre de conteneurs Azure.
    • Image : sélectionnez dotnetcore-docs-hello-world-linux.
    • Étiquette : Sélectionnez La plus récente.

    Capture d’écran montrant les options d’Azure Container Registry.

  8. Sélectionnez le bouton Vérifier + créer au bas de la page.

    Capture d’écran montrant le bouton Vérifier + créer dans le bas de la page.

  9. Une fois la validation exécutez, sélectionnez le bouton Créer en bas de la page.

  10. Une fois le déploiement effectué, sélectionnez Accéder à la ressource.

    Capture d’écran montrant l’étape suivante d’accès à la ressource.

4 – Accéder à l’application

Accédez à l’application déployée à l’aide de votre navigateur web à l’URL http://<app-name>.azurewebsites.net.

Capture d’écran montrant l’application déployée.

5 - Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.

Étapes suivantes

Félicitations, vous avez terminé ce démarrage rapide.

L’application App Service extrait l’image à partir du registre de conteneurs à chaque fois qu’elle démarre. Pour regénérer votre image, il vous suffit de la transmettre à votre registre de conteneurs, après quoi l’application procédera à l’extraciton de l’image mise à jour lors au moment de son redémarrage. Pour indiquer à votre application d’extraire immédiatement l’image mise à jour, redémarrez-la.

Azure App Service fournit des piles d’applications prédéfinies sur Windows, par exemple ASP.NET ou Node.js, exécuté sur IIS. Toutefois, les piles d’applications préconfigurées verrouillent le système d’exploitation et empêchent un accès de bas niveau. Les conteneurs Windows personnalisés n’ont pas ces restrictions et permettent aux développeurs de personnaliser entièrement les conteneurs et de fournir aux applications conteneurisées un accès complet aux fonctionnalités de Windows.

Ce guide de démarrage rapide vous montre comment déployer une application ASP.NET dans une image Windows depuis Azure Container Registry sur Azure App Service.

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

1 - Clonez l’exemple de dépôt

Clonez l’exemple d’application .NET 6.0 avec la commande suivante :

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2- Envoyez (push) l’image sur Azure Container Registry

Vérifiez que vous êtes dans le dossier racine du dépôt cloné. Ce dépôt contient un fichier Dockerfile.windows. Nous allons utiliser Windows Nano Server Long Term Maintenance Channel (LTSC) 2022 comme système d’exploitation de base, appelant explicitement notre base Windows.

Notes

Même s’il s’agit d’un conteneur Windows, les chemins doivent toujours utiliser des barres obliques. Pour plus d’informations, consultez Écrire un fichier Dockerfile.

  1. Connectez-vous à Azure CLI.

    az login
    
  2. Connectez-vous à Azure Container Registry.

    az acr login -n <your_registry_name>
    
  3. Générez l’image de conteneur. Nous nommons l’image dotnetcore-docs-hello-world-windows.

    docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows . 
    
  4. L'envoi (push) de l'image conteneur à Azure Container Registry.

    docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
    

    Notes

    Le Dockerfile définit le numéro de port sur 80 en interne. Pour plus d’informations sur la configuration du conteneur, consultez Configurer un conteneur personnalisé.

3 - Déployer sur Azure

Se connecter au portail Azure

Connectez-vous au portail Azure sur https://portal.azure.com.

Créer des ressources Azure

  1. Saisissez app services dans la zone de recherche. Sous Services, sélectionnez App Services.

    Capture d’écran de la recherche de « app services » (services d’applications) dans le portail Azure.

  2. Dans la page App Services, sélectionnez +Créer.

  3. Dans l’onglet De base, sous Détails du projet, vérifiez que l’abonnement approprié est sélectionné, puis choisissez de Créer un groupe de ressources. Tapez myResourceGroup comme nom.

    Capture d’écran de la section Détails du projet montrant où vous sélectionnez l’abonnement Azure et le groupe de ressources pour l’application web.

  4. Sous Détails de l’instance, tapez un nom global unique pour votre application web et sélectionnez Conteneur Docker. Sélectionnez Windows comme Système d’exploitation. Sélectionnez une Région à partir de laquelle vous voulez servir votre application.

    Capture d’écran de la section Détails de l’instance où vous spécifiez un nom pour la machine virtuelle et où vous sélectionnez sa région, son image et sa taille.

  5. Sous Plan App Service, choisissez de créer un nouveau plan App Service. Saisissez myAppServicePlan comme nom. Pour passer au niveau Gratuit, sélectionnez Modifier la taille, l’onglet Dev/Test, P1v3, puis le bouton Appliquer dans le bas de la page.

    Capture d’écran de la section Compte d’administrateur où vous fournissez le nom d’utilisateur et le mot de passe de l’administrateur.

  6. Sélectionnez le bouton Suivant : Docker> dans le bas de la page.

  7. Dans l’onglet Docker, sélectionnez Azure Container Registry pour la Source de l’image. Sous Options Azure Container Registry, définissez les valeurs suivantes :

    • Registre : Sélectionnez votre registre de conteneurs Azure.
    • Image : sélectionnez dotnetcore-docs-hello-world-windows.
    • Étiquette : Sélectionnez La plus récente.

    Capture d’écran montrant les options d’Azure Container Registry.

  8. Sélectionnez le bouton Vérifier + créer au bas de la page.

    Capture d’écran montrant le bouton Vérifier + créer dans le bas de la page.

  9. Une fois la validation exécutez, sélectionnez le bouton Créer en bas de la page.

  10. Une fois le déploiement effectué, sélectionnez Accéder à la ressource.

    Capture d’écran montrant l’étape suivante d’accès à la ressource.

4 – Accéder à l’application

Accédez à l’application déployée à l’aide de votre navigateur web à l’URL http://<app-name>.azurewebsites.net.

Capture d’écran du service App Service Windows avec un message indiquant que les conteneurs qui n’ont pas de port exposé s’exécuteront en mode Arrière-plan.

Notez que le système d’exploitation hôte apparaît dans le pied de page, confirmant que nous exécutons dans un conteneur Windows.

5 - Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.

Étapes suivantes

Félicitations, vous avez terminé ce démarrage rapide.

L’application App Service extrait l’image à partir du registre de conteneurs à chaque fois qu’elle démarre. Pour regénérer votre image, il vous suffit de la transmettre à votre registre de conteneurs, après quoi l’application procédera à l’extraciton de l’image mise à jour lors au moment de son redémarrage. Pour indiquer à votre application d’extraire immédiatement l’image mise à jour, redémarrez-la.

Azure App Service fournit des piles d’applications prédéfinies sur Windows, par exemple ASP.NET ou Node.js, exécuté sur IIS. Toutefois, les piles d’applications préconfigurées verrouillent le système d’exploitation et empêchent un accès de bas niveau. Les conteneurs Windows personnalisés n’ont pas ces restrictions et permettent aux développeurs de personnaliser entièrement les conteneurs et de fournir aux applications conteneurisées un accès complet aux fonctionnalités de Windows.

Ce guide de démarrage rapide vous montre comment déployer une application ASP.NET dans une image Windows depuis Microsoft Artifact Registry sur Azure App Service.

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

1 - Se connecter à Azure

Connectez-vous à votre compte Azure à l’aide de la commande Connect-AzAccount et suivez les instructions de l’invite :

Connect-AzAccount

2 - Créer un groupe de ressources

Créez un groupe de ressources avec la commande New-AzResourceGroup. Un groupe de ressources Azure est un conteneur logique dans lequel les ressources Azure sont déployées et gérées.

L’exemple suivant crée un groupe de ressources nommé myResourceGroup à l’emplacement eastus. Pour afficher tous les emplacements pris en charge pour App Service, exécutez la commande Get-AzLocation.

New-AzResourceGroup -Name myResourceGroup -Location eastus

Une fois l’opération terminée, la commande renvoie Login Succeeded.

3 - Créer votre plan App Service

Créez un plan App Service en utilisant la commande New-AzAppServicePlan.

L’exemple suivant crée un plan App Service nommé myAppServicePlan dans le niveau tarifaire PremiumV3 (-Tier PremiumV3). Le paramètre -HyperV spécifie le conteneur Windows.

New-AzAppServicePlan -Name myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -Tier PremiumV3 -HyperV

4 - Créer votre application web

Créez une application à l’aide de la commande New-AzWebApp :

New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest
  • Le paramètre Name spécifie le nom de l’application web.
  • Le paramètre AppServicePlan spécifie le nom du plan App Service.
  • Le paramètre Location spécifie l’emplacement.
  • Le paramètre ResourceGroupName spécifie le nom du groupe de ressources.
  • Le paramètre ContainerImageName spécifie un nom d’image conteneur et une étiquette facultative.

L’exécution de la commande peut prendre quelques instants.

5 - Accéder à l’application

Accédez à l’application déployée à l’aide de votre navigateur web à l’URL http://<app-name>.azurewebsites.net.

Capture d’écran du service App Service Windows avec un message indiquant que les conteneurs qui n’ont pas de port exposé s’exécuteront en mode Arrière-plan.

6 - Nettoyer les ressources

Supprimez le groupe de ressources en utilisant la commande Remove-AzResourceGroup :

Remove-AzResourceGroup myResourceGroup

Étapes suivantes

Félicitations, vous avez terminé ce démarrage rapide.

L’application App Service extrait l’image à partir du registre de conteneurs à chaque fois qu’elle démarre. Pour regénérer votre image, il vous suffit de la transmettre à votre registre de conteneurs, après quoi l’application procédera à l’extraciton de l’image mise à jour lors au moment de son redémarrage. Pour indiquer à votre application d’extraire immédiatement l’image mise à jour, redémarrez-la.

Azure App Service fournit des piles d’applications prédéfinies sur Windows, par exemple ASP.NET ou Node.js, exécuté sur IIS. Toutefois, les piles d’applications préconfigurées verrouillent le système d’exploitation et empêchent un accès de bas niveau. Les conteneurs Windows personnalisés n’ont pas ces restrictions et permettent aux développeurs de personnaliser entièrement les conteneurs et de fournir aux applications conteneurisées un accès complet aux fonctionnalités de Windows.

Ce guide de démarrage rapide vous montre comment déployer une application ASP.NET dans une image Windows depuis Microsoft Artifact Registry sur Azure App Service.

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

1 - Se connecter à Azure

Connectez-vous à votre compte Azure à l’aide de la commande az login et suivez les instructions de l’invite :

az login

2 - Créer un groupe de ressources

Créez un groupe de ressources avec la commande az group create. Un groupe de ressources Azure est un conteneur logique dans lequel les ressources Azure sont déployées et gérées.

L’exemple suivant crée un groupe de ressources nommé myResourceGroup à l’emplacement eastus. Pour afficher tous les emplacements pris en charge pour App Service, exécutez la commande az appservice list-locations.

az group create --name myResourceGroup --location eastus

3 - Créer votre plan App Service

Créez un plan App Service dans le groupe de ressources avec la commande az appservice plan create.

L’exemple suivant crée un plan App Service nommé myAppServicePlan dans le niveau tarifaire P1V3 (--sku P1V3).

az appservice plan create --resource-group myResourceGroup --location eastus --name myAppServicePlan --hyper-v --sku p1v3

Notes

Si vous rencontrez l’erreur « Le comportement de cette commande a été modifié par l’extension suivante : appservice-kube », supprimez l’extension appservice-kube.

4 - Créer votre application web

Créez une application web de conteneur personnalisé dans le plan App Service myAppServicePlan avec la commande az webapp create. N’oubliez pas de remplacer myContainerApp par un nom d’application unique (les caractères valides sont a-z, 0-9 et -).

az webapp create --name myContainerApp --plan myAppServicePlan --location eastus --resource-group myResourceGroup --deployment-container-image-name mcr.microsoft.com/azure-app-service/windows/parkingpage:latest
  • Le paramètre Name spécifie le nom de l’application web.
  • Le paramètre AppServicePlan spécifie le nom du plan App Service.
  • Le paramètre Location spécifie l’emplacement.
  • Le paramètre ResourceGroupName spécifie le nom du groupe de ressources.
  • Le paramètre deployment-container-image-name spécifie un nom d’image conteneur et une étiquette facultative.

5 - Accéder à l’application

Accédez à l’application déployée à l’aide de votre navigateur web à l’URL http://<app-name>.azurewebsites.net.

Capture d’écran du service App Service Windows avec un message indiquant que les conteneurs qui n’ont pas de port exposé s’exécuteront en mode Arrière-plan.

6 - Nettoyer les ressources

Supprimez le groupe de ressources en utilisant la commande az group delete :

az group delete --no-wait --name <resource_group>

Étapes suivantes

Félicitations, vous avez terminé ce démarrage rapide.

L’application App Service extrait l’image à partir du registre de conteneurs à chaque fois qu’elle démarre. Pour regénérer votre image, il vous suffit de la transmettre à votre registre de conteneurs, après quoi l’application procédera à l’extraciton de l’image mise à jour lors au moment de son redémarrage. Pour indiquer à votre application d’extraire immédiatement l’image mise à jour, redémarrez-la.