Gérer, publier et partager des catalogues

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 :

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

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder à la page Catalogues

  2. Cliquez sur Ajouter des modèles.

  3. Dans la zone Ajouter des modèles au catalogue par défaut, procédez comme suit :

    1. Pour trouver un modèle spécifique, saisissez son nom dans le champ Filtre.
    2. Pour ajouter un modèle à ce catalogue, cliquez sur Ajouter au catalogue dans la colonne Actions.
  4. Cliquez sur OK. Les espaces qui ont accès au catalogue ont accès aux modèles sélectionnés.

  5. Pour partager le catalogue, consultez Partager un catalogue avec un espace.

gcloud CLI

  1. Identifiez l'ID du catalogue auquel vous souhaitez ajouter votre modèle.

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

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

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

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

  3. Validez le modèle d'application.

     gcloud design-center spaces application-templates commit TEMPLATE \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE
    

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

  4. Copiez la sortie name de la commande de commit. Vous spécifierez ce nom comme valeur application-template-revision-source lorsque vous créerez la révision de votre modèle de catalogue.

  5. 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=SPACE
    

    Remplacez les éléments suivants :

    • CATALOG : ID de votre catalogue. Exemple :default-catalog
    • 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 list.

  6. 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_CATEGORY
    

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

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

    Remplacez les éléments suivants :

    • REVISION : ID de la révision que vous souhaitez créer. Exemple :r1
    • PROJECT : 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

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder à la page Catalogues

  2. Pour gérer les modèles de ce catalogue, cliquez sur Modèles du catalogue.

  3. Pour supprimer un modèle, cliquez sur  Actions, puis sélectionnez Supprimer du catalogue.

    1. Dans le champ, saisissez le nom du modèle.
    2. 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

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder à la page Catalogues

  2. Cliquez sur Partager le catalogue.

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

  5. 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 exemple projects/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

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder à la page Catalogues

  2. Cliquez sur Espaces partagés avec.

  3. Pour arrêter de partager ce catalogue avec un espace, cliquez sur  Actions, puis sélectionnez Arrêter le partage.

    1. Dans le champ, saisissez le nom de l'espace.
    2. 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

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder à la page Catalogues

  2. Examinez les détails du catalogue.

  3. Pour modifier le nom à afficher, procédez comme suit :

    1. Cliquez sur Modifier le nom à afficher.
    2. Dans le champ Nom à afficher, saisissez le nouveau nom.
    3. Cliquez sur Enregistrer.
  4. Pour modifier la Description, procédez comme suit :

    1. Cliquez sur Modifier la description.
    2. Dans le champ Description, saisissez la nouvelle description.
    3. 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