Créer un brouillon d'application à partir d'un modèle dans App Design Center vous permet de personnaliser et de déployer des instances d'application distinctes pour des environnements tels que les tests et la production. Lorsque vous créez un brouillon d'application, vous spécifiez des attributs pour catégoriser et filtrer l'application, configurer les composants et les connexions, et éventuellement modifier le code Terraform généré. Vous pouvez également créer des révisions à mesure que vos besoins évoluent et supprimer l'application lorsque vous n'avez plus besoin des ressources déployées.
Avant de commencer
Pour effectuer les tâches décrites dans ce document, demandez à votre administrateur de vous accorder les rôles nécessaires sur le dossier compatible avec les applications ou le projet de gestion, comme indiqué dans le tableau suivant :
| Tâche | Rôles requis |
|---|---|
| Créer, configurer, modifier et versionner des brouillons d'application | Administrateur Application Design Center (roles/designcenter.admin), ouAdministrateur d'application ( roles/designcenter.applicationAdmin), ouÉditeur d'application ( roles/designcenter.applicationEditor) |
| Supprimer une application | Administrateur Application Design Center (roles/designcenter.admin) ouAdministrateur d'application ( roles/designcenter.applicationAdmin) |
Pour en savoir plus sur les rôles, consultez Contrôle des accès avec IAM.
Créer un brouillon d'application
Créez un brouillon d'application à partir d'un modèle en spécifiant des détails et, éventuellement, en remplaçant les configurations des composants. Vous pouvez ensuite déployer le brouillon pour créer une application.
Canevas de conception
Dans le menu de navigation, effectuez l'une des opérations suivantes :
Pour afficher les modèles créés dans votre espace, cliquez sur Modèles.
Pour afficher les modèles partagés depuis un autre espace, cliquez sur Modèles partagés.
Cliquez sur l'ID de modèle que vous souhaitez utiliser.
Dans le canevas de conception, cliquez sur Configurer une application, puis sur Créer une application.
Dans la section Nom de l'application, procédez comme suit pour nommer et décrire votre application :
Dans le champ Nom, saisissez un identifiant unique. Par exemple, utilisez une combinaison unique de nom et d'environnement, telle que
web-app-staging. Ce champ est obligatoire.Vous pouvez utiliser jusqu'à 63 caractères, y compris des lettres minuscules, des chiffres et des traits d'union. Le nom doit commencer par une lettre minuscule et ne peut pas se terminer par un trait d'union. Les noms ne peuvent pas être modifiés.
Dans le champ Nom à afficher, saisissez un nom à afficher dans la consoleGoogle Cloud .
Dans le champ Description, saisissez l'objectif de cette application.
Pour définir un projet par défaut pour tous les composants dont le champ ID du projet est vide, sélectionnez un projet dans la liste Projet de déploiement. Dans une limite au niveau du dossier, le projet doit remplir les conditions suivantes :
- Le projet doit se trouver dans le dossier compatible avec les applications sélectionné.
- Le projet ne doit pas être un projet de gestion.
Si un projet est déjà spécifié dans le champ ID du projet d'un composant, ce projet est utilisé à la place de ce paramètre.
Dans la liste Région, sélectionnez la région dans laquelle les composants sont déployés. La région du composant est appliquée en fonction des éléments suivants :
Si le champ d'application est Global (par défaut), la région est appliquée aux composants qui n'ont pas encore de région configurée.
Si le champ d'application est Régional, la région est appliquée à tous les composants.
Dans la liste Environnement, sélectionnez l'environnement dans lequel vous souhaitez déployer cette application. Par exemple, vous pouvez vérifier que votre déploiement fonctionne comme prévu dans
TEST.Dans la liste Criticité, sélectionnez le degré d'impact sur votre activité. Par exemple,
LOWouHIGH.Pour spécifier des propriétaires, dans la zone Propriétaires, cliquez sur Ajouter un propriétaire, puis saisissez un nom à afficher et une adresse e-mail pour les éléments suivants :
Dans la zone Propriétaires de l'entreprise, saisissez un propriétaire responsable de la qualité et des attentes des utilisateurs.
Dans la zone Propriétaires développeurs, saisissez un propriétaire responsable du développement et du codage.
Dans la zone Propriétaires de l'opérateur, saisissez un propriétaire responsable de l'exploitation de l'application.
Dans la liste Champ d'application, sélectionnez l'une des options suivantes :
Global (par défaut) : l'application contient une ressource globale ou les ressources se trouvent dans plusieurs régions.
Régional : toutes les ressources se trouvent dans une seule région.
Ce champ est obligatoire. Pour en savoir plus, consultez Comparer les applications globales et régionales.
Cliquez sur Créer une application. Les détails de l'application s'affichent.
gcloud CLI
Identifiez l'URI de révision du modèle d'application que vous souhaitez utiliser pour créer l'application.
gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --format='yaml(name,latestRevision)'Remplacez les éléments suivants :
APPLICATION_TEMPLATE: ID du modèle d'application que vous souhaitez utiliser comme base pour votre application.PROJECT: ID de votre projet de gestion.LOCATION: région du modèle d'application.SPACE: ID de votre espace.
Pour en savoir plus, consultez gcloud design-center spaces application-templates describe.
Copiez le résultat de
latestRevision.Créez un brouillon d'application basé sur votre modèle.
gcloud design-center spaces applications create APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION \ --scope-type=SCOPE_TYPERemplacez les éléments suivants :
APPLICATION: ID d'application du brouillon d'application que vous souhaitez créer.PROJECT: ID de votre projet de gestion.LOCATION: région de l'application.SPACE: ID de votre espace.SOURCE_APPLICATION_TEMPLATE_REVISION: URI de votre modèle d'application. Par exemple,projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION.SCOPE_TYPE: champ d'application de votre application.regionalouglobal. Si le champ d'application est "global, the region is applied to components that don't already have a configured region. If the application scope isregional", la région est appliquée à tous les composants.
Pour en savoir plus, consultez gcloud design-center spaces applications create.
Configurer les composants et les connexions
Pour chaque composant de l'application, 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.
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 des clés de variable d'environnement, changer les ports de connexion ou ajouter des rôles supplémentaires aux comptes de service.
Vous devez configurer les informations requises pour chaque ressource compatible.
Pour configurer les composants et les connexions, procédez comme suit :
Canevas de conception
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 répondant aux critères suivants :
Le projet doit se trouver dans le 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 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, les valeurs de configuration par défaut sont utilisées pour créer la connexion. Pour ajouter ou modifier les détails de la 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 détails suivants :
- Les noms des clés des variable d'environnement pour répondre aux exigences de votre application.
- Valeur du port de connexion.
- Rôles ajoutés à un compte de service.
Cliquez sur Enregistrer.
gcloud CLI
Décrivez l'application pour afficher les paramètres des composants et identifier les paramètres requis pour votre application.
gcloud design-center spaces applications describe APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --format='yaml(name,componentParameters)'Remplacez les éléments suivants :
APPLICATION: ID d'application.PROJECT: ID de votre projet de gestion.LOCATION: région de l'application.SPACE: ID de votre espace.
Pour en savoir plus, consultez gcloud design-center spaces applications describe.
Pour chaque composant que vous souhaitez modifier, créez un fichier JSON contenant les valeurs des paramètres dans votre répertoire d'accueil.
Par exemple, vous pouvez créer le fichier suivant pour un composant Cloud Run :
{ "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT", "parameters": [ { "key": "service_name", "value": "frontend-service" }, { "key": "project_id", "value": "DEPLOYMENT_PROJECT" } ] }Mettez à jour l'application pour configurer les paramètres requis.
gcloud design-center spaces applications update APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --component-parameters=COMPONENT_FILE_PATH_1Remplacez les éléments suivants :
APPLICATION: ID d'application.PROJECT: ID de votre projet de gestion.LOCATION: région de l'application.SPACE: ID de votre espace.COMPONENT_FILE_PATH_1: fichier JSON incluant les paramètres du composant. Pour chaque fichier JSON supplémentaire, ajoutez un autre argument--component-parameteret une autre valeur.
Pour en savoir plus, consultez gcloud design-center spaces applications update.
Pour connaître la procédure de déploiement, consultez Déployer des applications.
Vérifier la conformité de la sécurité
Vous pouvez effectuer une évaluation de la sécurité de votre application pour valider votre configuration par rapport aux frameworks Security Command Center. Cette évaluation complète porte sur les points suivants :
- Valeurs de configuration des composants : paramètres de configuration hérités automatiquement du modèle ou paramètres que vous avez modifiés pour cette application.
- Paramètres de l'application : détails spécifiques à l'instance fournis pour votre application, tels que la région ou l'environnement de déploiement.
- Composants autorisés : services et charges de travail de l'application actuelle que votre organisation est autorisée à utiliser.
Les applications héritent des frameworks Security Command Center de leur modèle. Tout d'abord, votre administrateur doit associer un framework de sécurité à votre modèle d'application. Ensuite, procédez comme suit pour évaluer la conformité de la sécurité de votre application :
gcloud CLI
gcloud alpha design-center spaces applications preview APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--generate-assessment-report=true
Remplacez les éléments suivants :
APPLICATION: ID application de l'application que vous souhaitez évaluer.PROJECT: ID de votre projet de gestion.LOCATION: région de l'application.SPACE: ID de votre espace.
La sortie affiche un rapport d'évaluation pour votre application en fonction des frameworks associés au modèle.
Modifier le code Terraform
Votre application génère du code Terraform pour refléter les détails de conception et de configuration. Vous pouvez modifier le fichier 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 incluant 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, procédez comme suit :
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 évidence et comparer vos modifications, procédez comme suit :
Cliquez sur Afficher les différences.
Pour annuler une modification, cliquez sur Cliquez 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 Design.
- Cliquez sur un composant et examinez les détails de sa configuration.
Créer une révision d'application
Créez une révision d'application pour modifier des détails ou des composants. Si vous modifiez des composants d'application en dehors d'App Design Center, ces modifications ne sont pas conservées lors du redéploiement.
Pour créer une révision d'application :
Canevas de conception
Dans le menu de navigation, cliquez sur Applications.
Dans le tableau, cliquez sur le nom de l'application que vous souhaitez modifier.
Pour modifier les détails de l'application, procédez comme suit :
Cliquez sur Modifier et modifiez les détails.
Cliquez sur Enregistrer pour enregistrer les modifications.
Pour modifier un composant dans cette application, procédez comme suit :
Cliquez sur le composant dans le canevas de conception, puis modifiez les détails dans la zone Configuration.
Cliquez sur Enregistrer pour enregistrer les modifications.
gcloud CLI
Consultez Configurer les composants et les connexions.
Pour connaître la procédure de déploiement, consultez Déployer des applications.
Supprimer une application
Si vous n'avez plus besoin d'une application, vous pouvez la supprimer. Par exemple, vous pouvez déployer une application pour vérifier votre modèle dans l'environnement TEST, puis supprimer l'application.
Vous pouvez supprimer les applications suivantes :
- Une application qui n'a pas été déployée. Sur la page Applications, l'état est indiqué comme Brouillon.
- Une application déployée dans l'environnement
TEST,DEVELOPMENTouSTAGING.
Lorsque vous supprimez une application, les événements suivants se produisent :
- Les informations sur l'application sont supprimées d'App Design Center.
- Application App Hub sous-jacente
- Si vous avez déployé des ressources, elles sont supprimées.
Pour supprimer une application :
Canevas de conception
Dans le menu de navigation, cliquez sur Applications.
Dans le tableau, cliquez sur le nom de l'application.
Cliquez sur Actions, puis sélectionnez Supprimer l'application.
Dans le champ Supprimer, saisissez le nom de l'application.
Cliquez sur Supprimer.
gcloud CLI
Supprimer une application.
gcloud design-center spaces applications delete APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
Remplacez les éléments suivants :
APPLICATION: ID de l'application que vous souhaitez supprimer.PROJECT: ID de votre projet de gestion.LOCATION: région de l'application.SPACE: ID de votre espace.Pour en savoir plus, consultez gcloud design-center spaces applications delete.
Étapes suivantes
- Provisionnez votre infrastructure avec la console ou la ligne de commande en déployant des applications.
- Exportez des configurations Terraform vers votre machine ou votre dépôt local en téléchargeant et en déployant Terraform.