Concevoir des modèles composites

Aperçu

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Lorsque vous souhaitez créer des applications complexes à partir de blocs de construction plus petits et réutilisables, créez des modèles composites. Par exemple, vous pouvez créer un modèle composite qui inclut plusieurs modèles d'application connectés.

Vous pouvez également créer des modèles composites pour modéliser et regrouper des unités de déploiement pour une offre SaaS que vous déployez avec App Lifecycle Manager. Pour en savoir plus, consultez Unités de déploiement de modèles et de packages.

Concevez des modèles composites en ajoutant et en connectant des modèles d'application standards et des composants individuels. Cette approche modulaire vous aide à :

• Accélérer le développement : assemblez des applications complexes à partir de composants plus petits. Vous pouvez réutiliser chaque modèle d'application standard dans plusieurs modèles composites.
• Activer le développement en parallèle : permet aux équipes modulaires de se spécialiser dans des blocs de construction spécifiques. Par exemple, une équipe de base de données peut gérer le stockage et l'analyse des données en s'appuyant le moins possible sur l'équipe de logique applicative.
• Réduire l'impact des failles : les développeurs peuvent mettre à jour ou corriger un bloc de construction sans redéployer l'intégralité de l'application.
• Améliorez votre stratégie de sécurité : limitez l'accès en créant des comptes de service distincts pour déployer chaque bloc de construction. Assurez-vous que chaque équipe ne dispose d'autorisations que pour les composants qu'elle configure.

Ce document vous explique comment concevoir, valider et partager un modèle composite.

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 App Design Center (roles/designcenter.admin)
• Utilisateur Application Design Center (roles/designcenter.user)

Pour utiliser vos propres modèles d'application standards comme composants de base, définissez des variables d'entrée et de sortie pour établir des variables configurables, puis créez des connexions entre vos modèles d'application. Pour en savoir plus, consultez les ressources suivantes :

• Concevoir des modèles d'application standards
• Partager un modèle dans un catalogue

Créer un modèle d'application composite

Créez des modèles composites lorsque vous souhaitez concevoir et partager des applications complexes. Vous pouvez ajouter et connecter les éléments suivants dans la conception de votre modèle :

• Modèles d'application standards : sélectionnez l'un des modèles existants suivants :

  • Modèles conçus par Google, intégrant les bonnes pratiques Google Cloud et les configurations de sécurité par défaut.
  • Les modèles que vous avez créés précédemment et ajoutés au catalogue de votre espace.

• Composants : sélectionnez parmi les ressources Google Cloud suivantes :

  • 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.

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 de l'utiliser ou non.

Pour saisir les détails de votre modèle :

Canevas de conception

1. Dans le menu de navigation, cliquez sur Modèles.

   Accéder aux modèles

2. Dans la liste Create Template (Créer un modèle), sélectionnez Composite template (Modèle composite).

3. Le champ ID du modèle est automatiquement renseigné. Vous pouvez également saisir un identifiant unique pour le modèle. Ce champ est obligatoire.

4. Dans le champ Nom du modèle, saisissez un identifiant lisible par l'humain à afficher dans la console Google Cloud .

   Si vous ne fournissez pas de nom, l'ID du modèle est copié dans ce champ.

5. Dans le champ Description, saisissez une brève explication de l'objectif de l'application.

6. Cliquez sur Créer un modèle. Le canevas de conception s'affiche.

CLI gcloud

Créez un modèle d'application composite.

gcloud design-center spaces application-templates create APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--display-name=DISPLAY_NAME \
--description=DESCRIPTION \
--composition-type=COMPOSITE

Remplacez les éléments suivants :

• APPLICATION_TEMPLATE : ID du modèle d'application que vous souhaitez créer.
• PROJECT : ID de votre projet.
• LOCATION : région du modèle d'application.
• SPACE : ID de votre espace.
• DISPLAY_NAME : nom à afficher dans la console Google Cloud .
• DESCRIPTION : brève description.

Pour en savoir plus, consultez gcloud design-center spaces application-templates create.

Concevoir votre modèle

Concevez votre modèle composite en ajoutant et en connectant des modèles et des composants d'application standards 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.

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.

Pour concevoir votre modèle :

Canevas de conception

1. Dans le canevas de conception, sélectionnez Conception pour afficher le canevas.

2. Pour commencer, effectuez l'une des opérations suivantes :

   • Pour commencer à partir d'un modèle fourni par Google, cliquez sur le nom du modèle dans la zone Premiers pas du canevas.

   • Pour commencer à partir d'une page vierge, passez à l'étape suivante.

3. Pour ajouter un modèle d'application standard au canevas :

   1. Dans la zone Composants, cliquez sur Intégrer des modèles.

   2. Pour ajouter un modèle existant, cliquez sur un modèle dans l'une des listes suivantes :

      • Modèles : modèles d'applications standards qui se trouvent dans le catalogue de votre espace ou qui ont été partagés avec votre espace.
      • Modèles Google : modèles d'application standards créés par Google et ajoutés au catalogue Google.

   3. Pour ajouter le modèle sélectionné au canevas, cliquez sur Sélectionner.

4. Pour créer un modèle d'application standard, cliquez sur Créer un modèle. La page Créer un modèle s'ouvre.

   Pour en savoir plus, consultez Concevoir des modèles d'application standards.

5. Pour ajouter un composant au canevas, cliquez dessus dans la zone Composants.

6. Pour créer un canal de communication entre les modèles et les composants, procédez de l'une des manières suivantes :

   • Faites glisser un point bleu d'un composant de base vers un point bleu d'un autre composant de base.

   • Pour ajouter un composant connecté à 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.

7. Pour supprimer un composant de base ou une connexion :

   1. Dans le canevas, cliquez sur le bloc de construction ou la connexion.

   2. Dans la zone Configuration, cliquez sur Supprimer.

   3. Dans le champ, saisissez delete.

   4. Cliquez sur Supprimer.

CLI gcloud

1. Identifiez les URI de révision des modèles pour les composants de base du catalogue de votre espace.

   gcloud design-center spaces shared-templates list \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

   Remplacez les éléments suivants :

   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.

   Pour en savoir plus, consultez gcloud design-center spaces shared-templates list.

2. Identifiez les URI de révision des composants principaux de création de catalogue Google que vous souhaitez ajouter au modèle.

   gcloud design-center spaces shared-templates list \
   --google-catalog \
   --location=us-central1
   

   Pour en savoir plus, consultez gcloud design-center spaces shared-templates list.

3. Ajoutez un modèle ou un composant d'application standard à votre modèle composite.

   gcloud design-center spaces application-templates components create COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --shared-template-revision-uri=SHARED_TEMPLATE_URI
   

   Remplacez les éléments suivants :

   • COMPONENT : ID du modèle ou du composant d'application standard que vous souhaitez ajouter au modèle.
   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.
   • APPLICATION_TEMPLATE : ID du modèle d'application composite auquel vous ajoutez le modèle d'application ou le composant standard.
   • SHARED_TEMPLATE_URI : URI du modèle d'application standard ou du modèle partagé de composant. Exemple :projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1

   Pour en savoir plus, consultez gcloud design-center spaces application-templates components create.

4. Ajoutez un deuxième modèle ou composant d'application standard à votre modèle.

   gcloud design-center spaces application-templates components create COMPONENT_2 \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --shared-template-revision-uri=SHARED_TEMPLATE_URI_2
   

   Remplacez les éléments suivants :

   • COMPONENT_2 : ID du deuxième modèle ou composant d'application standard que vous souhaitez ajouter au modèle.
   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.
   • APPLICATION_TEMPLATE : ID du modèle composite auquel vous ajoutez le modèle ou le composant d'application standard.
   • SHARED_TEMPLATE_URI_2 : URI du deuxième modèle ou composant de modèle d'application standard partagé. Exemple :projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1

   Pour en savoir plus, consultez gcloud design-center spaces application-templates components create.

5. Créez une connexion entre les modèles ou les composants d'application standards.

   gcloud design-center spaces application-templates components connections create CONNECTION \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --component=COMPONENT \
   --destination-component-uri=COMPONENT_2
   

   Remplacez les éléments suivants :

   • CONNECTION : ID de la connexion que vous souhaitez ajouter au modèle.
   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.
   • APPLICATION_TEMPLATE : ID du modèle pour le modèle d'application auquel vous ajoutez la connexion.
   • COMPONENT : ID du modèle ou du composant d'application standard source.
   • COMPONENT_2 : ID du modèle ou du composant d'application standard de destination.

   Pour en savoir plus, consultez gcloud design-center spaces application-templates components connections create.

Configurer des valeurs par défaut pour les composants

Pour chaque composant que vous ajoutez à un modèle, vous pouvez spécifier des détails de configuration par défaut, tels que le projet et l'emplacement de déploiement de la ressource. App Design Center applique ces valeurs par défaut lorsqu'une application est créée à partir de ce modèle.

Les développeurs d'applications peuvent également modifier les informations de connexion si la configuration par défaut ne répond pas à leurs exigences. Par exemple, vous pouvez modifier les noms de clés des variable d'environnement, changer les ports de connexion ou ajouter des rôles aux comptes de service lorsque vous créez une application.

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 :

Canevas de conception

1. Dans le canevas de conception, cliquez sur un composant.

2. 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.

3. 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.

4. 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.

   1. Dans le canevas de conception, cliquez sur la connexion entre deux composants. Le panneau Connexion s'ouvre et affiche les paramètres de connexion.

   2. 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.

   3. 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.

5. Cliquez sur Enregistrer.

CLI gcloud

1. Décrivez chaque composant du modèle d'application pour afficher les paramètres des composants.

   gcloud design-center spaces application-templates components describe COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE
   

   Remplacez les éléments suivants :

   • COMPONENT : ID du composant que vous souhaitez décrire.
   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.
   • APPLICATION_TEMPLATE : ID du modèle d'application.

   Pour en savoir plus, consultez gcloud design-center spaces application-templates components describe.

2. Pour chaque composant que vous souhaitez modifier, créez un fichier JSON dans votre répertoire personnel contenant les valeurs des paramètres.

   Par exemple, vous pouvez créer le fichier suivant pour un composant Cloud Run :

     [
         {
           "key": "service_name",
           "value": "frontend-service"
         },
         {
           "key": "project_id",
           "value": "DEPLOYMENT_PROJECT"
         }
     ]
   

3. Mettez à jour chaque composant du modèle d'application pour configurer les paramètres requis.

   gcloud design-center spaces application-templates components update COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --parameters=PARAMETERS_FILE_PATH \
   --application-template=APPLICATION_TEMPLATE
   

   Remplacez les éléments suivants :

   • COMPONENT : ID du composant que vous souhaitez mettre à jour.
   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.
   • PARAMETERS_FILE_PATH : fichier JSON qui inclut les paramètres des composants.
   • APPLICATION_TEMPLATE : ID du modèle d'application.

   Pour en savoir plus, consultez gcloud design-center spaces application-templates components update.

4. Décrivez les connexions des composants.

   gcloud design-center spaces application-templates components connections describe CONNECTION \
   --component=COMPONENT \
   --application-template=APPLICATION_TEMPLATE \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

   Remplacez les éléments suivants :

   • CONNECTION : ID de connexion
   • COMPONENT : ID du composant.
   • APPLICATION_TEMPLATE : ID du modèle.
   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.

   Pour en savoir plus, consultez gcloud design-center spaces application-templates components connections describe.

5. Modifiez les paramètres de connexion des composants.

   gcloud design-center spaces application-templates components connections update CONNECTION \
   --component=COMPONENT \
   --application-template=APPLICATION_TEMPLATE \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --source-component-parameters='[{"key": SOURCE_KEY, "value": SOURCE_VALUE}]'
   

   Remplacez les éléments suivants :

   • CONNECTION : ID de connexion
   • COMPONENT : ID du composant.
   • APPLICATION_TEMPLATE : ID du modèle.
   • PROJECT : ID de votre projet.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.
   • SOURCE_KEY : nouvelle clé de paramètre.
   • SOURCE_VALUE : nouvelle valeur de paramètre.

   Pour en savoir plus, consultez gcloud design-center spaces application-templates components connections update.

Configurer des modèles d'application standards

Lorsque les développeurs déploient votre modèle composite en tant qu'application, une application est créée pour chacun des éléments suivants :

• Chaque groupe de modèles d'application standards.
• Chaque groupe de composants.

Vous pouvez fournir des valeurs par défaut pour chaque groupe. Par exemple, vous pouvez inclure le projet de déploiement, la région et les propriétaires. Lorsque les développeurs déploient l'application dans App Design Center, ils peuvent utiliser les valeurs par défaut ou spécifier leurs propres informations pour chaque application.

Pour fournir des informations par défaut sur les applications pour chaque groupe, procédez comme suit :

Canevas de conception

1. Dans le canevas de conception, cliquez sur un modèle d'application standard.

   Le panneau Modèle intégré s'ouvre.

2. Dans la section Configuration, saisissez les informations sur l'application.

   Pour en savoir plus, consultez Créer un brouillon de demande.

CLI gcloud

Pour en savoir plus, consultez Concevoir votre modèle.

Valider votre modèle

Avant de partager votre modèle composite avec les développeurs, déployez-le et vérifiez-le dans App Design Center. Cette étape vous aide à vérifier la fonctionnalité avant un déploiement à grande échelle sur plusieurs machines.

Pour valider votre modèle :

1. Dans le canevas de conception, cliquez sur Continuer, puis sélectionnez Créer une application à déployer.

   Le panneau Créer une application s'ouvre.

2. Dans la zone Détails de l'application composite, saisissez les détails de l'application.

   Pour en savoir plus, consultez Créer un brouillon de demande.

3. Cliquez sur Suivant.

4. Pour chaque composant de base que vous avez ajouté au modèle composite, une application sera créée lors du déploiement. Configurez chaque application, puis cliquez sur Next (Suivant).

   Pour en savoir plus, consultez Créer un brouillon de demande.

5. Testez votre application déployée pour vous assurer qu'elle répond à vos exigences.

6. Pour éviter les frais récurrents, supprimez le déploiement de test.

Créer un déploiement à grande échelle

Pour déployer et gérer plusieurs instances de votre modèle composite, utilisez App Lifecycle Manager.

1. Validez votre modèle dans App Design Center.

2. Dans le canevas de conception, cliquez sur Continuer, puis sélectionnez Déployer à grande échelle avec App Lifecycle Manager.

   La page Unités App Lifecycle Manager s'ouvre.

3. Pour connaître la procédure de déploiement, consultez Déployer une offre SaaS.

Partager votre modèle

Pour mettre votre modèle à la disposition des développeurs, vous pouvez l'ajouter à un catalogue et le partager. Lorsque vous ajoutez un modèle à un catalogue, il est disponible en tant que source d'application dans les espaces où le catalogue est partagé.

Pour partager le modèle, procédez comme suit :

1. Dans le canevas de conception, cliquez sur Ajouter au catalogue.

2. 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 votre modèle. 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 :

1. Dans le menu de navigation, cliquez sur Modèles.

   Accéder aux modèles

2. Sélectionnez le modèle d'application que vous souhaitez réviser. Le canevas s'ouvre.

3. Modifiez le modèle pour l'adapter à vos nouvelles exigences. Par exemple, ajoutez et configurez un nouveau composant.

4. Pour partager la dernière révision avec d'autres espaces, ajoutez à nouveau le modèle à votre catalogue.

Pour supprimer un modèle

Si vous n'avez plus besoin d'un modèle, vous pouvez le supprimer.

Canevas de conception

1. Dans le canevas de conception, cliquez sur Actions.
2. Cliquez sur Supprimer.

CLI gcloud

Supprimez un modèle d'application.

```sh
gcloud design-center spaces application-templates delete APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
```

Remplacez les éléments suivants :

• APPLICATION_TEMPLATE : ID du modèle d'application que vous souhaitez supprimer.
• PROJECT : ID de votre projet.
• LOCATION : région du modèle d'application.
• SPACE : ID de votre espace.

Pour en savoir plus, consultez gcloud design-center spaces application-templates delete.

Étapes suivantes

• Pour déployer votre modèle composite avec App Lifecycle Manager, consultez Déployer une offre SaaS.

• 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.