Les catalogues d'Application Design Center vous permettent de publier et de partager des modèles d'application et des modèles de composants importés dans différents espaces afin de standardiser les architectures et d'éviter de dupliquer les efforts entre les équipes. Lorsque vous créez ou importez des modèles dans un espace, ils ne sont disponibles que pour les membres de cet espace par défaut. Vous pouvez partager un catalogue entre plusieurs espaces lorsqu'une équipe de plate-forme centrale gère des modèles approuvés et conformes aux règles que les équipes de développement d'autres dossiers ou projets doivent déployer. Chaque espace inclut un seul catalogue dans lequel vous pouvez publier des modèles, modifier les métadonnées du catalogue et partager le catalogue avec des espaces d'autres périmètres de gestion des applications.
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 |
|---|---|
| Publier des modèles d'application dans un catalogue d'espace | Administrateur Application Design Center (roles/designcenter.admin) |
| Partager un catalogue avec des espaces de destination | Administrateur Application Design Center (roles/designcenter.admin) |
Pour en savoir plus sur les rôles, consultez Contrôle des accès avec IAM.
Avant de gérer des catalogues, procédez comme suit :
- Effectuez la configuration initiale d'App Design Center.
- Pour créer des espaces en plus de votre espace initial, consultez Gérer les espaces.
Publier un modèle d'application dans un catalogue
Avant de pouvoir partager un modèle avec d'autres espaces, publiez-le dans votre catalogue.
Canevas de conception
Dans le menu de navigation, cliquez sur Catalogues.
Cliquez sur Ajouter des modèles.
Dans la zone Ajouter des modèles au catalogue par défaut, procédez comme suit :
- Pour trouver un modèle spécifique, saisissez son nom dans le champ Filtre.
- Pour ajouter un modèle à ce catalogue, cliquez sur Ajouter au catalogue dans la colonne Actions.
Cliquez sur OK. Les espaces qui ont accès au catalogue ont accès aux modèles sélectionnés.
Pour partager le catalogue, consultez Partager un catalogue avec un espace.
gcloud CLI
Identifiez l'ID du catalogue auquel vous souhaitez ajouter votre modèle.
gcloud design-center spaces catalogs list \ --project=PROJECT \ --location=LOCATION \ --space=SPACERemplacez les éléments suivants :
PROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.
Pour en savoir plus, consultez gcloud design-center spaces catalogs list.
Identifiez l'ID du modèle que vous souhaitez ajouter à votre catalogue. Par exemple, la commande suivante liste les modèles d'application.
gcloud design-center spaces application-templates list \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --filter=FILTERRemplacez les éléments suivants :
PROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.FILTER: filtre permettant d'affiner les résultats de recherche. Par exemple,"displayName:my-app-template*".
Pour en savoir plus, consultez gcloud design-center spaces application-templates list.
Validez le modèle d'application.
gcloud design-center spaces application-templates commit TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACERemplacez les éléments suivants :
TEMPLATE: ID du modèle à valider.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 commit.
Copiez la sortie
namede la commande de commit. Vous spécifierez ce nom comme valeurapplication-template-revision-sourcelorsque vous créerez la révision de votre modèle de catalogue.Assurez-vous que le modèle d'application ne figure pas déjà dans le catalogue.
gcloud design-center spaces catalogs templates list \ --catalog=CATALOG \ --project=PROJECT \ --location=LOCATION \ --space=SPACERemplacez les éléments suivants :
CATALOG: ID de votre catalogue. Exemple :default-catalogPROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.
Pour en savoir plus, consultez gcloud design-center spaces catalogs templates list.
Si le modèle d'application ne figure pas dans le catalogue, créez le modèle de catalogue.
gcloud design-center spaces catalogs templates create CATALOG_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --catalog=CATALOG \ --template-category=TEMPLATE_CATEGORYRemplacez les éléments suivants :
CATALOG_TEMPLATE: ID du modèle de catalogue que vous souhaitez créer.PROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.CATALOG: ID de votre catalogue.TEMPLATE_CATEGORY: catégorie du modèle. Exemple :application-template
Pour en savoir plus, consultez gcloud design-center spaces catalogs templates create.
Créez une révision de modèle de catalogue. Cela crée la première révision, que les développeurs utilisent comme source pour une application.
gcloud design-center spaces catalogs templates revisions create REVISION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --catalog=CATALOG \ --template=CATALOG_TEMPLATE \ --application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCERemplacez les éléments suivants :
REVISION: ID de la révision que vous souhaitez créer. Exemple :r1PROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.CATALOG: ID de votre catalogue.CATALOG_TEMPLATE: ID du modèle.APPLICATION_TEMPLATE_REVISION_SOURCE: source de la révision du modèle d'application. Vous avez copié cette valeur lorsque vous avez validé votre modèle d'application. Exemple :projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1
Pour en savoir plus, consultez gcloud design-center spaces catalogs templates revisions create.
Partager des modèles révisés
Si vous apportez des modifications à un modèle, elles ne sont pas automatiquement publiées dans le catalogue. Pour partager la dernière révision, publiez à nouveau le modèle dans le catalogue.
Supprimer des modèles d'un catalogue
Si vous ne souhaitez plus partager un modèle spécifique avec un espace, supprimez-le du catalogue.
Canevas de conception
Dans le menu de navigation, cliquez sur Catalogues.
Pour gérer les modèles de ce catalogue, cliquez sur Modèles du catalogue.
Pour supprimer un modèle, cliquez sur Actions, puis sélectionnez Supprimer du catalogue.
- Dans le champ, saisissez le nom du modèle.
- Cliquez sur Supprimer.
gcloud CLI
Supprimez un modèle de votre catalogue.
gcloud design-center spaces catalogs templates delete CATALOG_TEMPLATE \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--force
Remplacez les éléments suivants :
CATALOG_TEMPLATE: ID du modèle de catalogue que vous souhaitez supprimer du catalogue.CATALOG: ID de votre catalogue.PROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.
Pour en savoir plus, consultez gcloud design-center spaces catalogs templates delete.
Partager un catalogue avec un espace
Vous ne pouvez partager un catalogue qu'avec un espace de destination situé dans la même région que l'espace source, mais dans un périmètre de gestion des applications différent.
Pour partager votre catalogue avec un espace, procédez comme suit :
Canevas de conception
Dans le menu de navigation, cliquez sur Catalogues.
Cliquez sur Partager le catalogue.
Dans le champ Partager avec, indiquez si l'espace de destination se trouve dans l'un des éléments suivants :
- Dossier : périmètre de gestion des applications au niveau du dossier.
- Projet : limite de gestion des applications au niveau du projet.
Dans le champ ID du projet/dossier, saisissez l'ID du projet ou du dossier pour le périmètre de gestion des applications où se trouve l'espace de destination.
L'espace situé dans la même région que votre espace d'origine est automatiquement renseigné dans le champ Nom de l'espace.
Cliquez sur Partager.
Les développeurs peuvent afficher les modèles d'un catalogue partagé en ouvrant leur espace dans App Design Center et en cliquant sur Modèles partagés dans le menu de navigation.
gcloud CLI
Partager un catalogue avec un espace.
gcloud design-center spaces catalogs shares create SHARE \
--project=PROJECT \
--space=SPACE \
--location=LOCATION \
--catalog=CATALOG \
--destination-space=DESTINATION_SPACE
Remplacez les éléments suivants :
SHARE: ID du partage que vous souhaitez créer.PROJECT: ID de votre projet de gestion.SPACE: ID de votre espace.LOCATION: région du catalogue.CATALOG: ID du catalogue que vous partagez.DESTINATION_SPACE: nom complet de l'espace de destination, par exempleprojects/my-dest-project/locations/us-central1/spaces/my-dest-space.
Pour en savoir plus, consultez gcloud design-center spaces catalogs shares create.
Arrêter de partager un catalogue avec un espace
Si vous ne souhaitez plus partager un catalogue avec un espace, arrêtez le partage du catalogue en procédant comme suit :
Canevas de conception
Dans le menu de navigation, cliquez sur Catalogues.
Cliquez sur Espaces partagés avec.
Pour arrêter de partager ce catalogue avec un espace, cliquez sur Actions, puis sélectionnez Arrêter le partage.
- Dans le champ, saisissez le nom de l'espace.
- Cliquez sur Arrêter le partage.
gcloud CLI
Arrêter de partager un catalogue avec un espace.
gcloud design-center spaces catalogs shares delete SHARE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG
Remplacez les éléments suivants :
SHARE: ID du partage que vous souhaitez supprimer.PROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.CATALOG: ID du catalogue que vous partagez.
Pour en savoir plus, consultez gcloud design-center spaces catalogs shares delete.
Modifier les métadonnées du catalogue
Pour gérer votre catalogue, vous pouvez lui attribuer un nom et une description descriptifs en procédant comme suit :
Canevas de conception
Dans le menu de navigation, cliquez sur Catalogues.
Examinez les détails du catalogue.
Pour modifier le nom à afficher, procédez comme suit :
- Cliquez sur Modifier le nom à afficher.
- Dans le champ Nom à afficher, saisissez le nouveau nom.
- Cliquez sur Enregistrer.
Pour modifier la Description, procédez comme suit :
- Cliquez sur Modifier la description.
- Dans le champ Description, saisissez la nouvelle description.
- Cliquez sur Enregistrer.
gcloud CLI
gcloud design-center spaces catalogs update CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--description=DESCRIPTION \
--display-name=DISPLAY_NAME
Remplacez les éléments suivants :
CATALOG: ID de votre catalogue.PROJECT: ID de votre projet de gestion.LOCATION: région du catalogue.SPACE: ID de votre espace.DESCRIPTION: description du catalogue.DISPLAY_NAME: nom à afficher du catalogue.
Pour en savoir plus, consultez gcloud design-center spaces catalogs update.
Étapes suivantes
- Définissez vos propres configurations en concevant des modèles d'application.
- Découvrez comment mettre à jour, faire évoluer et supprimer vos ressources en gérant les applications.
- Utilisez vos propres modules Terraform dans vos conceptions de modèles en important des composants.