Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :
- Un compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Azure Developer CLI est installée.
- Pour l’exemple de .NET, le SDK .NET 10 est requis.
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
azdun projet. - Crée un environnement qui stocke les paramètres de déploiement, tels que votre abonnement Azure et votre emplacement, sous le
.azureré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 :
- Provisionner : Crée les ressources Azure définies par les fichiers infrastructure-as-code du modèle.
- 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.
- 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.
Sélectionnez le lien vers le groupe de ressources dans Azure portal dans la sortie pour afficher les ressources que
azda approvisionnées.
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.
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.
- Ouvrez
src/app/templates/home.html. - Recherchez le
<h1>Hello, customized template!</h1>titre. - 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.
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.