Démarrage rapide : Déployer un modèle Azure Developer CLI

L’interface CLI Azure développeur (azd) est un outil en ligne de commande open source qui remplace l’installation et la configuration manuelles par des commandes cohérentes pour la création et le déploiement d’applications sur Azure.

Dans ce guide de démarrage rapide, vous initialisez un exemple de modèle et le déployez sur Azure. Vous obtenez une application en cours d'exécution sur Azure et un projet local réutilisable que vous pouvez redéployer, personnaliser ou supprimer lorsque vous avez terminé.

Prérequis

Avant de commencer, vérifiez que vous disposez des conditions préalables suivantes :

Remarque

Les deux exemples génèrent des images conteneur à distance dans Azure. L'exemple Python ne nécessite pas d'installation Python locale pour le déploiement. L’exemple .NET nécessite toujours un KIT DE développement logiciel (SDK) .NET local, car son hook postprovision s’exécute dotnet user-secrets set.

Comprendre les modèles azd

Un azd modèle est un référentiel source qui contient tout ce dont azd a besoin pour fonctionner avec une application. Vous pouvez créer votre propre modèle pour une application nouvelle ou existante, ou commencer à partir d’un modèle existant et le personnaliser. Dans ce guide de démarrage rapide, vous utilisez un exemple de modèle pour vous concentrer sur le flux de travail principal azd .

La structure suivante montre une vue simplifiée et de niveau supérieur d’un modèle classique :

|-- src/         # Application source code
|-- infra/       # Azure resources defined as infrastructure as code
|-- azure.yaml   # azd project configuration
`-- .azure/      # Local environment settings

Pour obtenir la répartition complète de ces fichiers, consultez Explorer et modifier les fichiers de modèle.

Initialiser le modèle

Dans le répertoire parent où vous souhaitez stocker le projet, sélectionnez un exemple de référentiel et exécutez azd init:

Cette option utilise le dépôt d’exemple hello-azd-python.

azd init --template hello-azd-python

azd prend en charge de nombreux langages, frameworks et conteneurs. Pour plus d’informations, consultez Langues et environnements pris en charge.

Lorsque vous y êtes invité, entrez un nom d’environnement court, tel que dev. Une fois l’initialisation terminée, ouvrez le nouveau répertoire de projet dans votre terminal avant de continuer.

La commande azd init :

  • Télécharge le modèle sélectionné dans le nouveau répertoire du projet.
  • Initialise le nouveau répertoire en tant que azd un projet.
  • Crée un environnement qui stocke les paramètres de déploiement, tels que votre abonnement Azure et votre emplacement, sous le .azure répertoire.

La commande ne crée ni ne déploie aucune ressource Azure.

Connectez-vous à Azure

Exécutez la commande suivante, puis connectez-vous via le navigateur :

azd auth login

Approvisionner et déployer les ressources de l’application

Exécutez la commande suivante :

azd up

Lorsque vous y êtes invité, sélectionnez l’abonnement Azure et l’emplacement à utiliser. Le premier déploiement peut prendre plusieurs minutes, car azd up exécute le workflow de déploiement complet :

  1. Provisionner : Crée les ressources Azure définies par les fichiers infrastructure-as-code du modèle.
  2. Package : Génère et empaquette l’application pour le déploiement. L’exemple utilise une build de conteneur distante, de sorte que la build s’exécute dans Azure.
  3. Déployer : Déploie l’application empaquetée sur la ressource d’hébergement provisionnée.

Le modèle définit les ressources de prise en charge, telles que les identités managées, les attributions de rôles et les paramètres d’application, dans les fichiers Bicep sous le répertoire infra et la configuration du projet azure.yaml, et azd les déploie avec l’application. Pour en savoir plus sur ces fichiers, consultez Explorer et modifier des fichiers de modèle.

Vous pouvez réexécuter azd up après avoir modifié l’application ou l’infrastructure. azd met à jour l’environnement existant au lieu de créer un déploiement distinct.

Explorer l’application déployée

Une fois azd up terminé, il imprime des liens vers les ressources approvisionnées et l’application en cours d’exécution dans la sortie de commande.

  1. Sélectionnez le lien vers le groupe de ressources dans Azure portal dans la sortie pour afficher les ressources que azd a approvisionnées.

    Capture d’écran d’un groupe de ressources Azure dans le portail Azure qui contient les ressources configurées pour l’exemple d’application.

  2. Sélectionnez le lien de point de terminaison de l’application dans la sortie pour ouvrir l’application en cours d’exécution dans un navigateur.

    Capture d’écran de la page d’accueil de l’exemple d’application déployé s’exécutant dans un navigateur.

Apporter une modification et redéployer

Si vous le souhaitez, apportez une petite modification à l’exemple d’application, puis redéployez simplement le code de l’application avec azd deploy.

  1. Ouvrez src/app/templates/home.html.
  2. Recherchez le <h1>Hello, customized template!</h1> titre.
  3. Remplacez le texte du titre par <h1>Hello from your azd template!</h1>, puis enregistrez le fichier.

Cette modification affecte uniquement la source de l’application. Vous n’avez donc pas besoin de reprovisionner l’infrastructure. Redéployez le code mis à jour :

azd deploy

La commande azd deploy empaquette et déploie uniquement le code de l’application, tandis que azd up exécute le workflow complet de provisionnement, d’empaquetage et de déploiement. Une fois la commande terminée, ouvrez le point de terminaison de l’application à partir de la sortie de la commande. La page d’accueil affiche le titre mis à jour.

Capture d’écran de l’application hello-azd déployée avec un titre personnalisé.

Nettoyer les ressources

Lorsque vous avez terminé, exécutez la commande suivante pour supprimer les ressources Azure et éviter les frais en cours :

azd down

Quand vous y êtes invité, confirmez la suppression. Cette commande supprime les ressources configurées azd pour l’environnement actuel, mais conserve les fichiers projet locaux.

Étape suivante

Demander de l’aide

Pour plus d’informations sur la façon de déposer un bogue, de demander de l’aide ou de proposer une nouvelle fonctionnalité pour l’interface CLI Azure développeur, visitez la page troubleshooting et support.