Générer Bicep à l’aide de la fonctionnalité de composition

La fonctionnalité de composition azure Developer CLI (azd) simplifie le processus de création, de déploiement et de gestion des applications cloud. En utilisant azd compose, vous pouvez définir et gérer l’infrastructure et le code d’application de votre projet de manière unifiée. Ce guide explique comment générer du code Bicep à partir de la azd compose fonctionnalité, ce qui vous permet de personnaliser votre infrastructure cloud pour répondre à vos besoins spécifiques.

Comment azd compose gère l'état de l'infrastructure

La fonctionnalité azd compose suit l'état de votre infrastructure en mémoire lors du processus de composition. Cette approche vous permet de définir et d’affiner de manière itérative votre application et votre infrastructure sans générer immédiatement des fichiers ou modifier votre répertoire de projet.

Lorsque vous exécutez la azd infra synth commande, l’état en mémoire est converti en fichiers Bicep dans le infra dossier. À ce stade, l’état de l’infrastructure passe de la gestion en mémoire à la représentation en tant que code, ce qui permet une personnalisation supplémentaire.

Conseil / Astuce

Permet azd compose de prototyper rapidement votre infrastructure avant de valider les modifications basées sur des fichiers avec azd infra synth.

Générer le code Bicep

Pour explorer ou personnaliser le code Bicep utilisé en interne par azd pour provisionner des ressources créées par azd add, exécutez la commande suivante :

azd infra gen

Remarque

La azd infra synth commande des versions antérieures d’azd azd est désormais un alias d’azd infra generateet continuera à fonctionner. Toutefois, un message d’avertissement s’affiche et la commande peut être supprimée dans une prochaine azd version.

Cette commande génère les fichiers Bicep correspondants dans le infra dossier de votre application.

Gestion des mises à jour avec la génération Bicep

Lorsque vous exécutez la azd infra gen commande, vous quittez le azd compose flux de travail et le processus d’init simplifié. À partir de ce stade, les modifications que vous apportez aux fichiers Bicep générés ne sont plus suivies par azd compose. Si vous modifiez les fichiers Bicep et que vous réexécutez azd infra gen ultérieurement, vos modifications manuelles seront remplacées par le code nouvellement généré.

Voici comment un flux de travail classique peut ressembler :

1. Vous utilisez azd add pour ajouter de nouvelles ressources Azure à votre projet. Ces ressources sont gérées en interne par azd.
2. Une fois que vous avez terminé d’ajouter des ressources, vous exécutez azd infra gen pour générer des fichiers Bicep pour ces ressources dans le dossier du infra projet. À ce stade, les ressources ne sont plus gérées par le azd compose flux de travail.
3. Vous pouvez maintenant mettre à jour manuellement les fichiers Bicep lors du développement de votre application.
4. Si vous ajoutez plus de ressources ou que vous réexécutez azd infra gen , le contenu du infra dossier sera régénéré et toutes les modifications manuelles seront perdues.

Pour cette raison, la fonctionnalité de composition convient le mieux aux scénarios suivants :

• Création d’un ensemble initial de ressources Azure pour votre projet, puis gestion des mises à jour supplémentaires vous-même en modifiant les fichiers Bicep.
• Gestion de vos ressources Azure entièrement à l'aide de la fonctionnalité de composition sans avoir à exécuter azd infra gen.

Étapes suivantes

Présentation de la création de modèles Azure Developer CLI