Déployer votre premier modèle

  • 6 minutes

Azure Developer CLI (azd) s’appuie sur des commandes conviviales pour les développeurs et sur des modèles d’application fondamentaux. Les commandes sont mappées aux tâches courantes de workflow de développement, comme le provisionnement ou le déploiement de ressources. Les modèles comprennent l’ensemble des ressources de configuration et de code source nécessaires pour effectuer ces tâches. Vous pouvez commencer à utiliser azd en travaillant à partir d’un des exemples de modèles existants et extensibles, ou en créant le vôtre.

Pour bien démarrer avec azd, il s’avère souvent plus facile de trouver un modèle existant qui correspond étroitement à l’architecture d’environnement souhaitée et de l’utiliser comme point de départ. Vous pouvez découvrir un grand nombre de modèles disponibles sur le site Awesome AZD. Vous pouvez également afficher la liste des modèles disponibles à l’aide de la commande suivante :

azd template list

Pour cet exemple, vous allez utiliser le modèle todo-nodejs-mongo existant créé autour de la pile Node.js et MongoDB. Même si vous n’avez jamais utilisé ces technologies, vous pouvez effectuer les étapes à venir parce que azd gère la plupart du travail pour vous. Ce modèle crée un ensemble de ressources dans Azure qui sont similaires à celles décrites dans l’exemple de scénario présenté au début du module.

Remarque

Les étapes azd décrites dans ce module s’appliquent également aux modèles qui s’appuient sur d’autres langages ou technologies, comme C# ou Python.

Déployer le modèle

Le workflow de démarrage le plus courant pour azd nécessite quelques commandes uniquement. Vous allez découvrir d’autres commandes et options dans la suite du module pour effectuer des tâches supplémentaires. Pour initialiser et déployer un modèle azd, procédez comme suit :

  1. Ouvrez une invite de commandes dans un répertoire de fichiers vide.

  2. Exécutez la commande azd init et spécifiez le modèle que vous souhaitez utiliser comme paramètre. azd va cloner le modèle dans votre environnement local.

    azd init --template todo-nodejs-mongo

  3. Quand la commande vous invite à entrer un nom d’environnement, entrez azdlearn. Le nom de l’environnement influence le nommage de certaines ressources dans Azure.

  4. Exécutez la commande azd auth login pour lancer une fenêtre de navigateur qui vous permet de vous connecter à votre compte Azure.

    azd auth login

  5. Exécutez la commande azd up pour provisionner et déployer les ressources de modèle sur Azure. Quand vous y êtes invité, sélectionnez l’abonnement et l’emplacement de votre choix pour le déploiement.

    azd up

L’exécution de la commande azd up peut prendre plusieurs minutes. Chaque modèle provisionne des ressources et configurations Azure différentes, ce qui signifie que la durée nécessaire varie pour les différents modèles. Les mises à jour doivent s’imprimer dans la console au fur et à mesure que le processus s’exécute. Une fois l’opération terminée, un lien s’affiche vers le site déployé. Un lien s’affiche également vers le processus de déploiement dans Azure, que vous pouvez consulter pour afficher des informations supplémentaires sur le déploiement.

L’application déployée doit ressembler à la capture d’écran suivante :

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

Vous pouvez également afficher les ressources qui ont été créées dans Azure en accédant à votre groupe de ressources dans le portail Azure :

  1. Dans la barre de recherche principale du portail Azure, recherchez le groupe de ressources azd créé pour vous en tapant rg-azdlearn. Par convention, le groupe de ressources correspond au nom d’environnement que vous avez spécifié avec le préfixe rg-.

  2. Sélectionnez le groupe de ressources dans les résultats pour accéder à la page de présentation. La liste des différentes ressources qui ont été créées pour vous par azd doit s’afficher.

    Capture d’écran montrant les ressources déployées.

Analyser l’application

De nombreux modèles azd provisionnent également des ressources de supervision dans Azure, comme les tableaux de bord Application Insights. Ces tableaux de bord offrent des fonctionnalités de monitoring de l’intégrité des applications comme les métriques actives et la journalisation. Vous pouvez lancer ces tableaux de bord à l’aide de la commande azd monitor et de l’un des indicateurs suivants :

  • --overview : lance le tableau de bord principal.
  • --live : lance le tableau de bord des métriques en temps réel.
  • --logs : lance le tableau de bord de journalisation.

Exécutez par exemple la commande suivante dans votre terminal pour ouvrir le tableau de bord des métriques en temps réel :

azd monitor --live

Le navigateur doit lancer et afficher une page ressemblant à la capture d’écran suivante :

Capture d’écran montrant un tableau de bord des métriques.

Félicitations ! Vous avez provisionné, déployé et supervisé votre premier environnement d’application à l’aide de azd. Vous allez ensuite découvrir comment à mettre à jour le modèle et à déployer vos modifications.