Explorer et personnaliser un modèle Azure Developer CLI

Dans ce guide de démarrage rapide, vous allez explorer et personnaliser un modèle Azure Developer CLI. Le modèle hello-azd fournit un point de départ simple pour la création et le déploiement d’applications sur Azure à l’aide d’Azure Developer CLI (azd). Ce guide de démarrage rapide développe les concepts présentés dans l’article Guide de démarrage rapide - Déployer un modèle azd.

Conditions préalables

Pour suivre ce guide de démarrage rapide dans votre navigateur, vous aurez besoin des éléments suivants :

Accès à GitHub Codespaces

Vous pouvez également utiliser les outils locaux pour terminer ce démarrage rapide :

Azure Developer CLI installé sur votre ordinateur local
Visual Studio Code ou votre éditeur de votre choix
Bureau Docker installé sur votre ordinateur local

Explorer la structure du modèle Azure Developer CLI

azd les modèles sont des référentiels de code standard avec des ressources supplémentaires incluses. Tous les azd modèles partagent une structure de fichiers similaire en fonction des azd conventions :

infra dossier : contient l’ensemble des fichiers d'infrastructure Bicep ou Terraform sous forme de code pour le modèle azd. azd exécute ces fichiers pour créer les ressources Azure requises par votre application.
src dossier : contient le code source de l’application. azd emballe et déploie le code en fonction des configurations dans azure.yaml.
azure.yaml fichier : fichier de configuration qui associe les dossiers de code source de votre projet aux ressources Azure définies dans le dossier infra pour le déploiement. Par exemple, vous pouvez définir un service d’API et un service frontal web dans des dossiers distincts et les mapper à différentes ressources Azure pour le déploiement.
.azure dossier : contient des configurations Azure essentielles, telles que l’emplacement pour déployer des ressources.

Par exemple, la plupart des azd modèles correspondent à la structure de dossiers suivante :

Capture d’écran montrant une structure de modèle Azure Developer CLI.

Pour plus d'informations sur la structure du modèle, consultez l'article de présentation des modèles Azure Developer CLI.

Configurer l’exemple de modèle

hello-azd est un exemple de modèle conçu pour présenter les fonctionnalités essentielles de azd ce que vous pouvez déployer sur Azure à l’aide d’une seule commande. Le modèle fournit une interface utilisateur conviviale avec des informations sur azd et un petit outil de démonstration qui vous permet de charger et d’afficher des tickets de support.

Le modèle prend en charge les fonctionnalités suivantes :

Packagera et déploiera une application conteneurisée vers Azure Container Apps.
Crée les ressources Azure nécessaires par l’application, telles qu’une base de données Azure Cosmos DB
Peut configurer automatiquement un pipeline CI/CD à l’aide de la azd pipeline config commande

Procédez comme suit pour configurer le modèle :

Espaces de code
Visual Studio Code

Ouvrez le référentiel de modèles hello-azd sur GitHub.
Sélectionnez le bouton Code , puis sélectionnez Codespaces.
Créez un espace de code pour lancer un environnement de développement entièrement configuré dans votre navigateur. Vous devrez peut-être attendre un moment pour que l’environnement s’initialise.
Une fois l’environnement Codespaces chargé, initialisez le azd modèle à l’aide de la azd init commande :
```
azd init -t hello-azd
```
Lorsque vous y êtes invité, entrez un nom pour l'environnement azd, comme helloazd par exemple.

Dans un répertoire vide sur votre ordinateur local, clonez et initialisez le référentiel à l’aide de la azd init commande :
```
azd init -t hello-azd
```
Lorsque vous y êtes invité, entrez un nom pour l'environnement azd, comme helloazd par exemple.
Ouvrez le dossier du projet dans Visual Studio Code :
```
code .
```

Explorer le modèle

Avec le modèle ouvert dans votre outil de choix, vous pouvez parcourir la structure de dossiers pour explorer le fonctionnement des azd modèles :

Étendez le src répertoire pour afficher le code source de l'application.
- Le hello-azd modèle inclut une application .NET conteneurisée qui fournit une interface utilisateur simple pour en savoir plus sur azd les exemples de données de ticket et les gérer. azd prend également en charge d’autres langages tels que JavaScript et Python.
- Lorsque vous exécutez azd up, l’application est empaquetée en tant qu’image conteneur et déployée sur Azure Container Apps.

Développez le dossier infra pour explorer l'infrastructure sous forme de fichiers de code.

Ce modèle utilise des fichiers Bicep (.bicep) pour créer des ressources Azure, mais vous pouvez également utiliser Terraform (.tf).

Le main.bicep fichier crée des ressources Azure en référençant d’autres modules Bicep dans le infra dossier, comme un compte de stockage Azure :

// Omitted...

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
    name: 'storage'
    scope: rg
    params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
        {
        name: 'attachments'
        }
    ]
    }
}

// Omitted...

À la racine du modèle, ouvrez le azure.yaml fichier pour afficher les configurations essentielles du modèle :
- Le modèle définit un service appelé aca.
- La aca configuration du service indique azd de empaqueter et de déployer le code source dans le src dossier dans l’application conteneur Azure approvisionnée par les modules Bicep que vous avez explorés précédemment.
- Les docker configurations indiquent azd de empaqueter et de déployer l’application en tant que conteneur.
```
metadata:
  template: hello-azd-dotnet  # Specifies the template being used
name: azd-starter  # Name of the project
services:
  aca:  # Define the Azure Container App service
    project: ./src  # Path to the source code
    language: csharp  # Programming language
    host: containerapp  # Hosting service
    docker:
      path: ./Dockerfile  # Location of the Dockerfile
```

Mettre à jour le modèle

Vous pouvez apporter des modifications au modèle pour influencer l’application et les ressources déployées. Dans cet exemple, vous apportez deux petites modifications à l’application et explorez les résultats déployés :

Mettez à jour le texte de bienvenue dans l'en-tête de l'application avec votre propre message.
Mettez à jour le compte de stockage créé afin qu'il crée deux conteneurs blob au lieu d'un seul.

Pour apporter ces modifications, procédez comme suit :

Dans le src > Components > Pages dossier, ouvrez le Home.razor composant.
Remplacez le texte d’en-tête Hello, Azure Developer CLI ! en haut de la page par un message différent, tel que Hello, modèle personnalisé ! et enregistrez vos modifications.
```
<MudText Typo="Typo.h2" GutterBottom="true">Hello, customized template!</MudText>
```
Dans le infra dossier, ouvrez le main.bicep fichier.

Repérez le bloc de code Bicep vers la ligne 75 qui crée un compte de stockage et un conteneur blob :

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
  name: 'storage'
  scope: rg
  params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
      {
        name: 'attachments'
      }
    ]
  }
}

Remplacez le code par l’extrait de code suivant :

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
  name: 'storage'
  scope: rg
  params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
      {
        name: 'attachments'
      },
      {
        name: 'archive'
      }
    ]
  }
}

Exécuter le modèle

Après avoir apporté vos modifications, utilisez la azd up commande pour provisionner et déployer les ressources de l’application :

Ouvrez un terminal dans le répertoire du projet.
Pour provisionner et déployer le modèle, exécutez la azd up commande :
```
azd up
```
Cette commande va :
- Empaqueter l’application pour le déploiement
- Provisionner les ressources Azure requises
- Déployer votre application avec les modifications mises à jour
- Imprimer l’URL de l’application déployée
Pour voir votre application mise à jour en temps réel, ouvrez l’URL imprimée dans les logs de sortie de la azd console dans votre navigateur.
Pour afficher les deux conteneurs d’objets blob qui ont été créés, accédez au compte de stockage créé dans le portail Azure.

Conclusion

Dans ce guide de démarrage rapide, vous avez exploré la structure du modèle hello-azd, personnalisé son application et son infrastructure, et l'avez déployé sur Azure à l'aide de l'interface en ligne de commande du développeur Azure. Pour des scénarios plus avancés, explorez d’autres modèles ou explorez plus en détail la azd documentation.

Étapes suivantes

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-06-30