Les administrateurs créent des modèles d'application pour s'assurer que l'architecture de leur choix est utilisée par chaque équipe de développement. Cela vous aide à régir les ressources et les configurations que les développeurs utilisent dans leurs déploiements d'applications.
Une fois que vous avez créé un modèle d'application, les autres membres de votre espace peuvent y accéder. Vous pouvez également ajouter un modèle à un catalogue pour le partager avec d'autres espaces.
Les développeurs peuvent utiliser votre modèle pour créer et déployer une application. Lorsque les développeurs créent une application, ils peuvent configurer chaque composant à partir du modèle, mais ils ne peuvent pas en ajouter ni en supprimer. Le modèle génère du code Terraform que les développeurs peuvent télécharger ou déployer depuis App Design Center.
Ce document vous aide à concevoir, configurer et partager un modèle d'application à l'aide d'App Design Center.
Avant de commencer
Vous devez disposer de l'un des rôles suivants dans le dossier ou le projet de gestion pour lequel les applications sont activées :
- Administrateur Application Design Center (
roles/designcenter.admin) - Utilisateur Application Design Center (
roles/designcenter.user)
Créer un modèle d'application
Créez des modèles d'application pour partager la conception de votre architecture avec les équipes de développement. Vous pouvez ajouter les composants suivants à la conception de votre modèle :
Éléments : ressources de haut niveau qui vous aident à contrôler d'autres ressources. Par exemple, les comptes de service.
Services : interfaces réseau ou d'API consommées sur le réseau. Cloud Storage et Vertex AI en sont de bons exemples.
Charges de travail : déploiements binaires qui exécutent des fonctions métier. Par exemple, Cloud Run et Compute Engine.
Vous pouvez choisir parmi les composants suivants :
- Composants conçus par Google, intégrant les bonnes pratiques et les configurations de sécurité par défaut de Google Cloud .
- Vos propres composants que vous importez, basés sur vos propres modules Terraform.
Lorsque vous concevez votre modèle, App Design Center génère du code Terraform pour refléter les détails de conception et de configuration.
Spécifier les détails du modèle
Les détails du modèle vous aident à le catégoriser et à aider les développeurs à décider s'ils doivent l'utiliser.
Pour saisir les détails de votre modèle :
Dans le menu de navigation, cliquez sur Modèles.
Cliquez sur Créer un modèle.
Dans le champ ID du modèle, saisissez un identifiant unique pour le modèle. Ce champ est obligatoire.
Dans le champ Nom du modèle, saisissez un identifiant lisible par l'utilisateur à afficher dans la console Google Cloud .
Si vous ne fournissez pas de nom, l'ID du modèle est copié dans ce champ.
Dans le champ Description, saisissez une brève explication de l'objectif de l'application.
Cliquez sur Créer un modèle. Le canevas de conception s'affiche.
Concevoir votre modèle
Concevez votre modèle en ajoutant et en connectant des composants sur le canevas de conception. L'exemple suivant inclut trois composants connectés.
Vous pouvez concevoir votre modèle en ajoutant des composants aux points de départ suivants :
- Une toile vierge.
- Un modèle fourni par Google.
- Modèle que vous générez avec l'aide de Gemini.
Pour concevoir votre modèle :
Dans le canevas de conception, assurez-vous que l'onglet Conception est sélectionné.
Pour commencer, effectuez l'une des opérations suivantes :
Pour partir de zéro, dans la zone Composants, cliquez sur un composant pour l'ajouter à la zone du canevas.
Pour commencer à partir d'un modèle fourni par Google, cliquez sur son nom.
Pour utiliser le chat en langage naturel afin de générer un modèle, cliquez sur Application personnalisée avec Gemini.
Pour créer un canal de communication entre les composants, procédez de l'une des manières suivantes :
Pour relier deux composants sur le canevas, faites glisser un point bleu d'un composant vers un point bleu d'un autre composant.
Pour ajouter un composant existant, cliquez sur Ajouter, puis sélectionnez le composant à ajouter.
Pour en savoir plus sur les connexions, consultez la documentation de configuration de chaque ressource compatible.
Pour supprimer un composant ou une connexion :
Dans le canevas, cliquez sur le composant ou la connexion.
Dans la zone Configuration, cliquez sur Supprimer.
Dans le champ, saisissez delete.
Cliquez sur Supprimer.
Configurer les valeurs par défaut des composants
Pour chaque composant que vous ajoutez au canevas, vous pouvez spécifier des détails de configuration tels que le projet dans lequel la ressource est créée et l'emplacement où elle est déployée. Si vous spécifiez des détails de configuration, Application Design Center les utilise comme valeurs par défaut pour les applications.
Vous pouvez également modifier les détails de la connexion si la configuration par défaut ne répond pas à vos besoins. Par exemple, vous pouvez modifier les noms de clés de variable d'environnement, changer les ports de connexion ou ajouter des rôles aux comptes de service.
Avant de déployer une application, les développeurs peuvent afficher et modifier les valeurs par défaut que vous avez configurées dans le modèle. Les développeurs doivent configurer les informations requises pour chaque ressource compatible.
Pour configurer les composants et les connexions, procédez comme suit :
Dans le canevas de conception, cliquez sur un composant.
Dans la zone Configuration, sélectionnez le projet dans lequel vous souhaitez déployer la ressource dans la liste ID du projet. Sélectionnez un projet qui répond aux critères suivants :
Le projet doit être un descendant du dossier compatible avec les applications sélectionné.
Le projet ne doit pas être un projet de gestion.
Configurez des paramètres supplémentaires pour la ressource. Par exemple, pour Cloud SQL, vous pouvez configurer les éléments suivants :
- Région
- Configuration des sauvegardes
- Indicateurs de base de données
- Configuration de l'adresse IP
Pour obtenir des liens vers la documentation de configuration de chaque composant, consultez Ressources compatibles.
Lorsque vous connectez des composants sur le canevas de conception, des valeurs de configuration par défaut sont utilisées pour créer la connexion. Pour ajouter ou modifier les informations de connexion, procédez comme suit.
Dans le canevas de conception, cliquez sur la connexion entre deux composants. Le panneau Connexion s'ouvre et affiche les paramètres de connexion.
Effectuez l'une des opérations suivantes :
Pour modifier un paramètre de connexion existant, cliquez sur Modifier.
Pour ajouter un paramètre de connexion, cliquez sur Ajouter un paramètre.
Mettez à jour les champs Clé et Valeur. Par exemple, vous pouvez modifier les informations suivantes :
- Les noms de clés de variable d'environnement doivent correspondre aux exigences de votre application.
- Valeur du port de connexion.
- Rôles ajoutés à un compte de service.
Cliquez sur Enregistrer.
Modifier le code Terraform
Lorsque vous concevez votre modèle d'application, Application Design Center génère du code Terraform pour refléter les détails de conception et de configuration. Vous pouvez modifier Terraform pour spécifier les détails de configuration des composants.
Le système génère les fichiers Terraform suivants :
main.tf: code d'infrastructure qui inclut un module pour chaque composant du modèle.outputs.tf: expose des informations sur les composants d'infrastructure déployés.variables.tf: déclare le nom, le type et la description des variables utilisées dans le fichiermain.tf.input.tfvars: définit les valeurs des variables utilisées dans le fichiermain.tf.providers.tf: définit les libellés qui aident Terraform à interagir avec les API et les ressources Google Cloud .
Pour en savoir plus, consultez Présentation de Terraform surGoogle Cloud.
Pour modifier le code Terraform :
Dans le canevas de conception, cliquez sur Code. Le système affiche les fichiers Terraform générés.
Cliquez sur main.tf. Le système affiche le module Terraform pour chaque composant.
Modifiez les détails de la configuration. Pour en savoir plus, consultez la documentation de configuration de chaque ressource compatible.
Le système valide automatiquement vos modifications et affiche des erreurs si elles ne sont pas valides.
Pour mettre en surbrillance et comparer vos modifications :
Cliquez sur Afficher les différences.
Pour annuler une modification, cliquez sur Cliquer pour annuler la modification dans la marge.
Cliquez sur Afficher les différences pour fermer la vue de comparaison.
Pour enregistrer vos modifications, cliquez sur Enregistrer les modifications du code.
Pour vérifier vos modifications, procédez comme suit.
- Cliquez sur Conception.
- Cliquez sur un composant et examinez les détails de sa configuration.
Pour supprimer un modèle
Si vous n'avez plus besoin d'un modèle, vous pouvez le supprimer.
- Dans le canevas de conception, cliquez sur Actions.
- Cliquez sur Supprimer.
Valider votre modèle
Avant de partager votre modèle avec des développeurs, assurez-vous qu'il fonctionne comme prévu. Pour valider votre modèle :
- Créez une application avec les paramètres suivants :
- Dans la liste Environnement, sélectionnez TEST.
- Dans la liste Criticité, sélectionnez FAIBLE.
- Déployez l'application. Pour connaître la procédure de déploiement, consultez Déployer une application depuis la console.
- Testez votre infrastructure pour vous assurer qu'elle répond à vos exigences.
- Pour éviter les frais récurrents, supprimez le déploiement de test.
Partager un modèle dans un catalogue
Une fois votre modèle validé, vous pouvez le publier dans un catalogue. Les développeurs d'applications ayant accès à un espace où le catalogue est partagé peuvent utiliser le modèle.
- Dans le canevas de conception, cliquez sur Ajouter au catalogue.
- Pour gérer les espaces dans lesquels le catalogue est partagé, consultez Gérer les catalogues.
Modifier et repartager votre modèle
À mesure que vous gagnez en expérience avec votre application et que vos besoins commerciaux évoluent, vous pouvez mettre à jour le modèle de votre application. Par exemple, vous pouvez décider d'améliorer les performances d'un service de backend en ajoutant un service Memorystore pour la mise en cache.
Lorsque vous modifiez un modèle, vous créez une révision de modèle. Pour appliquer vos modifications aux applications existantes, les développeurs doivent déployer les applications à l'aide de la révision.
App Design Center ne publie pas automatiquement les révisions de modèles dans les catalogues. Pour partager la dernière révision, publiez à nouveau le modèle dans le catalogue.
Pour créer une révision :
Dans le menu de navigation, cliquez sur Modèles.
Sélectionnez le modèle d'application que vous souhaitez réviser. Le canevas s'ouvre.
Modifiez le modèle pour l'adapter à vos nouvelles exigences. Par exemple, ajoutez et configurez un nouveau composant.
Pour partager la dernière révision avec d'autres espaces, ajoutez à nouveau le modèle aux catalogues concernés.
Étapes suivantes
Pour partager des modèles avec d'autres espaces, créez et partagez un catalogue.
Pour utiliser vos propres modules Terraform dans la conception de votre modèle d'application, importez des composants.
Avant de déployer, créez une application.